Skip to main content
GET
Get private send quote

Authorizations

Authorization
string
header
required

Send Authorization: <ApiKey>:<ApiSecret> — joined by a colon, raw. No Bearer prefix, no base64.

Get your credentials

Query Parameters

amount
number<double>
required

Amount of the from token to swap, e.g. 1.5 BTC or 250.75 USDT — not base units / wei like 100000000000000.

Required range: 0 <= x <= 1.7976931348623157e+308
token
string
required

Token to send. Use an id from Get tokens with hasSelfPrivate=true — not a symbol.

markup
number<double>

Markup for this request, as a percentage — 0.5 means 0.5%.

  • range 0–4; overrides your account default for this trade
  • send 0 for no markup, or omit the field to use your account default
  • providers that cannot apply it are excluded from the results
  • not supported on DEX routes. Leave types unset and DEX quotes are simply left out; ask for types=dex together with a markup and the request is rejected
Required range: 0 <= x <= 4
useXmr
boolean

Use Monero (XMR) as the bridge token on a private swap.

A private route hops through an intermediary token so the deposit and the payout are not linkable on-chain. true pins that hop to XMR; leave it unset and the hop is picked from a rotating set of other tokens. Ignored by standard and DEX quotes, which are single-leg.

fixed
boolean

Request a fixed-rate quote. Only partners that support fixed rate will be returned. Available for standard and private CEX quotes; not supported for DEX.

refundAddress
string

Where funds are returned if a swap cannot complete. Optional here — quotes are never filtered by it.

  • use a wallet the user controls, not an exchange deposit address
  • must be on the source chain — the refund comes back as the token you deposited
  • a route that will need one comes back with requiresRefundAddress: true
  • supply it at Create exchange, where it is required for fixed-rate quotes and for those routes
Maximum string length: 200
deviationThreshold
number<double>

Maximum price deviation percentage when rotating wallets. Only used if rotatePayoutWallets is true. Default 5

Required range: 0 <= x <= 100
rotationLookback
integer<int32>

Number of recent orders to check for path rotation. Only used if rotatePayoutWallets is true. Default 10

Required range: 1 <= x <= 100
rotatePayoutWallets
boolean

Rotate the payout path for better privacy. Only used for private swaps (types=private) — standard and DEX are single-leg and ignore it.

rotateFallback
boolean

When strict rotation exhausts every rotated route, fall back to a valid non-rotated route instead of failing. Default false. Requires rotatePayoutWallets — a no-op on its own.

inLegIncludedSwaps
string[]

Only use these providers for the in-leg of a private (2-hop) route. Ignored by standard and DEX quotes, which are single-hop.

inLegExcludedSwaps
string[]

Never use these providers for the in-leg of a private (2-hop) route. Does not affect the out-leg. Ignored by standard and DEX quotes.

outLegIncludedSwaps
string[]

Only use these providers for the out-leg of a private (2-hop) route. Ignored by standard and DEX quotes, which are single-hop.

outLegExcludedSwaps
string[]

Never use these providers for the out-leg of a private (2-hop) route. Does not affect the in-leg. Ignored by standard and DEX quotes.

Response

Success

quotes
object[]
required
total
number<double>
required