Quotes

Estimate how much a user will receive for a given input amount. Always quote before showing a number — rates and minimums move with market conditions.

Request body

Example

const res = await fetch(`${BASE}/v1/quotes`, {
  method: 'POST',
  headers: { 'Authorization': AUTH, 'Content-Type': 'application/json' },
  body: JSON.stringify({ from: 'btc', to: 'eth', amountFrom: '0.01' }),
});
const { quote } = await res.json();
console.log(`User receives ~${quote.amountUserReceives} ${quote.to}`);

Response

{
  "quote": {
    "from": "btc",
    "to": "eth",
    "amountFrom": "0.01",
    "amountTo": "0.1532",
    "networkFee": "0.0021",
    "amountUserReceives": "0.1511",
    "rate": "15.32",
    "fee": "0.001",
    "min": "0.0008",
    "max": "5.0",
    "mode": "float"
  }
}

Response fields

Fixed-rate quotes

Pass mode: "fixed" to lock the exchange rate. Instead of an indicative quote you get a rateId — a short-lived token that pins the rate. Hand that rateId to POST /v1/swaps and the user is guaranteed the quoted output amount, regardless of how the market moves between quote and deposit.

const res = await fetch(`${BASE}/v1/quotes`, {
  method: 'POST',
  headers: { 'Authorization': AUTH, 'Content-Type': 'application/json' },
  body: JSON.stringify({ from: 'btc', to: 'eth', amountFrom: '0.01', mode: 'fixed' }),
});
const { quote } = await res.json();
// quote.rateId    → pass to POST /v1/swaps
// quote.expiresAt → ISO timestamp; re-quote once it passes

A fixed quote response sets "mode": "fixed", carries two extra fields, and omits fee:

{
  "quote": {
    "mode": "fixed",
    "from": "btc",
    "to": "eth",
    "amountFrom": "0.01",
    "amountTo": "0.1532",
    "networkFee": "0.0021",
    "amountUserReceives": "0.1511",
    "rate": "15.32",
    "min": "0.0008",
    "max": "5.0",
    "rateId": "f7c2a1b9e4d8...",
    "expiresAt": "2026-05-21T18:01:00.000Z"
  }
}

Rules for fixed-rate quotes:

• The rateId is valid for only ~60 seconds. Create the swap promptly. Once expiresAt passes, request a fresh quote — a stale rateId is rejected on swap creation with rate_expired (HTTP 409).
• Pass the same amountFrom to POST /v1/swaps that you quoted. The locked rate is bound to that exact input amount.
• A fixed quote has no fee field — the locked rate already accounts for the liquidity-provider fee.

Notes

• Always show amountUserReceives as the headline number. Showing raw amountTo over-promises by networkFee.
• Use tickers from GET /v1/currencies; the quote response echoes canonical tickers. Example: USDT on TRON is usdtrx (common aliases like usdttrx are accepted but normalized).
• Float quotes are indicative, not locked. The final amount on POST /v1/swaps may differ slightly because we re-quote at swap creation time.
• For a locked rate that can't drift between quote and deposit, use fixed-rate quotes (mode: "fixed") — see the section above.

Errors