{ "success": false, "data": null, "error": { "code": "TX_WOULD_REVERT", "message": "There is nothing to withdraw for this wallet.", "details": { "action": "withdrawal", "error": "NothingToWithdraw" } }, "metadata": { "timestamp": "2026-10-18T21:45:31.020Z", "requestId": "3f7c2a91-6d84-4b0e-9a15-c2e8f4d7b603", "instanceId": "inst_abc123" }}
Financing is in beta and runs on Ethereum Sepolia instances only for now (DEVELOPMENT instances on Ethereum). A PRODUCTION instance, or one on another network, answers 503 SELLER_FINANCING_UNAVAILABLE. See Financing.
Builds the payout of the signing wallet’s whole claimable balance, read with Get Claimable, in the payment token. An asset the custody adapter holds in escrow is not part of it: reclaim that with Claim Escrowed Collateral. The wallet that signs is the wallet paid for: only it can withdraw its balance, to to or to itself.A withdrawal stays open while the market is paused. When the payment token refuses to pay a wallet, for example one its issuer blacklisted, the owner of the balance can name another to. One wallet’s refusal never holds back another’s balance.The step pays out the balance at the moment it is mined, so amount in the answer can be lower than what arrives when more was credited in between.
The wallet that receives the payout. It cannot be the market or its adapter. Omitted, "" or null, the payout goes to from.
string
required
The wallet whose balance is paid out, which signs. Without it the answer is 400 FROM_REQUIRED. A wallet with nothing to withdraw answers 409 TX_WOULD_REVERT with NothingToWithdraw.
Response Fields
object
Show child attributes
string
SIGN_TRANSACTIONS.
integer
The chain the step is built for.
array
One step, withdraw on the market, with gasLimit.
integer
0.
object
{ simulated: true, gasEstimate }.
string
The wallet that receives the payout.
string
The balance of from when the request was built, in the payment token’s smallest unit.
{ "success": false, "data": null, "error": { "code": "TX_WOULD_REVERT", "message": "There is nothing to withdraw for this wallet.", "details": { "action": "withdrawal", "error": "NothingToWithdraw" } }, "metadata": { "timestamp": "2026-10-18T21:45:31.020Z", "requestId": "3f7c2a91-6d84-4b0e-9a15-c2e8f4d7b603", "instanceId": "inst_abc123" }}
Error Codes
Code
HTTP
Cause
VALIDATION_ERROR
400
An address is malformed, or the body carries another field. error.details names it
FROM_REQUIRED
400
from is missing. The message names who signs: the wallet whose claimable balance is paid out
MARKET_NOT_FOUND
404
No market with this ID that your instance reaches on its network
TX_WOULD_REVERT
409
NothingToWithdraw when from has no balance, InvalidAddress when to is the market or its adapter, or a refusal of the payment token such as SafeERC20FailedOperation
CHAIN_UNAVAILABLE
503
The chain could not be read. Nothing was built. Retry shortly
SELLER_FINANCING_UNAVAILABLE
503
The instance is a PRODUCTION instance or not on Ethereum
WITHDRAW_BUILD_FAILED
500
Unexpected failure. Nothing was built. Retry, or contact support with the request ID