Skip to main content
Press ⌘K to search

Rates for currency pairs such as EUR/USD, GBP/USD and USD/JPY: the pair list, the latest rate for one pair or up to 25, daily candles back to each pair's first trade, and candles within the day down to one minute. A rate is the price of one unit of the base currency in the quote currency.

A pair is named by its two ISO 4217 codes without the slash, EURUSD, or with a dash, EUR-USD. Asked the other way round (USDEUR), an endpoint answers with the listed pair and adds a note to notice saying the rate is not inverted: there are no computed inverses or cross rates.

Rates are one crypto exchange's trades, not an interbank or official reference rate. They can sit a few pips from the interbank market, a thinly traded pair (USD/JPY trades a few dozen times a day) can sit much further, and a day's high or low can hold a stray trade far from the market. The exchange trades through weekends, so every day and candle is on UTC and weekends have candles too. Every quote and candle answer carries this in notice. Official daily reference rates, such as the Federal Reserve's, are economic series: see series observations.

Timing depends on the caller's plan:

Endpoints Free Plus Pro
/v1/forex Included Included Included
/v1/forex/{pair}/quote, /v1/forex/quotes Unavailable (403) 15 minutes delayed Real time
/v1/forex/{pair}/prices Each day 4 hours after it ends Also the day in progress, 15 minutes delayed Also the day in progress, as far as it is stored
/v1/forex/{pair}/bars Unavailable (403) Each candle 15 minutes after it ends Each candle once it is stored

Candles are built from stored trades, which are added some minutes after they happen. storedThrough says how far a pair's stored trades reach and through how far the caller's plan reads them. The quote is the only real-time reading.

Forex pair list

GET /v1/forex

The currency pairs with rates, in pair order, with both currencies' ISO codes and English names. active is false once a pair no longer trades on the exchange; its history still answers. firstTradeDate is the UTC day of the pair's first stored trade, and null while none is stored. Included on every plan.

Parameters: currency (keep the pairs that include this ISO 4217 code as base or quote, e.g. GBP); limit (default 100, max 500); offset.

curl "https://api.equibles.com/v1/forex?currency=GBP" \
  -H "Authorization: Bearer eq_your_api_key"
import requests
r = requests.get(
    "https://api.equibles.com/v1/forex",
    params={"currency": "GBP"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
const res = await fetch("https://api.equibles.com/v1/forex?currency=GBP", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
{
  "data": [
    { "pair": "EUR/GBP", "baseCurrency": "EUR", "baseCurrencyName": "Euro", "quoteCurrency": "GBP", "quoteCurrencyName": "British Pound", "active": true, "firstTradeDate": "2020-03-12" },
    { "pair": "GBP/USD", "baseCurrency": "GBP", "baseCurrencyName": "British Pound", "quoteCurrency": "USD", "quoteCurrencyName": "US Dollar", "active": true, "firstTradeDate": "2020-03-12" }
  ],
  "meta": { "limit": 100, "offset": 0, "count": 2, "hasMore": false }
}

Forex quote

GET /v1/forex/{pair}/quote

The latest rate of one pair: the last trade's price and tradeTime, the change and changePercent against the last trade price 24 hours before asOf, and the volume, high, low and trade count of the 24 hours ending at dayThrough. dayVolume is in the base currency. asOf is the instant the reading stands for: no newer trade is known up to it.

stale is true only when the reading may be missing recent trades. A thinly traded pair is never stale for being quiet: read tradeTime to see how old its last trade is.

Needs a paid plan. Pro reads real time. Plus reads 15 minutes delayed (delayed: true): it shows no trade newer than 15 minutes, and tradeTime is the start of the minute that trade printed in. Free is refused with 403 and reads daily candles at /v1/forex/{pair}/prices. Letters that name no listed pair return 404, as does a pair whose history is still loading and has no rate yet.

Parameters: {pair} (currency pair such as GBPUSD, or GBP-USD).

curl "https://api.equibles.com/v1/forex/GBPUSD/quote" \
  -H "Authorization: Bearer eq_your_api_key"
import requests
r = requests.get(
    "https://api.equibles.com/v1/forex/GBPUSD/quote",
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
const res = await fetch("https://api.equibles.com/v1/forex/GBPUSD/quote", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
{
  "pair": "GBP/USD",
  "baseCurrency": "GBP",
  "quoteCurrency": "USD",
  "price": 1.31236,
  "tradeTime": "2026-11-19T03:42:01.264858+00:00",
  "asOf": "2026-11-19T03:42:09.363835+00:00",
  "delayed": false,
  "stale": false,
  "change": -0.00711,
  "changePercent": -0.54,
  "dayVolume": 5380654.02551872,
  "dayHigh": 1.3197,
  "dayLow": 1.31173,
  "dayTradeCount": 16993,
  "dayThrough": "2026-11-19T03:37:31.5983+00:00",
  "notice": "Rates are one exchange's trades, not an interbank or official reference rate, and the exchange trades through weekends."
}

Forex quotes for several pairs

GET /v1/forex/quotes

The same reading for up to 25 pairs in one call, in the order asked; a pair asked twice, or both ways round, answers once. Letters that name no listed pair fail the call with 400 and are named in the message. A pair whose history is still loading has no rate yet and is left out. The plan rules are the quote's.

Parameters: pairs (comma-separated currency pairs, max 25, e.g. GBPUSD,USDJPY; GBP/USD and GBP-USD also work).

curl "https://api.equibles.com/v1/forex/quotes?pairs=GBPUSD,USDJPY" \
  -H "Authorization: Bearer eq_your_api_key"
import requests
r = requests.get(
    "https://api.equibles.com/v1/forex/quotes",
    params={"pairs": "GBPUSD,USDJPY"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
const res = await fetch("https://api.equibles.com/v1/forex/quotes?pairs=GBPUSD,USDJPY", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
{
  "data": [
    {
      "pair": "GBP/USD",
      "baseCurrency": "GBP",
      "quoteCurrency": "USD",
      "price": 1.31236,
      "tradeTime": "2026-11-19T03:42:01.264858+00:00",
      "asOf": "2026-11-19T03:42:09.439771+00:00",
      "delayed": false,
      "stale": false,
      "change": -0.00711,
      "changePercent": -0.54,
      "dayVolume": 5380654.02551872,
      "dayHigh": 1.3197,
      "dayLow": 1.31173,
      "dayTradeCount": 16993,
      "dayThrough": "2026-11-19T03:37:31.5983+00:00",
      "notice": "Rates are one exchange's trades, not an interbank or official reference rate, and the exchange trades through weekends."
    },
    {
      "pair": "USD/JPY",
      "baseCurrency": "USD",
      "quoteCurrency": "JPY",
      "price": 160.019,
      "tradeTime": "2026-11-19T03:20:15.17366+00:00",
      "asOf": "2026-11-19T03:42:09.439771+00:00",
      "delayed": false,
      "stale": false,
      "change": -0.465,
      "changePercent": -0.29,
      "dayVolume": 3564.52074238,
      "dayHigh": 161.0,
      "dayLow": 154.0,
      "dayTradeCount": 41,
      "dayThrough": "2026-11-19T03:37:50.998284+00:00",
      "notice": "Rates are one exchange's trades, not an interbank or official reference rate, and the exchange trades through weekends."
    }
  ]
}

Daily forex candles

GET /v1/forex/{pair}/prices

Daily candles for one pair, newest first: open, high, low and close in the quote currency, volume in the base currency and tradeCount. A day runs from midnight to midnight UTC, weekends included, and time is its first instant. A day without trades has no candle, so a gap means no trades. History reaches back to the pair's first trade on the exchange, 2020 for most pairs.

Plus and Pro also receive the day in progress as the newest candle: forming is true, and its figures are read up to through and still change. Free reads a day 4 hours after it ends and never the day in progress; notice says so.

limit cuts the oldest days. When truncated is true, pass the day before the oldest candle as endDate to continue.

Parameters: {pair} (currency pair such as GBPUSD, or GBP-USD); startDate / endDate (yyyy-MM-dd UTC days, default the pair's first trade through today); limit (default 250, max 500).

curl "https://api.equibles.com/v1/forex/GBPUSD/prices?limit=3" \
  -H "Authorization: Bearer eq_your_api_key"
import requests
r = requests.get(
    "https://api.equibles.com/v1/forex/GBPUSD/prices",
    params={ "limit": "3"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
const res = await fetch("https://api.equibles.com/v1/forex/GBPUSD/prices?limit=3", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
{
  "pair": "GBP/USD",
  "baseCurrency": "GBP",
  "quoteCurrency": "USD",
  "interval": "1day",
  "returned": 3,
  "truncated": true,
  "delayed": false,
  "forming": true,
  "storedThrough": "2026-11-19T03:37:31.5983+00:00",
  "through": "2026-11-19T03:37:31.5983+00:00",
  "notice": "Rates are one exchange's trades, not an interbank or official reference rate, and the exchange trades through weekends.",
  "candles": [
    {
      "time": "2026-11-19T00:00:00+00:00",
      "open": 1.31424,
      "high": 1.31496,
      "low": 1.31173,
      "close": 1.31249,
      "volume": 730723.79528103,
      "tradeCount": 1564
    },
    {
      "time": "2026-11-18T00:00:00+00:00",
      "open": 1.32002,
      "high": 1.32042,
      "low": 1.31303,
      "close": 1.31424,
      "volume": 5093356.34784723,
      "tradeCount": 17175
    },
    {
      "time": "2026-11-17T00:00:00+00:00",
      "open": 1.31772,
      "high": 1.33893,
      "low": 1.31628,
      "close": 1.32004,
      "volume": 6796917.50180318,
      "tradeCount": 17406
    }
  ]
}

Intraday forex candles

GET /v1/forex/{pair}/bars

Candles within the day for one pair, newest first, around the clock. interval is any whole number of minutes from 1min (default) to 240min, such as 5min or 15min, or a whole number of hours from 1hour to 4hour, counted from midnight UTC. A period without trades has no candle. A candle is returned only once its period has ended, so forming is always false here and no figure changes later.

The newest candles come first and limit cuts the oldest. When truncated is true, pass the oldest candle's time as endTime to continue; it returns only candles that start before it, so none repeats. Keep startDate on the continuing request: without it the default window slides back with endTime.

Needs a paid plan. Plus receives each candle 15 minutes after it ends (delayed: true). Pro receives each candle once it is stored. Free is refused with 403 and reads daily candles at /v1/forex/{pair}/prices.

Parameters: {pair} (currency pair such as GBPUSD, or GBP-USD); interval (default 1min); startDate / endDate (yyyy-MM-dd UTC days, default the trailing 7 days through now, 30 days for the hourly intervals); endTime (RFC 3339, replaces endDate); limit (default 250, max 500).

curl "https://api.equibles.com/v1/forex/GBPUSD/bars?interval=15min&limit=3" \
  -H "Authorization: Bearer eq_your_api_key"
import requests
r = requests.get(
    "https://api.equibles.com/v1/forex/GBPUSD/bars",
    params={"interval": "15min", "limit": "3"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
const res = await fetch("https://api.equibles.com/v1/forex/GBPUSD/bars?interval=15min&limit=3", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());

The three newest 15-minute candles at 03:42 UTC on 2026-11-19:

{
  "pair": "GBP/USD",
  "baseCurrency": "GBP",
  "quoteCurrency": "USD",
  "interval": "15min",
  "returned": 3,
  "truncated": true,
  "delayed": false,
  "forming": false,
  "storedThrough": "2026-11-19T03:37:31.5983+00:00",
  "through": "2026-11-19T03:37:31.5983+00:00",
  "notice": "Rates are one exchange's trades, not an interbank or official reference rate, and the exchange trades through weekends.",
  "candles": [
    {
      "time": "2026-11-19T03:15:00+00:00",
      "open": 1.31176,
      "high": 1.31267,
      "low": 1.31176,
      "close": 1.31267,
      "volume": 27400.14435347,
      "tradeCount": 67
    },
    {
      "time": "2026-11-19T03:00:00+00:00",
      "open": 1.3127,
      "high": 1.3127,
      "low": 1.31173,
      "close": 1.31176,
      "volume": 24146.11902467,
      "tradeCount": 76
    },
    {
      "time": "2026-11-19T02:45:00+00:00",
      "open": 1.31354,
      "high": 1.31356,
      "low": 1.31269,
      "close": 1.31269,
      "volume": 215568.71772042,
      "tradeCount": 96
    }
  ]
}

Try it with a real key

Every example on this page runs against the live API. A free account includes an API key and MCP access — set up in under a minute.