# Currency Exchange Rate API

> USD-based exchange rates for about 160 currencies through a metered JSON API, with daily historical rates back to 1999. Any currency can be the base, and the same edition backs webhooks and a WebSocket stream. Current rates come from the newest edition for the key’s plan, and each plan sets how often that edition can change and how far back historical rates reach.

- About 160 currencies, quoted per 1 USD and available against any base currency in the edition.
- JSON REST API: `GET /latest` for rates, `GET /convert` for an amount, `GET /historical` for one past day, and `GET /timeseries` for up to 366 days. All need a bearer API key and count against a monthly quota.
- Daily historical rates back to 4 January 1999 for the currencies the European Central Bank publishes, and every currency for days recorded since launch. The free plan reaches back 30 days; Starter, Pro, and Business reach the full archive.
- `GET /currencies` and `GET /preview` are public and not metered.
- On paid plans, signed webhooks and a WebSocket stream push each new edition: Starter 1 webhook and 1 connection, Pro 3 and 3, Business 5 and 5. The free plan has neither.
- A free plan with no credit card. Paid plans update up to every 5 minutes.
- A remote MCP server (Streamable HTTP) at https://api.currencyexchangerate-api.com/api/v1/mcp lets AI assistants call the same data as tools: get_latest_rates, convert_currency, get_historical_rates, get_rates_timeseries, and list_currencies. Auth is the same bearer key, and the metered tools count one request each.
- Mid-market reference rates compiled from multiple central-bank and commercial sources, for pricing, invoicing, reporting, and display. Not suitable for trading or executing forex transactions.

Every public page has a Markdown version at its `.md` URL (the home page is /index.md), also served to requests that send `Accept: text/markdown`.

## Docs

- [API documentation](https://currencyexchangerate-api.com/docs.md): authentication, quotas, endpoints, errors, webhooks, and streaming
- [MCP server](https://currencyexchangerate-api.com/docs/mcp.md): connect Claude Code, Cursor, VS Code, or Windsurf to live and historical exchange rates
- [Full API reference](https://currencyexchangerate-api.com/llms-full.txt): every endpoint, parameter, and example in one Markdown file
- [OpenAPI 3.1 description](https://currencyexchangerate-api.com/openapi.json): the REST endpoints and webhooks, machine-readable
- [Postman collection](https://currencyexchangerate-api.com/postman-collection.json): every endpoint ready to run in Postman
- [Overview, plans, and quick start](https://currencyexchangerate-api.com/index.md)

## Integration guides

- [JavaScript and Node.js](https://currencyexchangerate-api.com/guides/javascript.md)
- [TypeScript](https://currencyexchangerate-api.com/guides/typescript.md)
- [Next.js App Router](https://currencyexchangerate-api.com/guides/nextjs.md)
- [React](https://currencyexchangerate-api.com/guides/react.md)
- [Express.js](https://currencyexchangerate-api.com/guides/express.md)
- [Python](https://currencyexchangerate-api.com/guides/python.md)
- [Django](https://currencyexchangerate-api.com/guides/django.md)
- [Flask](https://currencyexchangerate-api.com/guides/flask.md)
- [FastAPI](https://currencyexchangerate-api.com/guides/fastapi.md)
- [PHP](https://currencyexchangerate-api.com/guides/php.md)
- [Laravel](https://currencyexchangerate-api.com/guides/laravel.md)
- [Ruby on Rails](https://currencyexchangerate-api.com/guides/ruby-on-rails.md)
- [Go](https://currencyexchangerate-api.com/guides/go.md)
- [Java 17](https://currencyexchangerate-api.com/guides/java.md)
- [C# and .NET 8](https://currencyexchangerate-api.com/guides/csharp.md)
- [Google Sheets](https://currencyexchangerate-api.com/guides/google-sheets.md)

## Currencies

- [All currencies and exchange rates](https://currencyexchangerate-api.com/currencies.md): every code, name, symbol, and rate per 1 USD
- [USD to EUR exchange rate](https://currencyexchangerate-api.com/convert/usd-to-eur.md)
- [EUR to USD exchange rate](https://currencyexchangerate-api.com/convert/eur-to-usd.md)
- [USD to GBP exchange rate](https://currencyexchangerate-api.com/convert/usd-to-gbp.md)
- [GBP to USD exchange rate](https://currencyexchangerate-api.com/convert/gbp-to-usd.md)
- [EUR to GBP exchange rate](https://currencyexchangerate-api.com/convert/eur-to-gbp.md)
- [USD to JPY exchange rate](https://currencyexchangerate-api.com/convert/usd-to-jpy.md)
- [USD to INR exchange rate](https://currencyexchangerate-api.com/convert/usd-to-inr.md)
- [USD to CNY exchange rate](https://currencyexchangerate-api.com/convert/usd-to-cny.md)
- [USD to CAD exchange rate](https://currencyexchangerate-api.com/convert/usd-to-cad.md)
- [USD to AUD exchange rate](https://currencyexchangerate-api.com/convert/usd-to-aud.md)
- [USD to EGP exchange rate](https://currencyexchangerate-api.com/convert/usd-to-egp.md)
- [USD to AED exchange rate](https://currencyexchangerate-api.com/convert/usd-to-aed.md)
- Any other pair: https://currencyexchangerate-api.com/convert/{from}-to-{to}.md with lowercase ISO 4217 codes, such as https://currencyexchangerate-api.com/convert/gbp-to-inr.md

## Optional

- [Pricing and plans](https://currencyexchangerate-api.com/#pricing)
- [Open Exchange Rates alternative](https://currencyexchangerate-api.com/alternatives/open-exchange-rates): side-by-side comparison and switching guide
- [ExchangeRate-API alternative](https://currencyexchangerate-api.com/alternatives/exchangerate-api): side-by-side comparison and switching guide
- [API catalog (RFC 9727)](https://currencyexchangerate-api.com/.well-known/api-catalog)
- [MCP server card](https://currencyexchangerate-api.com/.well-known/mcp/server-card.json)
- [Terms of Service](https://currencyexchangerate-api.com/terms)
- [Privacy Policy](https://currencyexchangerate-api.com/privacy)
