Skip to main content
POST
Swap assets

Authorizations

Authorization
string
header
required

API key sent in the Authorization header.

Body

application/json

Request body for initiating an asset swap from a swap-type quote.

blockchain
enum<string>
required

Blockchain the swap executes on.

Available options:
stellar,
solana,
base,
polygon,
monad
orderId
string<uuid>
required

Client-generated order ID (UUID) for this swap.

publicKey
string
required

Customer's wallet public key on blockchain.

quoteId
string<uuid>
required

Quote ID from a prior /ramp/quote call made with quoteAssets.type: "swap".

targetWallet
string | null

Optional destination wallet; defaults to publicKey when omitted.

Response

Swap accepted; track completion via swap_updated webhooks