Cancel an offer
post
/forwards/offers/{boxId}/cancelapi_keyReturn one of this wallet's offers, its LIT and ERG, to its maker address. A fill sent before the cancel can still confirm first, and the cancel is then dropped. No body.
Path parameters
boxIdstringrequiredOffer box id, as listed by
GET /forwards/offersorGET /forwards/positions.
Responses
200Result of the cancel transactionDFCancelResult▶
txIdstringrequiredoutcomestringrequiredone ofacceptedrejecteduncertainreturnedLitstringrequiredreturnedNanoErgsstringrequirednetworkFeestringrequired
403Missing or wrong api_keyApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
404No unspent offer made by this wallet has that id.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
409An unconfirmed transaction already spends the offer.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
422Neither the offer nor the wallet can cover the network fee.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
503Node, wallet or transaction engine unavailable, or the request ran out of time. The message says whether anything was sent. When it says the outcome is unknown, check this wallet's offers and positions before retrying.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
defaultErrorApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description