---
title: "Exchange Rate API Quickstart"
description: "Make your first exchangerate.dev request in under a minute. Copy one curl command, read the JSON response, and add a free API key when you need account quota."
canonical: "https://exchangerate.dev/docs/quickstart"
---

# Exchange Rate API Quickstart

Make your first FX API call. Open a terminal and paste one command. You don't 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.

### curl

```bash
curl -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"
```

### Python

```python
from urllib.request import Request, urlopen
import json

# Identify your application explicitly when calling the API.
request = Request("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP", headers={"User-Agent": "exchangerate-docs/1.0"})
with urlopen(request, timeout=10) as response:
    data = json.load(response)

print(data["rates"]["EUR"])
```

### JavaScript / Node.js

```javascript
const response = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP", {
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data.rates.EUR);
```

Integration guides: [Python](https://exchangerate.dev/learn/python-exchange-rates) · [JavaScript / Node.js](https://exchangerate.dev/learn/javascript-currency-conversion) · [Google Sheets](https://exchangerate.dev/learn/google-sheets-exchange-rates) · [Excel](https://exchangerate.dev/learn/excel-exchange-rates) · [Go](https://exchangerate.dev/learn/go-exchange-rates) · [Swift](https://exchangerate.dev/learn/swift-exchange-rates) · [Zapier](https://exchangerate.dev/learn/zapier-exchange-rates)

## 2. Read the response

The response uses this JSON shape. The rates below are an example, so your numbers and timestamps will be different.

```json title="json · exact example"
{
  "result": "success",
  "base": "USD",
  "source": "live",
  "sources": {
    "EUR": "live",
    "GBP": "live"
  },
  "market_session": "open",
  "timestamp": "2026-06-15T12:00:00Z",
  "data_updated_at": "2026-06-15T12:00:00Z",
  "effective_at": {
    "EUR": "2026-06-15T12:00:00Z",
    "GBP": "2026-06-15T12:00:00Z"
  },
  "rates": {
    "EUR": 0.86207,
    "GBP": 0.74627
  },
  "stale": {
    "EUR": false,
    "GBP": false
  },
  "derived_symbols": [],
  "unavailable": [],
  "notice": "Indicative rates, not for settlement."
}
```

Use `rates.EUR` and `rates.GBP` in your code. If you show freshness to users, keep `source`, `market_session`, and `effective_at` for each displayed currency.

## 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 title="bash · authenticated"
curl "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"   -H "Authorization: Bearer YOUR_KEY"
```

[Get a free key](https://exchangerate.dev/signup), then replace `YOUR_KEY`. The `X-API-Key` header also works when a connector cannot set an Authorization header.

## Where to go next

- [Convert an amount](https://exchangerate.dev/docs/api-reference#convert) with a GET or batch POST request.
- [Pull historical data](https://exchangerate.dev/docs/historical) for one day or a date range.
- [Understand source and freshness](https://exchangerate.dev/docs/api-reference#source) before putting a rate in production.

**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.

Source: https://exchangerate.dev/docs/quickstart
