Forex rates
Discover quoted currency pairs, then retrieve the daily exchange rates you need. Use single-pair routes for focused conversion and history workflows, or the batch route when you need the latest record for many pairs.
Choose a forex endpoint
Select a route based on whether you know the pair and how many dates or pairs you need.
| Goal | Endpoint | Result |
|---|---|---|
| Discover supported pair symbols | List forex pairs | A filterable pair catalog with base, quote, and synthetic status. |
| Retrieve a date range for one pair | List historical forex prices | Cursor-paginated daily OHLC rates. |
| Convert using the latest daily record | Retrieve the latest forex price | One unwrapped daily rate resource. |
| Refresh rates for many pairs | List all latest forex prices | A cursor-paginated pair-universe snapshot. |
Move from pair discovery to rates
Filter the pair catalog by base currency, quote currency, either-side currency,
or search text. Store the returned exchange-qualified symbol, then pass it to
a price route. Price identifiers also accept a bare code such as EURUSD or a
slash-separated code such as EUR/USD.
A rate is the price of one base-currency unit in quote-currency units. For
EURUSD, multiply a euro amount by close to convert it to US dollars. The
latest routes return daily records, not live streaming ticks, so inspect date
before using a quote.
Some pairs are synthetic because the rate is derived by crossing directly
quoted pairs. The pair resource marks them with is_synthetic; their price
resources otherwise use the same contract. Historical open, high, and
low values can be null, while close remains present.
Common use cases
Use forex resources for conversion, normalization, and rate research.
- Currency conversion. Convert financial values from a base currency into a
quote currency by multiplying the amount by the latest daily
close. - Exchange-rate charts. Chart daily history for one pair to show how its open, high, low, and closing rates change over a selected date range.
- Cross-currency normalization. Normalize company metrics into a common analysis currency before comparing businesses that report in different currencies.
- Rate-table refreshes. Refresh a local table of the latest daily rates for selected currencies without making one request for every pair.
- Synthetic-pair analysis. Compare directly quoted and synthetic pairs
through the same response shape while retaining their
is_syntheticstatus. - Complete pair snapshots. Preserve the full pair universe from the batch
feed, including rows whose quote fields are
nullinside the freshness window.
Plan and history access
The pair catalog and single-pair latest route are available on every plan. The
batch latest route requires an Individual or higher plan and retains pairs with
no quote in its 10-day freshness window by returning null quote fields. Your
plan controls the historical range available from the historical route.
Requests outside your plan's historical window return the standard permission error. v2 and v3 share the same plan and request-limit bucket.
Next steps
Discover a pair first, then choose a single-pair or batch price workflow.