Skip to main content
POST
/
api
/
v1
/
quotes
Create Quote
curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/quotes/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fromCurrency": "ARS",
  "toCurrency": "USDC",
  "fromAmount": "1500",
  "chain": "ETHEREUM_SEPOLIA",
  "paymentMethodType": "bank_transfer"
}
'
{
  "quoteId": "8142b065-79c4-4f48-9e33-11b17bc658d4",
  "fromCurrency": "ARS",
  "toCurrency": "USDC",
  "fromAmount": "1500.00000000",
  "finalFromAmount": "1400.00000000",
  "toAmount": "1.42857143",
  "finalToAmount": "1.32857143",
  "rate": "1050.00000000",
  "expiration": "2024-04-10T18:17:07.702533Z",
  "fees": [
    {
      "amount": "0.37",
      "type": "Gas Price",
      "currency": "ARS",
      "appliesOnFromAmount": true,
      "appliesOnToAmount": true
    }
  ]
}

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