Corridor Pricing API

Get quotes for all possible payment corridor routes

This endpoint returns all possible cross-chain payment routes, their fees and estimated execution time.

post

/corridors/quotes

Authorizations

Body

amountnumber · floatrequired

Amount in normal USD denomination (e.g., 10.5 for $10.50)

Example: 100.5

source_accountstringrequired

Source wallet address

Example: 0xb796b0db4333ef2ffac835a1e05c75e0c119d4

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

routing_prioritystring · enum · default: AUTO

Routing strategy for cross-chain payments

Options: COST, SPEED, BALANCED, AUTO

destinationsobject

Destination networks and tokens configuration

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-core.paygrid.co/v1/corridors/quotes' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"amount":100.5,"source_account":"0xb796b0db4333ef2ffac835a1e05c75e0c119d4","routing_priority":"AUTO","destinations":{"networks":["POLYGON","BASE","OPTIMISM"],"tokens":["USDC","USDT"]}}'

200

400

401

404

500

200

{
  "corridor_quotes": [
    {
      "corridorId": "POLYGON_POLYGON_USDC_USDT",
      "total_fee": 0.0005,
      "speed": 30,
      "price_impact": 0.9995
    },
    {
      "corridorId": "BASE_BASE_USDC_USDT",
      "total_fee": 0.0005,
      "speed": 30,
      "price_impact": 0.9995
    }
  ]
}

Quote retrieved successfully