API Reference

Get details of a quote

gethttps://api.circle.com/v1/cpn/quotes/{quoteId}

Reference
Playground

Retrieve details of a specific quote (e.g., re-check expiration, fees).

Path parameters

quoteId

uuid

Required

The quote id that was created previously.

Response

200QuoteResponse

Response Body

object

data

object

Required

A quote containing all the necessary information for a cryptocurrency payment transaction, including source and destination amounts, fees, exchange rates, and relevant timing information.

Show 16 properties

string

System-generated unique identifier of the resource.

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

senderCountry

string

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

Allowed valuesATBEBGBRCHCYCZDEDKEEESFIFRGBGRHKHRHUIEITLILTLUMTMXNGNLNOPLPTROSESISKUS

destinationCountry

string

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

Allowed valuesATBEBGBRCHCYCZDEDKEEESFIFRGBGRHKHRHUIEITLILTLUMTMXNGNLNOPLPTROSESISKUS

createDate

string

Date and time when the resource was created

quoteExpireDate

string

Date and time when the resource expires

cryptoFundsSettlementExpireDate

string

Date and time when the resource expires

sourceAmount

object

Represents an amount of cryptocurrency, including both the numerical amount and the specific cryptocurrency type.

Show 2 properties

amount

string

currency

string

Supported cryptocurrencies

Allowed valuesUSDC

destinationAmount

object

Represents an amount of money in a specific fiat currency, including both the numerical amount and the currency type.

Show 2 properties

amount

string

currency

string

Supported fiat currencies

Allowed valuesBRLEURGBPHKDMXNNGNUSD

fiatSettlementTime

object

Estimated time range for when funds will arrive at their destination after a transfer is initiated. The time varies depending on the fiat payment method used (e.g., ACH, SEPA, Wire). The time is represented as a range with minimum and maximum values in the specified unit.

Show 3 properties

max

string

min

string

unit

string

Allowed valuesMINUTESHOURSDAYSWEEKS

exchangeRate

object

Show 2 properties

pair

string

The currency pair in format cryptoCurrency/localFiatCurrency

rate

string

The exchange rate between source and destination currencies

fees

object

A collection of fees associated with a payment transaction, including both individual fee breakdowns and the total amount.

Show 2 properties

breakdown

array of objects

Detailed breakdown of individual fees that make up the total payment fees.

Show 2 properties

amount

object

Represents an amount of cryptocurrency, including both the numerical amount and the specific cryptocurrency type.

Show 2 properties

amount

string

currency

string

Supported cryptocurrencies

Allowed valuesUSDC

type

string

The type of fee being charged for the transaction.

Allowed valuesTAX_FEEBFI_TRANSACTION_FEE

totalAmount

object

Represents an amount of cryptocurrency, including both the numerical amount and the specific cryptocurrency type.

Show 2 properties

amount

string

currency

string

Supported cryptocurrencies

Allowed valuesUSDC

senderType

string

Type of entity sending or receiving the payment

Allowed valuesBUSINESSINDIVIDUAL

recipientType

string

Type of entity sending or receiving the payment

Allowed valuesBUSINESSINDIVIDUAL

certificate

object

Show 4 properties

string

System-generated unique identifier of the resource.

certPem

string

Base64 encoded certificate in PEM format

domain

string

BFI domain which is available in the CommonName attribute of the cert

jwk

object

The public key for the BFI defined in RFC 7517

Show 5 properties

crv

string

The curve used for the EC key

kid

string

Key ID

kty

string

Key type

string

X coordinate for the EC public key

string

Y coordinate for the EC public key

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

404NotFoundResponse

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    "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
4    "paymentMethodType": "SPEI",
5    "blockchain": "ETH-SEPOLIA",
6    "senderCountry": "MX",
7    "destinationCountry": "MX",
8    "createDate": "2023-01-01T12:04:05Z",
9    "quoteExpireDate": "2023-01-01T12:04:05Z",
10    "cryptoFundsSettlementExpireDate": "2023-01-01T12:04:05Z",
11    "sourceAmount": {
12      "amount": "110.27",
13      "currency": "USDC"
14    },
15    "destinationAmount": {
16      "amount": "11000.27",
17      "currency": "MXN"
18    },
19    "fiatSettlementTime": {
20      "max": "3",
21      "min": "1",
22      "unit": "DAYS"
23    },
24    "exchangeRate": {
25      "pair": "USDC/MXN",
26      "rate": "1.2345"
27    },
28    "fees": {
29      "breakdown": [
30        {
31          "amount": {
32            "amount": "110.27",
33            "currency": "USDC"
34          },
35          "type": "BFI_TRANSACTION_FEE"
36        }
37      ],
38      "totalAmount": {
39        "amount": "110.27",
40        "currency": "USDC"
41      }
42    },
43    "senderType": "BUSINESS",
44    "recipientType": "BUSINESS",
45    "certificate": {
46      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
47      "certPem": "LS0tLS1CRUdJT...",
48      "domain": "api.circle.com",
49      "jwk": {
50        "crv": "P-256",
51        "kid": "263521881931753643998528753619816524468853605762",
52        "kty": "EC",
53        "x": "KnxBe8fb2mL_Ve9-tqjGSkGgE9f0yohMkAvH_InaFtE",
54        "y": "D41cVUpiKcey4LJKNFtUtmVHDWRmhjZapPLfryX5b1o"
55      }
56    }
57  }
58}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy