API Reference

Wallets

API Overview

Health

Webhook Subscriptions

Configurations

Monitor Tokens

Developer Account

Faucet

Developer-Controlled Wallets

Wallet Sets

Wallets

Signing

Transactions

Token Lookup

Modular Wallets

Transfers

UserOps

Wallets

User-Controlled Wallets

Social/ Email Authentication

PIN Authentication

Users

Wallets

Transactions

Token Lookup

Signing

Compliance Engine

Address Screening

Get supported payment routes

gethttps://api.circle.com/v1/cpn/configurations/routes

Reference
Playground

Returns a list of route details including trade limits. This information can determine what corridors and parameters are valid for subsequent quote creation.

Query parameters

destinationCountry

string

Required

Filter by destination country

sourceCurrency

string

Required

Filter by the source currency, should be the crypto token

destinationCurrency

string

Filter by destination currency, will return all available destinationCurrency's limit if empty

paymentMethodType

string

Filter by payment method, will return all available payment method types' limit if empty

blockchain

string

Filter by blockchain, will return all available blockchain limit if empty

Response

200PaymentRoutesResponse

Response Body

object

data

array of objects

Required

Array of payment routes containing all the necessary information for routing payments

Show 5 properties

destinationCurrency

string

Supported fiat currencies

Allowed valuesBRLEURGBPHKDMXNNGNUSD

paymentMethodType

string

The method used for the payment (e.g., PIX, WIRE, ACH)

Allowed valuesPIXSPEIWIREFPSCHATSBANK-TRANSFERSEPA

blockchain

string

Supported blockchain networks

Allowed valuesSOLMATICETHSOL-DEVNETMATIC-AMOYETH-SEPOLIA

cryptoLimit

object

Minimum and maximum transaction limits for a specific cryptocurrency. These limits define the acceptable range for transaction amounts in the specified currency.

Show 3 properties

currency

string

Supported cryptocurrencies

Allowed valuesUSDC

max

number

min

number

fiatLimit

object

Minimum and maximum transaction limits for a specific fiat currency. These limits define the acceptable range for transaction amounts in the specified currency.

Show 3 properties

currency

string

Supported fiat currencies

Allowed valuesBRLEURGBPHKDMXNNGNUSD

max

number

min

number

400BadRequestResponse

Response Body

object

code

integer

Required

Code that corresponds to the error.

message

string

Required

Human-readable message that describes the error.

errors

array of objects

Array of detailed error descriptions

Show 3 properties

error

string

Required

Type of descriptive error

Allowed valuesMISSING_OR_INVALID_FIELD

location

string

The key or path where the error occurred

message

string

Required

Detailed description of the error

401NotAuthorizedResponse

Response Body

object

code

integer

Required

Code that corresponds to the error.

message

string

Required

Human-readable message that describes the error.

errors

array of objects

Array of detailed error descriptions

Show 3 properties

error

string

Required

Type of descriptive error

Allowed valuesMISSING_OR_INVALID_FIELD

location

string

The key or path where the error occurred

message

string

Required

Detailed description of the error

403ForbiddenResponse

Response Body

object

code

integer

Required

Code that corresponds to the error.

message

string

Required

Human-readable message that describes the error.

errors

array of objects

Array of detailed error descriptions

Show 3 properties

error

string

Required

Type of descriptive error

Allowed valuesMISSING_OR_INVALID_FIELD

location

string

The key or path where the error occurred

message

string

Required

Detailed description of the error

RequestChoose a language

ResponseChoose an example

1{
2  "data": [
3    {
4      "destinationCurrency": "MXN",
5      "paymentMethodType": "SPEI",
6      "blockchain": "ETH-SEPOLIA",
7      "cryptoLimit": {
8        "currency": "USDC",
9        "max": 1000,
10        "min": 10
11      },
12      "fiatLimit": {
13        "currency": "MXN",
14        "max": 1000,
15        "min": 10
16      }
17    }
18  ]
19}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy