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.

Read more

Authentication

Learn how to authenticate with our API using HTTP headers or GET parameters.

Read more

Rate Limit & Quotas

Understand which endpoints count towards your monthly request quota and impact your rate limit.

Read more

Request Status Codes

Read about the different success & error status codes returned by the currencyapi API.

Read more

Endpoints

API Status

Learn how to programatically retrieve your API quota and check whether the API is up.

Supported Currencies

Learn which currencies can be queried with the currencyapi API.

Latest Exchange Rates

Learn how to retrieve the latest exchange rates for any given base currency.

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.

Convert Exchange Rates

Learn how to convert any value to a value of a different exchange rate.

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.