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](/docs/api/endpoints/economic#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`.

```bash
curl "https://api.equibles.com/v1/forex?currency=GBP" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
import requests
r = requests.get(
    "https://api.equibles.com/v1/forex",
    params={"currency": "GBP"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
```

```javascript
const res = await fetch("https://api.equibles.com/v1/forex?currency=GBP", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
```

```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`).

```bash
curl "https://api.equibles.com/v1/forex/GBPUSD/quote" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
import requests
r = requests.get(
    "https://api.equibles.com/v1/forex/GBPUSD/quote",
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
```

```javascript
const res = await fetch("https://api.equibles.com/v1/forex/GBPUSD/quote", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
```

```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).

```bash
curl "https://api.equibles.com/v1/forex/quotes?pairs=GBPUSD,USDJPY" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
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())
```

```javascript
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());
```

```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).

```bash
curl "https://api.equibles.com/v1/forex/GBPUSD/prices?limit=3" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
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())
```

```javascript
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());
```

```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).

```bash
curl "https://api.equibles.com/v1/forex/GBPUSD/bars?interval=15min&limit=3" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
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())
```

```javascript
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:

```json
{
  "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
    }
  ]
}
```