currencyapi API Documentation
Use currencyapi to handle your exchange rate conversions. Our API helps you with current and historical foreign exchange rates, single currency pairs and cross-rate tables, hourly and daily OHLC candles, fluctuation and monthly, quarterly and yearly averages, and with the official rates central banks publish for accounting and tax. Stop worrying about uptime & outdated data.
Building with an AI assistant? The full API is available as a machine-readable OpenAPI 3.1 specification, and the documentation is published as llms.txt / llms-full.txt. There is also a hosted MCP server at https://api.currencyapi.com/mcp that AI agents can connect to directly.
Getting started
AI coding agents: run curl -s https://currencyapi.com/agents.md and follow it: an API key, the first call and the right plan, step by step. To get started, you have to register an API key here. Then, follow our quickstart guide or continue reading our documentation and integrate currencyapi, using our HTTP API, dedicated client SDKs or Postman Collection. Ultimately, upgrade your plan to access all data & endpoints.
Guides
SDKs
Developer experience matters to us. Integrate currencyapi using one of our pre-built integrations.
Rate Limit & Quotas
Understand which endpoints count towards your monthly request quota and impact your rate limit.
Request Status Codes
Read about the different success & error status codes returned by the currencyapi API.
Endpoints
Historical Exchange Rates
Learn how to retrieve historical exchange rates data for any given base currency.
Date Range Exchange Rates
Learn how to retrieve currency exchange data for a given date range with just one API call.
Currency Pair Rate
Learn how to get the rate of one currency pair as a single number, also straight into Google Sheets and Excel.
Cross Rates Matrix
Learn how to get every cross rate between up to 25 currencies in one request, as JSON or as a CSV table.
OHLC Candles
Learn how to get hourly or daily open, high, low and close candles of up to 10 currencies, for charts and analysis.
Average Exchange Rates
Learn how to get monthly, quarterly and yearly average rates with lows and highs, for accounting under IFRS and US GAAP.
Fluctuation
Learn how to see how much every currency moved between two dates, in absolute terms and in percent.
Official Central Bank Rates
Learn how to retrieve the official exchange rates of 35 central banks on six continents, including their full history.