Paygrid
WebsiteDiscord
  • Getting started
    • Introduction
    • Reach out
  • How it works
    • Demo
    • Core features
      • Chain abstracted payments
      • Payment Clearing and MEV
    • Supported Networks & Tokens
  • Use cases
    • Payment workflows
    • Recurring workflows
    • Invoice workflows
    • Agentic workflows
    • DeFi - High Frequency Trading workflows
  • Technical Docs
    • What is a Payment Intent?
    • What is a Corridor?
    • Payment Lifecycle
    • Paygrid API
      • Authentication
      • Payment Intent API
      • Corridor Pricing API
      • Webhooks & IPN Events
      • Payment Recovery & Fallback Guarantees
    • Paygrid SDK
      • Quickstart
    • Security Considerations
  • Resources
    • Discord
    • Brand assets
Powered by GitBook
On this page
  1. Technical Docs
  2. Paygrid API

Corridor Pricing API

PreviousPayment Intent APINextWebhooks & IPN Events

Last updated 4 months ago

Get quotes for all possible payment corridor routes

post

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

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: 0xb796b0db4333ef2ffac835a1e05c75e0c119d4Pattern: ^0x[a-fA-F0-9]{40}$
routing_prioritystring · enumOptional

Routing strategy for cross-chain payments

Default: AUTOPossible values:
Responses
200
Quote retrieved successfully
application/json
400Error
401Error
404
No valid corridor route quotes found
500
Internal pricing service error
post
POST /v1/corridors/quotes HTTP/1.1
Host: api-core.paygrid.co
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 185

{
  "amount": 100.5,
  "source_account": "0xb796b0db4333ef2ffac835a1e05c75e0c119d4",
  "destinations": {
    "networks": [
      "POLYGON",
      "BASE",
      "OPTIMISM"
    ],
    "tokens": [
      "USDC",
      "USDT"
    ]
  },
  "routing_priority": "AUTO"
}
{
  "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
    }
  ]
}