POST /v2/order-bundles/prepare-return

Prepare a fresh exact-amount return quote from verified funding and, when supplied, an owned terminal order with reconciled fill receipts. No-order path requires the client checkpoint to prove no placement was attempted. Client must stop on lost/ambiguous checkpoint or any prior return attempt; API is not a replay-proof allocation ledger. Remaining amount is bounded by funding and live balance; it never sweeps the wallet.

Request

  • Base URL
    https://api.arbital.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.arbital.xyz/v2/order-bundles/prepare-return
  • Auth
    HTTP bearer

Request body

funding_request_idstring required
source_transaction_idstring required
order_idstring

Response

Stateless client preparation or explicit pending/manual-review state

OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.