Fill an offer
/forwards/offers/{boxId}/fillapi_keyTake the other side of an offer: this wallet adds its margin plus 7.5 LIT and the position's ERG, and a position holding both sides is created. Refused when the fill would not be accepted in the next block. No body.
Path parameters
boxIdstringrequiredOffer box id, as listed by
GET /forwards/offersorGET /forwards/positions.
Responses
200Result of the fill transactionDFFillResult▶
txIdstringrequiredoutcomestringrequiredone ofacceptedrejecteduncertainpositionBoxIdstringrequired
400`boxId` is not a box id.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
403Missing or wrong api_keyApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
404No unspent offer has that id.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
409An unconfirmed transaction already spends the offer. Re-read `GET /forwards/offers`.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
422The offer is this wallet's own, short of the maker's side, expired, outside its window's lead for the next block, over the short-window limit, or the wallet cannot cover the fill.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