Redeem a provision directly on any pool

post/dex/pools/{poolNft}/redeemapi_key

Closes one of this wallet's provisions now. Open on every pool, whatever its genesis. Fees the vault owes the provision are lost with its box, so a provision owed any needs acknowledgeUnclaimedFees; claim them first to keep them.

Path parameters

poolNftstringrequired
The pool's NFT id, 64 hex characters

Request body

LDPoolDirectRedeemRequest · application/json

provisionBoxIdstringrequired
acknowledgeUnclaimedFeesboolean
Required when the vault owes the provision fees, which the redemption destroys.
expectedPoolBoxIdstring

Responses

200The transaction sentLDPoolDirectResult▶

A direct spend sent. For a swap amountX is what was sold and amountY what came back; for a deposit and a redemption, X and Y in pool order.

outcomestringrequired
txIdstringrequired
poolNFTstringrequired
kindstringrequired
one ofSWAPDEPOSITREDEEM
amountXstringrequired
amountYstringrequired
sharesstring
ownerNFTstring
provisionBoxIdstring

400The request is malformed, names a token the pool does not hold, or leaves out an acknowledgement it needs.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

403Missing or wrong api_keyApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

404No LithosDex pool with that NFT, or no live provision with that id.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

409The pool or provision moved since the quote, or another LithosDex mutation is running. Re-quote and resend.LDStateChangedResponse▶

errorintegerrequired
reasonstringrequired
detailstringrequired
What moved, and what it moved to
poolBoxIdstring
Current pool box id
vaultBoxIdstring
Current vault box id
provisionBoxIdstring
Current provision box id

422The pool can be drained, the pool cannot fill this at its depth or above the floor, or the wallet cannot cover it.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

503Node or wallet unavailable. Retry.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

← PreviousQuote a direct redemption on any pool Next →List your provisions on any pool