Indicative Quotes

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

string

required

Currency pair to price. Supported values: USD-IDR, USD-SGD, MYR-IDR.

string

required

Trade direction from the base currency perspective. BUY or SELL.

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"

const response = await fetch(
  "https://api.ratiofx.com/v1/quote?pair=USD-IDR&side=BUY&amount=10000",
  {
    headers: {
      "Authorization": "Bearer sk_live_abc123...",
      "X-Partner-ID": "partner_uuid_xyz",
    },
  }
);
const quote = await response.json();

import requests

response = requests.get(
    "https://api.ratiofx.com/v1/quote",
    params={"pair": "USD-IDR", "side": "BUY", "amount": 10000},
    headers={
        "Authorization": "Bearer sk_live_abc123...",
        "X-Partner-ID": "partner_uuid_xyz",
    },
)
quote = response.json()

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

string

Currency pair.

string

Trade direction.

number

Reference rate. This rate is not executable — it is for display only.

number

Oracle mid-market rate.

number

Approximate total spread in basis points. The actual spread on a firm quote may differ based on real-time market conditions.

string

ISO 8601 timestamp of the quote.

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 →

Get Started

Features

Architecture

Integration

Partners

Resources

Indicative Quotes

When to use

Request

Example request

Response

Response fields

Important notes

Next step

​When to use

​Request

​Example request

​Response

​Response fields

​Important notes

​Next step

When to use

Request

Example request

Response

Response fields

Important notes

Next step