NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Exchange Rate API

The Exchange Rate API provides exchange rates on global currencies. Choose from hundreds of different currency pairs.

Available endpoints:

Premium members have access to live prices, while free users only have access to 15-minute delayed data.

Supported Currencies ▶
(4.3)

From 3,186 users

4,200+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
313ms353ms409ms622ms986ms

Didn't find what you were looking for? Suggest an improvement

/v1/exchangerate GET

https://api.api-ninjas.com/v1/exchangerate

Returns the exchange rate for a given currency pair. Premium members have access to live prices, while free users only have access to 15-minute delayed data.

Parameters

  • pair  required

    Currency pair to query. Must be in the form of currency1_currency2 (e.g. USD_EUR).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • rate

    The exchange rate for the given currency pair.

  • timestamp

    Unix timestamp (in seconds) indicating the time at which the exchange rate was applied.

Sample Request Live Demo!

pair

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/exchangerate?pair=GBP_AUD

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
{
    currency_pair:"GBP_AUD",
    exchange_rate:1.88194,
    timestamp:1777407695
}

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/exchangerate?pair=GBP_AUD" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

/v1/exchangeratehistorical GETPremium Only

https://api.api-ninjas.com/v1/exchangeratehistorical

Returns daily historical exchange rates for a given currency pair. Data is available back to January 1, 2001 for most currency pairs.

Parameters

  • pair  required

    Currency pair to query. Must be in the form of currency1_currency2 (e.g. USD_EUR).

  • date  optional

    Single date to query, in YYYY-MM-DD format. Either date OR both start_date and end_date must be provided.

  • start_date  optional

    Start date of a range query, in YYYY-MM-DD format. Must be used together with end_date.

  • end_date  optional

    End date of a range query, in YYYY-MM-DD format. Date range cannot exceed 366 days.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects with the following fields, or an error if the request is unsuccessful. A single-date query returns an array of exactly one object.

  • pair

    The requested currency pair.

  • date

    Date of the rate, in YYYY-MM-DD format.

  • rate

    The exchange rate for the given currency pair on the given date.

Sample Historical Request Live Demo!

pair
date
start_date
end_date

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/exchangeratehistorical?pair=USD_EUR&date=2020-03-15

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      pair:"USD_EUR",
      date:"2020-03-15",
      rate:0.896585
    }
]

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Exchange Rate API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Send a GET request to the /v1/exchangerate endpoint with the required pair parameter formatted as currency1_currency2 (for example GBP_AUD or USD_EUR), and the response returns a rate value along with a timestamp. You can browse all available endpoints and supported currencies on this page.
  • Yes, the premium-only /v1/exchangeratehistorical endpoint returns daily historical rates back to January 1, 2001 for most pairs; query a single day with the date parameter or a span using start_date and end_date (in YYYY-MM-DD format, with a range no longer than 366 days). Historical access requires a paid plan, which you can review on the pricing page.
  • The API covers hundreds of currency pairs across global currencies, with premium members receiving live prices and free users receiving 15-minute delayed data; see the pricing page for the difference between free and premium access. For deriving converted amounts you can pair this with the Convert Currency API.
  • Use it to display live FX quotes, build pricing or checkout flows in multiple currencies, or backtest strategies using the daily history from the /v1/exchangeratehistorical endpoint. For related financial analysis you may also find the Currency Volatility and Interest Rate APIs useful.