Retrieve Swap
Retrieves a swap and its status. Poll it after creating a crypto swap, which finishes in the background.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-10-29-8"
Path Parameters
Swap ID returned from POST /swaps.
Response
swap status retrieved
Account that owns the swap: a business ID prefixed biz_, or the user ID for a personal account.
"biz_xxxxxxxxxxxxxx"
The from_token amount the swap was created to spend, as a decimal string. A swap created with all reports the wallet balance it read. Null for a fiat pair.
"0.052341"
Swap ID.
"vault-swap-cwal_xxxxxxxxxxxxxx"
swap "swap"
Current swap status. complete and failed are terminal.
queued, working, complete, failed "failed"
On-chain transaction hashes produced by the swap.
User whose personal account owns the swap, prefixed user_. Null for a business account.
null
Latest error returned for a failed swap.
"Swap reverted: quoted price moved beyond the slippage tolerance"

