> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usepatchwork.co/llms.txt
> Use this file to discover all available pages before exploring further.

# FX rates

> Live and historical exchange rates across currencies and corridors.

<Note>
  Coming soon. The API is not live. This page is the product shape so you can plan against it.
</Note>

`fx-rates` is a workbench tool: a bare REST call that returns the mid-market rate and the spread you would actually get, for a currency pair or a corridor.

Same two-door rule as Identify. Call it with an API key from your code. Wire it into an agent as a patch when the catalog binding ships.

## What it will do

* Live rate for a pair (`USD/GHS`, `EUR/NGN`, …)
* Historical rate at a timestamp
* Corridor metadata — the spread you would actually get, not only mid-market

## What it will not do

It will not move money, hold balances, or execute a conversion. It prices. Your rails convert.

The reference page will appear under [API Reference → FX rates](/api-reference/fx-rates) when the endpoint ships.