Docs /

Make your first FX API call

Open a terminal and paste one command. You do not need an API key to try the data endpoint.

1. Request two rates

This asks for the euro and British pound against the US dollar. Change the base in the path or the comma-separated symbols list to get different currencies.

bash · paste and run
curl "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

2. Read the response

You will get JSON in this shape. The rates below are an example, so your numbers and timestamps will be different.

json · trimmed example
{
  "result": "success",
  "base": "USD",
  "source": "live",
  "market_session": "open",
  "data_updated_at": "2026-08-05T09:41:00Z",
  "rates": {
    "EUR": 0.86,
    "GBP": 0.75
  },
  "derived_symbols": [],
  "notice": "Indicative rates, not for settlement."
}

Use rates.EUR and rates.GBP in your code. Keep source, market_session, and data_updated_at if you show freshness to users.

3. Add a key when you need account quota

Anonymous requests are for evaluation and are limited by IP. A free account gives you an account-attributed monthly quota. Keep the key on your server, not in public browser JavaScript.

bash · authenticated
curl "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"   -H "Authorization: Bearer YOUR_KEY"

Create a free key, then replace YOUR_KEY. The X-API-Key header also works when a connector cannot set an Authorization header.

Where to go next

Rates are indicative
Use the API for apps, dashboards, models, and analysis. It is not a dealing quote and should not be used to settle a trade or regulated transaction.