Menu

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 · request headers
Authorization: Bearer YOUR_KEY
http · response headers
X-RateLimit-Remaining: 9999X-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/convertKonversi jumlah melalui GET tunggal atau POST batch.
GET /v1/rate/{slug}Respons datar untuk satu pasangan berdasarkan slug.
GET /v1/rangeDeret harian dengan pagination dan unduhan.
GET /v1/currenciesDaftar mata uang yang didukung tanpa parameter.
GET /v1/accountAkun, paket, key aktif, dan pemakaian bulan berjalan.
GET /v1/indices/{index_slug} · GET /v1/indices/{index_slug}/timeseriesNilai 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.

intervalPasangan unik
1m221
5m221
15m221
1h221
4h209
1d10296
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

API nilai tukar intrahari

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

PaketKoneksi serentakPasangan per koneksi
Free00
Basic00
Plus110
Pro3100
JSON
{"action":"auth","api_key":"YOUR_KEY"}
JSON
{"action":"subscribe","base":"EUR","symbols":["USD","JPY"]}

WebSocket live →

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 · 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 -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

Panduan integrasi: Python · JavaScript / Node.js · Google Sheets · Excel · Go · Swift · Zapier