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": "pix"
}'
{
  "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.

Example:

"pix"

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