Quote

Quote operations for token swaps

Create a quote for token swap

post

Computes optimal routing for a token swap and returns a quote with estimated outputs, costs, and routing details. The quote is stored server-side and a quote_id is returned for use with the Build endpoint.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication. Can also be provided via Authorization header with Bearer prefix: Authorization: Bearer <api-key>

Body

application/json

takerstringRequired

Address holding input tokens with allowances set. This address will execute the transaction.

Example: 0x742d35Cc6634C0532925a3b844Bc9e7595f8b3c4Pattern: ^0x[a-fA-F0-9]{40}$

recipientstringOptional

Address to receive output tokens. Defaults to taker if not specified.

Example: 0x742d35Cc6634C0532925a3b844Bc9e7595f8b3c4Pattern: ^0x[a-fA-F0-9]{40}$

slippage_tolerance_bpsinteger · max: 5000Optional

Maximum acceptable slippage in basis points (0-5000). 100 = 1%.

Default: 100Example: 100

max_hopsinteger · min: 1 · max: 10Optional

Maximum number of intermediate swaps allowed.

Default: 4Example: 4

exclude_protocolsstring[]Optional

Protocol identifiers to exclude from routing.

Example: ["uniswap_v2","sushiswap"]

exclude_poolsstring[]Optional

Pool addresses to exclude from routing.

Example: ["0x8ad599c3A0ff1De082011EFDDc58f1908eb6e6D8"]

simulatebooleanOptional

Whether to run full causal simulation. Disabling returns faster but less accurate quotes.

Default: true

gas_prioritystring · enumOptional

Gas price tier for cost estimation. Affects EIP-1559 gas parameters.

• slow: Lower priority, saves gas cost but may take longer to confirm
• standard: Normal priority, balanced cost and speed
• fast: Higher priority, recommended for most swaps (default)
• urgent: Highest priority, for time-sensitive transactions

Default: fastPossible values:

include_usd_pricingbooleanOptional

Whether to include USD pricing in the response. When true, costs will include gas_cost_usd, fee_cost_usd, max_slippage_usd, and total_cost_usd.

Default: false

check_allowancesbooleanOptional

Check on-chain allowances and only return approvals for tokens with insufficient allowance.

Default: false

include_permit2booleanOptional

Include Permit2 EIP-712 typed data for signature-based approval flow.

Default: false

Responses

200

Quote created successfully

application/json

400

Bad request - invalid JSON or request format

application/json

401

Unauthorized - missing or invalid API key

application/json

403

Forbidden - insufficient permissions

application/json

422

Unprocessable entity - validation error or routing failure

application/json

500

Internal server error

application/json

503

Service unavailable

application/json

post

/v1/quote

HTTPcURLJavaScriptPython

POST /v1/quote HTTP/1.1
Host: api.infraredtrading.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 266

{
  "inputs": [
    {
      "chain_id": 1,
      "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "amount": "1000000000000000000"
    }
  ],
  "outputs": [
    {
      "chain_id": 1,
      "address": "0x6B175474E89094C44Da98b954EedeBC836211103",
      "ratio_bps": 10000
    }
  ],
  "taker": "0x742d35Cc6634C0532925a3b844Bc9e7595f8b3c4"
}

Single token swapSplit output to multiple tokens

{
  "data": {
    "quote_id": "550e8400-e29b-41d4-a716-446655440000",
    "inputs": [
      {
        "chain_id": 1,
        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "amount": "1000000000000000000"
      }
    ],
    "outputs": [
      {
        "chain_id": 1,
        "address": "0x6B175474E89094C44Da98b954EedeBC836211103",
        "ratio_bps": 10000
      }
    ],
    "taker": "0x742d35Cc6634C0532925a3b844Bc9e7595f8b3c4",
    "estimated_outputs": [
      {
        "token": "0x6B175474E89094C44Da98b954EedeBC836211103",
        "chain_id": 1,
        "expected_amount": "1850000000000000000000",
        "minimum_amount": "1831500000000000000000"
      }
    ],
    "costs": {
      "gas_cost_wei": "5000000000000000",
      "gas_cost_usd": 8.5,
      "fee_cost_usd": 5.55,
      "max_slippage_usd": 2.25,
      "total_cost_usd": 14.05,
      "total_gas_units": 250000,
      "base_fee_wei": 15000000000,
      "max_priority_fee_per_gas": 2000000000,
      "max_fee_per_gas": 20000000000,
      "gas_priority": "fast"
    },
    "path": {
      "tokens": {
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": {
          "name": "Wrapped Ether",
          "symbol": "WETH",
          "decimals": 18,
          "token_type": "erc20"
        },
        "0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc": {
          "name": "Uniswap V2",
          "symbol": "UNI-V2",
          "decimals": 18,
          "token_type": "lp"
        }
      },
      "steps": [
        {
          "type": "swap",
          "protocol": "uniswap_v3",
          "pool": "0x8ad599c3A0ff1De082011EFDDc58f1908eb6e6D8",
          "tokens_in": [
            "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
          ],
          "tokens_out": [
            "0x6B175474E89094C44Da98b954EedeBC836211103"
          ],
          "amounts_in": [
            "1000000000000000000"
          ],
          "amounts_out": [
            "1850000000000000000000"
          ],
          "gas_estimate": "60000",
          "share_of_input_bps": 10000
        }
      ]
    },
    "protocols_used": [
      "uniswap_v3",
      "curve"
    ],
    "approvals": [
      {
        "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "amount": "1000000000000000000",
        "spender": "0x1234567890123456789012345678901234567890"
      }
    ],
    "permit2": {
      "hash": "0x6b35d87d974ef207889b10326321b83869cac1f3b637656901bbd075b68e7123",
      "eip712": {
        "types": {
          "EIP712Domain": [
            {
              "name": "text",
              "type": "text"
            }
          ],
          "TokenPermissions": [
            {
              "name": "text",
              "type": "text"
            }
          ],
          "PermitTransferFrom": [
            {
              "name": "text",
              "type": "text"
            }
          ]
        },
        "domain": {
          "name": "Permit2",
          "chainId": 1,
          "verifyingContract": "0x000000000022d473030f116ddee9f6b43ac78ba3"
        },
        "primaryType": "PermitTransferFrom",
        "message": {
          "permitted": {
            "token": "text",
            "amount": "text"
          },
          "spender": "text",
          "nonce": "text",
          "deadline": "text"
        }
      }
    }
  }
}