Skip to main content
The Get Quote endpoint returns a short-lived, locked exchange rate between a source and destination currency. You can use the returned quote_id when creating a payment or executing a conversion to guarantee that the displayed rate is the rate applied — protecting you from slippage during high-volatility periods. By default, the amount you provide is treated as the source currency amount, but you can set amount_type to destination if you need the recipient to receive a precise amount.
Quotes expire 30 seconds after creation. If you pass an expired quote_id to a downstream endpoint, you will receive a QUOTE_EXPIRED error and must request a new quote. Build your integration to account for this window and avoid pre-fetching quotes too early in your checkout or payment flow.

​
Request

​
from_currency
string
required
The source currency to convert from. Accepts supported stablecoin symbols (USDC, USDT, EURC, PYUSD) or fiat ISO 4217 codes.
​
to_currency
string
required
The target currency to convert into. Accepts supported stablecoin symbols or fiat ISO 4217 codes.
​
amount
number
required
The amount to convert. Interpreted as a from_currency amount when amount_type is source, or as a to_currency amount when amount_type is destination.
​
amount_type
string
Specifies which side of the conversion the amount refers to. Accepted values:
  • source (default) — amount is denominated in from_currency.
  • destination — amount is the exact amount the recipient should receive in to_currency. RemitFlex back-calculates the required source amount including fees.

​
Response

​
quote_id
string
Unique quote identifier with prefix qt_. Pass this to POST /payments or POST /conversions/execute to apply the locked rate.
​
from_currency
string
The source currency used in the quote.
​
to_currency
string
The target currency used in the quote.
​
amount
number
The source amount the quote is based on, denominated in from_currency.
​
converted_amount
number
The amount the recipient will receive in to_currency if this quote is executed, after fees are deducted.
​
exchange_rate
number
The locked mid-market conversion rate from from_currency to to_currency at the time this quote was created.
​
fee
number
The RemitFlex conversion fee, denominated in fee_currency.
​
fee_currency
string
The currency in which the fee is denominated.
​
expires_at
string
ISO 8601 timestamp indicating when this quote expires. Quotes are valid for 30 seconds from created_at.
​
created_at
string
ISO 8601 timestamp of when the quote was generated.

​
Examples

curl -X POST https://api.remitflex.com/v1/conversions/quote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_currency": "USDC",
    "to_currency": "EUR",
    "amount": 1000
  }'

{
  "quote_id": "qt_01HX9M2PABCDEF",
  "from_currency": "USDC",
  "to_currency": "EUR",
  "amount": 1000,
  "converted_amount": 922.50,
  "exchange_rate": 0.9225,
  "fee": 2.50,
  "fee_currency": "USDC",
  "expires_at": "2024-01-15T10:30:30Z",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Quoting for a Destination Amount

If you need the recipient to receive exactly 500 EUR, set amount_type to destination: 
curl -X POST https://api.remitflex.com/v1/conversions/quote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_currency": "USDC",
    "to_currency": "EUR",
    "amount": 500,
    "amount_type": "destination"
  }'