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).
Authorization: Bearer YOUR_KEYX-RateLimit-Remaining: 9999X-RateLimit-Reset: 1788220800Field 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 |
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.
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 |
{"action":"auth","api_key":"YOUR_KEY"}{"action":"subscribe","base":"EUR","symbols":["USD","JPY"]}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.
{ "result": "error", "code": "missing_parameter", "message": "required parameter missing: symbols"}{ "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 -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"from urllib.request import Request, urlopenimport 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"])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 · JavaScript / Node.js · Google Sheets · Excel · Go · Swift · Zapier