Skip to main content
POST
/
v1
/
cpn
/
quotes
Create a quote
curl --request POST \
  --url https://api.circle.com/v1/cpn/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "paymentMethodType": "SPEI",
  "senderCountry": "MX",
  "sourceAmount": {
    "amount": "10",
    "currency": "USDC"
  },
  "destinationCountry": "MX",
  "destinationAmount": {
    "amount": "",
    "currency": "MXN"
  },
  "blockchain": "ETH-SEPOLIA",
  "senderType": "BUSINESS",
  "recipientType": "BUSINESS",
  "quoteOptions": {
    "isFirstParty": true
  },
  "transactionVersion": "VERSION_2"
}'
{
  "data": [
    {
      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
      "paymentMethodType": "SPEI",
      "blockchain": "ETH-SEPOLIA",
      "senderCountry": "MX",
      "destinationCountry": "MX",
      "createDate": "2023-01-01T12:04:05Z",
      "quoteExpireDate": "2023-01-01T12:04:05Z",
      "cryptoFundsSettlementExpireDate": "2023-01-01T12:04:05Z",
      "sourceAmount": {
        "amount": "10.000000",
        "currency": "USDC"
      },
      "destinationAmount": {
        "amount": "183.24",
        "currency": "MXN"
      },
      "fiatSettlementTime": {
        "max": "3",
        "min": "1",
        "unit": "DAYS"
      },
      "exchangeRate": {
        "pair": "USDC/MXN",
        "rate": "18.324000"
      },
      "fees": {
        "breakdown": [
          {
            "type": "BFI_TRANSACTION_FEE",
            "amount": {
              "amount": "0.240000",
              "currency": "USDC"
            }
          }
        ],
        "totalAmount": {
          "amount": "0.240000",
          "currency": "USDC"
        }
      },
      "senderType": "BUSINESS",
      "recipientType": "BUSINESS",
      "certificate": {
        "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
        "domain": "api.circle.com",
        "jwk": {
          "crv": "P-256",
          "kid": "263521881931753643998528753619816524468853605762",
          "kty": "EC",
          "x": "KnxBe8fb2mL_Ve9-tqjGSkGgE9f0yohMkAvH_InaFtE",
          "y": "D41cVUpiKcey4LJKNFtUtmVHDWRmhjZapPLfryX5b1o"
        }
      },
      "quoteOptions": {
        "isFirstParty": true
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Circle's API Keys are formatted in the following structure "PREFIX:ID:SECRET". All three parts are requred to make a successful request.

Body

application/json

Request body for creating payment quotes with exchange rates and fees

​
senderCountry
enum<string>
required

ISO 3166-1 alpha-2 two-letter country code supported by the Circle Payment Network

Available options:
AT,
BE,
BG,
BR,
CH,
CN,
CO,
CY,
CZ,
DE,
DK,
EE,
ES,
FI,
FR,
GB,
GR,
HK,
HR,
HU,
IE,
IN,
IT,
LI,
LT,
LU,
MT,
MX,
NG,
NL,
NO,
PL,
PT,
RO,
SE,
SI,
SK,
US
Example:

"MX"

​
sourceAmount
object
required

The amount of fiat currency to be delivered to the destination. This field is an object containing the currency code and the amount. This field is required; however, if your query is based on the destinationAmount, leave the amount field blank and only populate the currency field.

​
destinationCountry
enum<string>
required

ISO 3166-1 alpha-2 two-letter country code supported by the Circle Payment Network

Available options:
AT,
BE,
BG,
BR,
CH,
CN,
CO,
CY,
CZ,
DE,
DK,
EE,
ES,
FI,
FR,
GB,
GR,
HK,
HR,
HU,
IE,
IN,
IT,
LI,
LT,
LU,
MT,
MX,
NG,
NL,
NO,
PL,
PT,
RO,
SE,
SI,
SK,
US
Example:

"MX"

​
destinationAmount
object
required

The amount of fiat currency to be delivered to the destination. This field is an object containing the currency code and the amount. This field is required; however, if your query is based on the sourceAmount, leave the amount field blank and only populate the currency field.

​
blockchain
enum<string>
required

Supported blockchain networks

Available options:
SOL,
MATIC,
ETH,
SOL-DEVNET,
MATIC-AMOY,
ETH-SEPOLIA
Example:

"ETH-SEPOLIA"

​
senderType
enum<string>
required

Type of entity sending or receiving the payment

Available options:
BUSINESS,
INDIVIDUAL
Example:

"BUSINESS"

​
recipientType
enum<string>
required

Type of entity sending or receiving the payment

Available options:
BUSINESS,
INDIVIDUAL
Example:

"BUSINESS"

​
paymentMethodType
enum<string>

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

Available options:
AANI,
BANK-TRANSFER,
CHATS,
CIPS,
FAST,
FPS,
FTS,
IMPS,
INSTA-PAY,
NEFT,
NEQUI,
PESONET,
PIX,
RTGS,
SEPA,
SPEI,
WIRE
Example:

"SPEI"

​
quoteOptions
object

Additional information for the OFI to provide a more precise quote

​
transactionVersion
enum<string>

The version of the transaction. If not provided, defaults to VERSION_1.

Available options:
VERSION_1,
VERSION_2
Example:

"VERSION_2"

Response

Quotes created successfully

​
data
object[]
required

Array of quotes containing all the necessary information for payments

⌘I