Sign in
Quotes

Create a quote

Create a quote. Use the Idempotency-Key header to prevent duplicate creation.

post/v1/quotes

Headers

Idempotency-Keystring

Idempotency key for preventing duplicate requests

X-API-Keystring

API key

Request body

sourceCurrency'USD' | 'EUR' | 'GBP' | 'CAD' | 'JPY' | 'PHP' | 'AUD' | 'MXN' | 'BRL' | 'AED' | 'ARS' | 'BDT' | 'BHD' | 'BOB' | 'CHF' | 'CLP' | 'CNY' | 'CNH' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'DOP' | 'EGP' | 'GHS' | 'GTQ' | 'HKD' | 'HNL' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'JMD' | 'JOD' | 'KES' | 'KRW' | 'KWD' | 'LKR' | 'MYR' | 'NGN' | 'NOK' | 'NZD' | 'PEN' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'TZS' | 'VND' | 'ZAR' | 'USDC' | 'USDT' | 'DAI' | 'ETH' | 'BTC' | 'SOL' | 'TRX' | 'EURC' | 'USDB' | 'PYUSD' | 'USDP' | 'CASH' | 'USDS'

Source currency code (required when using destinationAmount for receive-exact mode)

destinationCurrency'USD' | 'EUR' | 'GBP' | 'CAD' | 'JPY' | 'PHP' | 'AUD' | 'MXN' | 'BRL' | 'AED' | 'ARS' | 'BDT' | 'BHD' | 'BOB' | 'CHF' | 'CLP' | 'CNY' | 'CNH' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'DOP' | 'EGP' | 'GHS' | 'GTQ' | 'HKD' | 'HNL' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'JMD' | 'JOD' | 'KES' | 'KRW' | 'KWD' | 'LKR' | 'MYR' | 'NGN' | 'NOK' | 'NZD' | 'PEN' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'TZS' | 'VND' | 'ZAR' | 'USDC' | 'USDT' | 'DAI' | 'ETH' | 'BTC' | 'SOL' | 'TRX' | 'EURC' | 'USDB' | 'PYUSD' | 'USDP' | 'CASH' | 'USDS'

Destination currency code (required when using sourceAmount, derived from destinationAmount when provided)

destinationCountrystring

Destination country code (ISO 3166-1 alpha-2)

holdQuoteboolean

Whether to hold the quote and create a DB entry

payinMethod'ACH' | 'ACH_SAME_DAY' | 'WIRE' | 'FED_NOW' | 'RTP' | 'EREBOR' | 'EREBOR_RAIL' | 'BALANCE' | 'SWIFT' | 'SEPA' | 'SEPA_INSTANT' | 'TIPS' | 'FASTER_PAYMENTS' | 'BACS' | 'CHAPS' | 'ELIXIR' | 'NICS' | 'EFT' | 'INTERAC' | 'NPP' | 'BECS' | 'UPI' | 'IMPS' | 'IMPS_WITH_FIRC' | 'NEFT' | 'RTGS' | 'BI_FAST' | 'ARTAJASA' | 'PIX' | 'TED' | 'TEF' | 'SPEI' | 'COELSA' | 'SINPE' | 'CIPS' | 'CFXPS' | 'CHATS' | 'ZENGIN' | 'KFTC' | 'FAST_SG' | 'MEPS' | 'DUITNOW' | 'PROMPTPAY' | 'INSTAPAY' | 'PESONET' | 'NAPAS' | 'BEFTN' | 'SLIPS' | 'ZAHAV' | 'GHIPSS' | 'NIBSS' | 'PESALINK' | 'RTC_ZA' | 'TZS_RTGS' | 'EGP_ACH' | 'JOD_ACH' | 'NPSS' | 'MADA' | 'QPS' | 'DOP_ACH' | 'GTQ_ACH' | 'HNL_ACH' | 'PEN_ACH' | 'JMD_ACH' | 'USD_ACH_SV' | 'USD_ACH_EC' | 'CLP_TEF' | 'PSE' | 'COP_ACH' | 'BOB_RTGS' | 'PYG_ACH' | 'CERTIS' | 'DKK_TIPS' | 'SENT' | 'NKS' | 'BANKGIROT' | 'HKD_FPS' | 'IBFT' | 'TRY_FAST' | 'ETHEREUM' | 'BASE' | 'POLYGON' | 'SOLANA' | 'TRON' | 'BITCOIN' | 'ARBITRUM'

Payment rail for source funds. For crypto, specify chain (ethereum, base, polygon, solana, tron). For fiat, specify network (ach, sepa, fast_sg).

payoutMethod'ACH' | 'ACH_SAME_DAY' | 'WIRE' | 'FED_NOW' | 'RTP' | 'EREBOR' | 'EREBOR_RAIL' | 'BALANCE' | 'SWIFT' | 'SEPA' | 'SEPA_INSTANT' | 'TIPS' | 'FASTER_PAYMENTS' | 'BACS' | 'CHAPS' | 'ELIXIR' | 'NICS' | 'EFT' | 'INTERAC' | 'NPP' | 'BECS' | 'UPI' | 'IMPS' | 'IMPS_WITH_FIRC' | 'NEFT' | 'RTGS' | 'BI_FAST' | 'ARTAJASA' | 'PIX' | 'TED' | 'TEF' | 'SPEI' | 'COELSA' | 'SINPE' | 'CIPS' | 'CFXPS' | 'CHATS' | 'ZENGIN' | 'KFTC' | 'FAST_SG' | 'MEPS' | 'DUITNOW' | 'PROMPTPAY' | 'INSTAPAY' | 'PESONET' | 'NAPAS' | 'BEFTN' | 'SLIPS' | 'ZAHAV' | 'GHIPSS' | 'NIBSS' | 'PESALINK' | 'RTC_ZA' | 'TZS_RTGS' | 'EGP_ACH' | 'JOD_ACH' | 'NPSS' | 'MADA' | 'QPS' | 'DOP_ACH' | 'GTQ_ACH' | 'HNL_ACH' | 'PEN_ACH' | 'JMD_ACH' | 'USD_ACH_SV' | 'USD_ACH_EC' | 'CLP_TEF' | 'PSE' | 'COP_ACH' | 'BOB_RTGS' | 'PYG_ACH' | 'CERTIS' | 'DKK_TIPS' | 'SENT' | 'NKS' | 'BANKGIROT' | 'HKD_FPS' | 'IBFT' | 'TRY_FAST' | 'ETHEREUM' | 'BASE' | 'POLYGON' | 'SOLANA' | 'TRON' | 'BITCOIN' | 'ARBITRUM'

Payment rail for destination funds. For crypto, specify chain (ethereum, base, polygon, solana, tron). For fiat, specify network (ach, sepa, fast_sg).

stablecoinParityboolean

Treat stablecoin/fiat pairs as 1:1 (e.g., 1 USDT = 1 USD). Only applicable to stablecoin/fiat conversions. Any market difference is settled via postpaid billing. Defaults to true for eligible pairs.

onBehalfOfstring

Customer the quote is for. Some customers are configured for customer-specific pricing on stablecoin pairs; pass the customer the eventual transfer will execute for so the quoted rate matches it. Omitted: standard pricing.

Example request

{
  "sourceAmount": {
    "currency": "USD",
    "rawValue": "1000000"
  },
  "destinationAmount": {
    "currency": "USD",
    "rawValue": "1000000"
  },
  "sourceCurrency": "USD",
  "destinationCurrency": "USDC",
  "destinationCountry": "US",
  "payinMethod": "base",
  "payoutMethod": "fast_sg",
  "stablecoinParity": true,
  "onBehalfOf": "cus_abc123"
}

Response

Quote created successfully

idstring

Quote ID (only present for held quotes)

exchangeRatestring required

Exchange rate (inclusive of all fees)

sourceRailstring

Source payment rail

destinationRailstring

Destination payment rail

expiresAtstring date-time

Quote expiration timestamp (only present for held quotes)

createdAtstring date-time required

Quote creation timestamp

lockableboolean required

Whether the exchange rate can be locked for 24 hours

Example response

{
  "id": "quote_abc123",
  "sourceAmount": {
    "currency": "USD",
    "exponent": 2,
    "value": "12345",
    "displayValue": "123.45"
  },
  "destinationAmount": {
    "currency": "USD",
    "exponent": 2,
    "value": "12345",
    "displayValue": "123.45"
  },
  "exchangeRate": "1.00500",
  "sourceRail": "ACH",
  "destinationRail": "SWIFT",
  "expiresAt": "2026-09-15T10:35:00Z",
  "createdAt": "2026-09-15T10:30:00Z",
  "lockable": true,
  "route": {
    "supported": true,
    "flow": "CRYPTO_TO_SWIFT",
    "summary": "USDC → USD",
    "totalFeeBps": 2,
    "estimate": {
      "estimatedReceiveAt": "2026-09-17T10:30:00Z",
      "estimatedMinutes": 2880,
      "nextCutoff": "2026-09-15T15:00:00Z",
      "cutoffTimezone": "Asia/Singapore"
    },
    "minimumAmount": {
      "currency": "USD",
      "exponent": 2,
      "value": "12345",
      "displayValue": "123.45"
    },
    "legs": [
      {
        "type": "payout_fiat",
        "inputCurrency": "USDC",
        "outputCurrency": "USD",
        "inputRail": "ETHEREUM",
        "outputRail": "SWIFT",
        "feeBps": 2,
        "settlementType": "T+2"
      }
    ]
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.