Skip to main content
POST
Create Quote

Authorizations

Authorization
string
header
required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Body

application/json

Details for the quote request.

fromCurrency
string
required

The source currency for the conversion.

Example:

"ARS"

toCurrency
string
required

The target currency for the conversion.

Example:

"USDC"

fromAmount
string
required

The amount of the source currency to be converted.

Example:

"1500"

chain
string
required

The blockchain network to be used for the conversion (applicable for certain cryptocurrencies).

Example:

"ETHEREUM_SEPOLIA"

paymentMethodType
string
required

The desired payment method for the conversion (e.g., bank_transfer, breb, r2p_bancolombia, r2p_nequi). Note: breb, r2p_bancolombia and r2p_nequi are only available for Colombia. Additionally, r2p_bancolombia and r2p_nequi are only available for on-ramp operations.

Example:

"bank_transfer"

Response

Quote created successfully.

quoteId
string<uuid>
required

Unique identifier for the quote.

Example:

"8142b065-79c4-4f48-9e33-11b17bc658d4"

fromCurrency
string
required

The source currency for the conversion.

Example:

"ARS"

toCurrency
string
required

The target currency for the conversion.

Example:

"USDC"

fromAmount
string
required

The amount of the source currency to be converted.

Example:

"1500.00000000"

finalFromAmount
string
required

The amount of the source currency after fees deduction.

Example:

"1400.00000000"

toAmount
string
required

The amount of the target currency received after the conversion.

Example:

"1.42857143"

finalToAmount
string
required

The amount of the target currency after fees deduction.

Example:

"1.32857143"

rate
string
required

The exchange rate applied for the conversion.

Example:

"1050.00000000"

expiration
string<date-time>
required

The date and time when the quote expires (UTC).

Example:

"2024-04-10T18:17:07.702533Z"

fees
object[]
required