Swaps

Create Swap

Executes a swap from the account's wallet. Runs asynchronously; poll GET /swaps/{id} for status.

post/swaps

Request body

account_idstring required

Business or user account ID (biz_* / user_*).

amountstring required

Source token amount.

from_tokenstring required

Source token contract address or ticker symbol, such as "USDT".

slippage_bpsinteger nullable

Maximum slippage tolerance in basis points.

to_tokenstring required

Destination token contract address or ticker symbol, such as "XAUT".

Response

swap created

account_idstring required

Account ID that owns the wallet used for the swap.

amount_out_expectedstring

Expected destination token amount.

amount_out_minstring

Minimum destination amount after slippage.

idstring required

Swap ID. Poll GET /swaps/:id for status.

object'swap' required
ratestring

Quoted exchange rate used to create the swap.

statusstring required

Initial swap status.

to_chainstring

Destination chain for the swap.

Changes