POST/api/v2/crypto-virtual-accounts/exchange/quote

Request an exact the crypto on/off-ramp balance-to-balance quote

Returns an expiring quote for fiat-to-crypto or crypto-to-fiat conversion between the selected the crypto on/off-ramp account IDs. Read account IDs from trading-overview and never calculate a rate locally.

Authentication

Send your API key in the x-api-key header on every request.

Request body

application/json

Request body fields
FieldTypeRequiredDescription
UserIdunknownNo
SellCurrencystringYes
BuyCurrencystringYes
SellAmountstringYes
DepositAccountIdunknownNo
SettlementAccountIdunknownNo
SellChainIdunknownNo
SellTokenAddressstringNo
BuyChainIdunknownNo
BuyTokenAddressstringNo

Responses

200 — OK

Response 200 fields
FieldTypeRequiredDescription
buy_currencystringNo
buy_amountstringNo
sell_currencystringNo
sell_amountstringNo
payment_methodstringNo
quote_timestring (date-time)No
expirystring (date-time)No
ratestringNo
feesobjectNo
quote_amountstringNo
settlement_ccystringNo
settlement_chain_idunknownNo
settlement_token_addressstringNo
sessionstringNo

400 — Bad Request

Response 400 fields
FieldTypeRequiredDescription
MessagestringNo
CodestringNo
StatusunknownNo
ValidationErrorsobjectNo
DetailsstringNo

401 — Unauthorized

Response 401 fields
FieldTypeRequiredDescription
MessagestringNo
CodestringNo
StatusunknownNo
ValidationErrorsobjectNo
DetailsstringNo

Example request

curl -X POST "https://{base_url}/api/v2/crypto-virtual-accounts/exchange/quote" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"SellCurrency":"…","BuyCurrency":"…","SellAmount":"…"}'

This page is generated from the live OpenAPI specification and always matches the current API.