Skip to content

Batch Quote

POST /api/v1/pay/batch-quote

Batch quote — fetches prices for all payment methods at once on the checkout page. Quotes are fetched concurrently internally, each with a 5s timeout, without blocking each other.

Request

{
  "settle_chain": "eip155:8453",
  "settle_token": "USDC",
  "settle_amount": "10000000",
  "pay_options": [
    { "blockchain": "eth", "token": "ETH" },
    { "blockchain": "arb", "token": "USDC" },
    { "blockchain": "ton", "token": "TON" }
  ]
}
FieldTypeDescription
settle_chainstringSettlement chain
settle_tokenstringSettlement token
settle_amountstringSettlement amount (smallest unit)
pay_optionsPayOption[]List of payment methods to quote

Response

{
  "quotes": [
    {
      "blockchain": "eth",
      "token": "ETH",
      "result": {
        "Ok": {
          "quote": {
            "method": "CrossChain",
            "pay_amount": "4200000000000000",
            "pay_amount_formatted": "0.0042",
            "pay_amount_usd": "10.50",
            "estimated_time": 120,
            "exchange_rate": "2500.00",
            "slippage_bps": 50,
            "expires_at": "2026-03-23T12:30:00Z"
          }
        }
      }
    },
    {
      "blockchain": "ton",
      "token": "TON",
      "result": {
        "Error": {
          "error": "Insufficient liquidity for this route"
        }
      }
    }
  ]
}

Each result is either Ok { quote } or Error { error }, handle accordingly on the frontend.