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.

GoalEndpointResult
Discover supported pair symbolsList forex pairsA filterable pair catalog with base, quote, and synthetic status.
Retrieve a date range for one pairList historical forex pricesCursor-paginated daily OHLC rates.
Convert using the latest daily recordRetrieve the latest forex priceOne unwrapped daily rate resource.
Refresh rates for many pairsList all latest forex pricesA 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_synthetic status.
  • Complete pair snapshots. Preserve the full pair universe from the batch feed, including rows whose quote fields are null inside 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.