---
title: "Referensi API | exchangerate.dev"
description: "Referensi REST exchangerate.dev: autentikasi dengan API key, batas penggunaan anonim, field kesegaran data, endpoint utama, dan format error yang seragam."
canonical: "https://exchangerate.dev/id/docs/api-reference"
---

# Referensi API

Ringkasan REST untuk autentikasi, batas, field kesegaran, endpoint, dan error.

## Autentikasi dan batas

Endpoint data menerima percobaan anonim: 10 permintaan per menit dan 100 per jam untuk setiap IP. Key menggunakan kuota bulanan akun Anda. Harga Free terlambat 15 menit (header X-Price-Delay-Seconds: 900).

```http title="http · request headers"
Authorization: Bearer YOUR_KEY
```

http · response headers

```
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1788220800
```

## Field yang menjelaskan kesegaran

`source` menunjukkan kelas sumber, `market_session` menunjukkan keadaan pasar, dan `data_updated_at` menunjukkan waktu observasi tertua yang menyumbang pada respons. Simpan ketiganya.

## Endpoint

- GET /v1/latest[/{BASE}]: Nilai tukar terkini, seluruhnya atau disaring dengan symbols.
- GET /v1/{YYYY-MM-DD}[/{BASE}]: Snapshot historis untuk satu tanggal dan mata uang dasar.
- GET /v1/convert/{FROM}/{TO}[/{AMOUNT}] · POST /v1/convert: Konversi jumlah melalui GET tunggal atau POST batch.
- GET /v1/rate/{slug}: Respons datar untuk satu pasangan berdasarkan slug.
- GET /v1/range: Deret harian dengan pagination dan unduhan.
- GET /v1/currencies: Daftar mata uang yang didukung tanpa parameter.
- GET /v1/account: Akun, paket, key aktif, dan pemakaian bulan berjalan.
- GET /v1/indices/{index_slug} · GET /v1/indices/{index_slug}/timeseries: Nilai indeks USD terbaru dan deret historisnya.

## Deret intraday dan cakupan

/v1/timeseries mendukung 1m, 5m, 15m, 1h, 4h dan referensi harian 1d; tidak ada 2h. Pasangan silang SGD tanpa USD tidak mendukung 4h, tetapi USD/SGD dan kebalikannya didukung. Data pasar mulai dikumpulkan pada 2026-09-14. Retensi 1m adalah 30 hari; interval lebih besar tidak memiliki kedaluwarsa terjadwal. Retensi bukan jaminan kedalaman data yang sudah tersedia. Cakupan intraday 1m hingga 1h: 221 pasangan unik, yaitu 143 pasangan USD dan 78 pasangan silang.

Pasangan silang historis memerlukan tick penutupan nyata dalam bucket UTC yang sama, dengan selisih maksimal 5 detik. effective_at memakai waktu observasi tertua. Celah tidak diisi; bucket yang masih terbuka dapat berubah. 1d menggunakan referensi harian untuk seluruh katalog. Tabel menghitung pasangan unik; kedua arah didukung.

| interval | Pasangan unik |
| --- | --- |
| `1m` | 221 |
| `5m` | 221 |
| `15m` | 221 |
| `1h` | 221 |
| `4h` | 209 |
| `1d` | 10296 |

```bash title="curl · Pro · EUR/JPY · 15m"
curl "https://api.exchangerate.dev/v1/timeseries?base=EUR&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T13:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Rentang yang didukung tanpa observasi mengembalikan HTTP 200 dengan data: [], has_more: false dan next_cursor: null. Interval tidak dikenal menghasilkan unsupported_interval; pasangan di luar cakupan menghasilkan unsupported_pair_interval dan rejected_pairs (HTTP 400). Permintaan campuran ditolak seluruhnya.

[Rincian cakupan dan batas](https://exchangerate.dev/id/docs/api-reference#timeseries)

[API nilai tukar intrahari](https://exchangerate.dev/id/intraday-exchange-rate-api)

## WebSocket live

Hubungkan ke wss://api.exchangerate.dev/v1/stream dan kirim pesan auth dalam 10 detik. Simpan API key di server, bukan URL atau JavaScript publik. Koneksi anonim tidak didukung. Setelah authenticated, kirim subscribe. Stream memakai mata uang di bawah; silang memerlukan kedua observasi terbaru masih segar dan berselisih maksimal 5 detik. Nilai dapat berstatus unavailable atau stale. Setiap koneksi yang diterima memakai satu unit kuota bulanan.

Tabel: batas akun baru. Akun lama tetap mendapat paket lama Basic 3 × 25 atau Pro 10 × 100 (koneksi × pasangan per koneksi). Pesan authenticated menunjukkan batas efektif akun Anda.

`AUD, CAD, CHF, EUR, GBP, JPY, MXN, NOK, NZD, PLN, SEK, SGD, USD, ZAR`

| Paket | Koneksi serentak | Pasangan per koneksi |
| --- | --- | --- |
| Free | 0 | 0 |
| Basic | 0 | 0 |
| Plus | 1 | 10 |
| Pro | 3 | 100 |

```json
{"action":"auth","api_key":"YOUR_KEY"}
```

```json
{"action":"subscribe","base":"EUR","symbols":["USD","JPY"]}
```

[WebSocket live →](https://exchangerate.dev/id/websocket-exchange-rate-api)

## Error

REST: Semua error memakai bentuk `{ result: "error", code, message }`. Respons 429 menyertakan `Retry-After`; kegagalan sumber tidak diganti dengan data buatan. HTTP 403 `plan_gated` menyertakan `tier`, `interval`; penolakan kedalaman riwayat juga menyertakan `history_days`, `earliest_allowed`. Jika ada upgrade yang memungkinkan permintaan, respons menyertakan `upgrade_plans`, `upgrade_offers` (`plan`, `loses`) و`upgrade_url`.

```json
{
  "result": "error",
  "code": "missing_parameter",
  "message": "required parameter missing: symbols"
}
```

```json title="json · 403 plan_gated"
{
  "result": "error",
  "code": "plan_gated",
  "message": "The 15m interval is not included in your plan.",
  "tier": "plus_2026",
  "interval": "15m",
  "upgrade_plans": ["pro_2026"],
  "upgrade_offers": [{ "plan": "pro_2026", "loses": [] }],
  "upgrade_url": "https://exchangerate.dev/pricing?plan=pro_2026&source=api&reason=plan_gated"
}
```

### 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);
```

Panduan integrasi: [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/id/learn/go-exchange-rates) · [Swift](https://exchangerate.dev/id/learn/swift-exchange-rates) · [Zapier](https://exchangerate.dev/id/learn/zapier-exchange-rates)

Source: https://exchangerate.dev/id/docs/api-reference
