Rates for currency pairs such as EUR/USD, GBP/USD and USD/JPY: the pair list, the latest rate for up to 25 pairs, 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 first currency in the second.

A pair is written `EUR/USD`; `EURUSD` and `EUR-USD` also work. Asked the other way round (`USD/EUR`), a tool answers with the listed pair and says 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. Official daily reference rates, such as the Federal Reserve's, are economic indicators: read them with `GetEconomicIndicator`.

Timing depends on the caller's plan. `GetForexQuote` reads real time on Pro and 15 minutes delayed on Plus. `GetForexIntradayPrices` returns a candle once it is stored on Pro, which is some minutes after it ends, and 15 minutes after it ends on Plus. On Free both answer with an upgrade note, and `GetForexPrices` returns each day 4 hours after it ends; Plus and Pro also get the day in progress.

## ListForexPairs

The currency pairs with rates, in pair order: the pair, both currencies by name, whether the pair still trades and the UTC day of its first stored trade. A pair that no longer trades keeps its history. Included on every plan.

**Parameters:** `currency` (optional: an ISO 4217 code such as `GBP`, to keep the pairs that include it as either currency), `maxResults` (default 100, max 500), `offset` (default 0).

**Ask:** *"Which currency pairs with the British pound do you have rates for?"*

**Returns:**

```
**Forex pairs** (price of one unit of the first currency in the second):

| Pair | Currencies | Trading | First trade |
|------|------------|---------|-------------|
| EUR/GBP | Euro in British pounds | yes | 2020-03-12 |
| GBP/USD | British pound in US dollars | yes | 2020-03-12 |
```

## GetForexQuote

The latest rate of up to 25 pairs: the last trade's rate and UTC time, the change against the rate 24 hours earlier, and the volume, high and low of the last 24 hours. Volume is in the first currency. A thinly traded pair's last trade can be hours old; its time is in the table. Letters that name no listed pair are named under the table, and a pair whose history is still loading has no rate yet.

Pro reads real time. Plus reads 15 minutes delayed: the answer is headed as delayed, shows no trade newer than 15 minutes, and gives the last trade's time to the minute. Free gets an upgrade note; daily candles are in `GetForexPrices`.

**Parameters:** `pairs` (required: up to 25 currency pairs, e.g. `GBP/USD`, `USD/JPY`, `USD/CAD`).

**Ask:** *"What are GBP/USD, USD/JPY and USD/CAD trading at?"*

**Returns:**

```
**Forex rates**:

| Pair | Rate | Last trade (UTC) | 24h change | 24h volume (first currency) | 24h high | 24h low |
|------|------|------------------|------------|-----------------------------|----------|---------|
| GBP/USD | 1.31236 | 2026-11-19 03:42:01 | -0.00711 (-0.54%) | 5380654.02551872 | 1.3197 | 1.31173 |
| USD/JPY | 160.019 | 2026-11-19 03:20:15 | -0.465 (-0.29%) | 3564.52074238 | 161 | 154 |
| USD/CAD | 1.43599 | 2026-11-19 03:42:01 | +0.00435 (+0.3%) | 1565607.62090007 | 1.43669 | 1.43046 |

_Rates are one exchange's trades, not an interbank or official reference rate (official daily rates are in GetEconomicIndicator), and the exchange trades through weekends._
```

## GetForexPrices

Daily candles for one pair, newest first: open, high, low and close in the second currency, volume in the first currency and trades. A day runs from midnight to midnight UTC, weekends included, and a day without trades has no row. History reaches back to the pair's first trade on the exchange, 2020 for most pairs.

Plus and Pro also get the day in progress as the newest row, with a note saying how far it was read. Free gets each day 4 hours after it ends. When older days exist beyond `maxResults`, the answer names the `endDate` that continues it.

**Parameters:** `pair` (required: a currency pair, e.g. `GBP/USD`), `startDate` / `endDate` (optional: UTC days as YYYY-MM-DD, default the pair's first trade through today), `maxResults` (default 60, max 500).

**Ask:** *"Show me GBP/USD's daily rates for the last three days."*

**Returns:**

```
**GBP/USD** daily candles in USD, UTC days, newest first:

| Day (UTC) | Open | High | Low | Close | Volume (GBP) | Trades |
|-----------|------|------|-----|-------|--------------|--------|
| 2026-11-19 | 1.31424 | 1.31496 | 1.31173 | 1.31249 | 730723.79528103 | 1,564 |
| 2026-11-18 | 1.32002 | 1.32042 | 1.31303 | 1.31424 | 5093356.34784723 | 17,175 |
| 2026-11-17 | 1.31772 | 1.33893 | 1.31628 | 1.32004 | 6796917.50180318 | 17,406 |

_The newest day is in progress, read up to 2026-11-19 03:37:31 UTC, so its figures still change. Rates are one exchange's trades, not an interbank or official reference rate (official daily rates are in GetEconomicIndicator), and the exchange trades through weekends. Stored days reach 2026-11-19 03:37:31 UTC. Older days exist; pass endDate 2026-11-16 to continue._
```

## GetForexIntradayPrices

Candles within the day for one pair, newest first, around the clock: open, high, low and close in the second currency, volume in the first currency and trades. `interval` is any whole number of minutes from `1min` to `240min`, or of hours from `1hour` to `4hour`, counted from midnight UTC. A period without trades has no row, and a candle is shown only once its period has ended.

The answer says how far the stored candles reach. When older candles exist beyond `maxResults`, it names the `endTime` that continues it. Plus gets a candle 15 minutes after it ends; Free gets an upgrade note.

**Parameters:** `pair` (required: a currency pair, e.g. `GBP/USD`), `interval` (optional: `1min`, the default, to `240min`, or `1hour` to `4hour`), `startDate` / `endDate` (optional: UTC days as YYYY-MM-DD, default the trailing 7 days, 30 for hourly intervals), `endTime` (optional: RFC 3339, replaces `endDate`), `maxResults` (default 60, max 500).

**Ask:** *"How has GBP/USD traded in 15-minute candles over the last 45 minutes?"*

**Returns:**

```
**GBP/USD** 15min candles in USD, newest first:

| Start (UTC) | Open | High | Low | Close | Volume (GBP) | Trades |
|-------------|------|------|-----|-------|--------------|--------|
| 2026-11-19 03:15 | 1.31176 | 1.31267 | 1.31176 | 1.31267 | 27400.14435347 | 67 |
| 2026-11-19 03:00 | 1.3127 | 1.3127 | 1.31173 | 1.31176 | 24146.11902467 | 76 |
| 2026-11-19 02:45 | 1.31354 | 1.31356 | 1.31269 | 1.31269 | 215568.71772042 | 96 |

_Rates are one exchange's trades, not an interbank or official reference rate (official daily rates are in GetEconomicIndicator), and the exchange trades through weekends. Stored candles reach 2026-11-19 03:37:31 UTC. Older candles exist in this window; pass endTime 2026-11-19T02:45:00Z in place of endDate, with startDate 2026-11-12, to continue._
```