# freecurrencyapi

> freecurrencyapi provides free current and historical foreign exchange rates over a simple JSON REST API.

Authenticate every request with your API key via the `apikey` query parameter or request header. Base URL: https://api.freecurrencyapi.com

## Documentation
- [Introduction](https://freecurrencyapi.com/docs): freecurrencyapi provides free current and historical foreign exchange rates over a simple JSON REST API.
- [Currencies Endpoint](https://freecurrencyapi.com/docs/currencies): Returns all our supported currencies. The API supports 33 currencies — see the full [currency list](https://freecurrencyapi.com/docs/currency-list).
- [Currency List](https://freecurrencyapi.com/docs/currency-list)
- [Historical Exchange Rates](https://freecurrencyapi.com/docs/historical): Returns exchange rates for a single given date. We provide data going back to 1999-01-01, up to and including yesterday.
- [Latest Exchange Rates](https://freecurrencyapi.com/docs/latest): Returns the latest exchange rates. The default base currency is USD.
- [MCP Server](https://freecurrencyapi.com/docs/mcp): Connect AI agents to the freecurrencyapi API through our hosted MCP (Model Context Protocol) server.
- [Status Endpoint](https://freecurrencyapi.com/docs/status): Returns your current quota
- [Request Status Codes](https://freecurrencyapi.com/docs/status-codes): For all requests, we will return an HTTP status code that indicates a success or the problem that has led to the failure.

## API Reference
- [OpenAPI 3.1 specification](https://freecurrencyapi.com/docs/openapi.yaml): Machine-readable spec for every API endpoint, parameters and responses.
- [Full documentation as markdown](https://freecurrencyapi.com/docs/llms-full.txt): All documentation pages concatenated as plain markdown.

## Optional
- [Pricing & plans](https://freecurrencyapi.com/#pricing)