Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ratiofx.com/llms.txt

Use this file to discover all available pages before exploring further.

An indicative quote returns a reference price for a currency pair. It does not reserve inventory and has no expiry. Use it to show your users an approximate rate before they decide to execute a transfer.

​
When to use

  • Display approximate FX rates in your UI
  • Let users preview the cost of a transfer before confirming
  • Power rate comparison or calculator features
  • Run pre-flight checks before requesting a firm quote

​
Request

GET /v1/quote
​
pair
string
required
Currency pair to price. Supported values: USD-IDR, USD-SGD, MYR-IDR.
​
side
string
required
Trade direction from the base currency perspective. BUY or SELL.
​
amount
number
required
Notional amount in the source currency.

​
Example request

curl -X GET "https://api.ratiofx.com/v1/quote?pair=USD-IDR&side=BUY&amount=10000" \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "X-Partner-ID: partner_uuid_xyz"

​
Response

{
  "pair": "USD-IDR",
  "side": "BUY",
  "indicative_rate": 16020.50,
  "mid": 15980.00,
  "spread_bps": 25,
  "timestamp": "2026-02-27T10:00:00Z",
  "quote_type": "INDICATIVE"
}

​
Response fields

​
pair
string
Currency pair.
​
side
string
Trade direction.
​
indicative_rate
number
Reference rate. This rate is not executable — it is for display only.
​
mid
number
Oracle mid-market rate.
​
spread_bps
number
Approximate total spread in basis points. The actual spread on a firm quote may differ based on real-time market conditions.
​
timestamp
string
ISO 8601 timestamp of the quote.
​
quote_type
string
Always INDICATIVE for this endpoint.

​
Important notes

Indicative quotes are not executable. They provide a reference price only. To commit to a trade, you must request a firm quote.
Rates can change between an indicative quote and a subsequent firm quote, especially during volatile markets. Do not surface the indicative rate as a guaranteed price.
Avoid polling this endpoint more frequently than once per second per corridor. Indicative quotes are not rate-limited more aggressively than other endpoints, but excessive polling wastes quota.

​
Next step

Once your user is ready to execute, request a firm quote to lock an executable rate. Request a firm quote →