Skip to main content
Swaps convert value between supported tokens, chains, or wallet destinations for an account. A swap quote describes the expected output, fees, and approval requirements before you create the swap. Use the Swaps API to quote a conversion, create the swap, list recent swaps, and retrieve status until the transaction completes.

​
Endpoints

EndpointRequest
List SwapsGET /swaps
Create SwapPOST /swaps
Retrieve SwapGET /swaps/{id}
Create Swap QuotePOST /swaps/quote

​
Attributes

​
account_id
string
required
Account ID that owns the wallet used for the swap.
​
error
string | null
Latest error returned for a failed swap.
​
id
string
required
Swap ID.
​
object
string
required
​
status
string
required
Current swap status.
​
tx_hashes
string[]
required
On-chain transaction hashes produced by the swap.
Swap
{
	"account_id": "biz_xxxxxxxxxxxxxx",
	"error": null,
	"id": "swap_xxxxxxxxxxxx",
	"object": "swap",
	"status": "completed",
	"tx_hashes": ["0x1234567890abcdef"]
}