DokumentasiDokumentasi

API nilai tukar dengan kurs IDR

Kurs terkini, riwayat, dan konversi tersedia mulai dari paket gratis

8 November 2026 · 2 menit baca

exchangerate.dev adalah REST API untuk kurs mata uang. Gunakan /v1/latest/{BASE} untuk kurs terkini IDR terhadap dolar, atau pilih tanggal untuk riwayatnya. Paket Free mencakup 5.000 permintaan per bulan. Semua permintaan di bawah bisa dicoba tanpa API key.

Isi respons API

Setiap endpoint mengembalikan JSON lewat HTTPS. Tabel berikut merangkum hasil tiap endpoint dan paket minimum yang mendukungnya.

EndpointHasilMulai paket
/v1/latest/{BASE}Kurs terkini untuk mata uang dasarFree
/v1/convert/{FROM}/{TO}/{AMT}Konversi satu nominalFree
/v1/{YYYY-MM-DD}/{BASE}Kurs pada tanggal tertentu (Free: 30 hari terakhir)Free
/v1/timeseriesBar intrahariPlus
/v1/streamKurs real-time lewat WebSocketPlus
/v1/currenciesSemua mata uang yang didukungFree

Permintaan pertama Anda

Permintaan ini mengambil kurs IDR dan dua mata uang lain terhadap dolar. Kirim key lewat header Authorization: Bearer dari server Anda. Tanpa key, permintaan yang sama tetap bisa dijalankan dalam batas anonim.

Shell
curl "https://api.exchangerate.dev/v1/latest/USD?symbols=IDR,SGD,MYR" \  -H "Authorization: Bearer $EXCHANGERATE_API_KEY"
JavaScript
const res = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=IDR,SGD,MYR", {  headers: { Authorization: `Bearer ${process.env.EXCHANGERATE_API_KEY}` },})const data = await res.json()if (data.result !== "success") throw new Error(data.code)
Python
import os, requestsres = requests.get(    "https://api.exchangerate.dev/v1/latest/USD?symbols=IDR,SGD,MYR",    headers={"Authorization": f"Bearer {os.environ['EXCHANGERATE_API_KEY']}"},    timeout=10,)data = res.json()if data["result"] != "success":    raise RuntimeError(data["code"])

Membaca respons

rates memuat kurs tiap mata uang yang diminta terhadap base. timestamp menunjukkan waktu respons dalam UTC. Untuk tiap mata uang, stale menandai kurs yang lebih lama dari semestinya. Contoh di bawah diambil pada 19 Oktober 2026, bukan kurs terkini.

Contoh respons, 19 Oktober 2026
{  "result": "success",  "base": "USD",  "source": "live",  "sources": {    "IDR": "live",    "SGD": "live",    "MYR": "live"  },  "market_session": "open",  "timestamp": "2026-10-19T13:22:00Z",  "data_updated_at": "2026-10-19T13:06:59Z",  "effective_at": {    "IDR": "2026-10-19T13:06:59Z",    "SGD": "2026-10-19T13:06:59Z",    "MYR": "2026-10-19T13:06:59Z"  },  "rates": {    "IDR": 18042.36,    "SGD": 1.27924,    "MYR": 4.08206  },  "stale": {    "IDR": false,    "SGD": false,    "MYR": false  },  "derived_symbols": [],  "notice": "Indicative rates, not for settlement."}

Bandingkan paket

Semua paket mencakup kurs terkini, konversi, dan riwayat. Paket berbayar menambahkan kurs real-time, riwayat lebih panjang, bar intrahari, streaming, dan webhook. Rinciannya ada di halaman harga.

PaketFreeBasicPlusPro
Harga bulanan (dolar Amerika)$0$19$39$89
Permintaan per bulan5.000100.000300.0001.000.000
Permintaan per menit1060120300
KursTertunda 15 menitReal-timeReal-timeReal-time
Riwayat harian30 hari1 tahunLengkap, sejak 1999Lengkap, sejak 1999
Bar intrahariTidakTidakYaYa
Streaming WebSocketTidakTidakYaYa
Endpoint webhook00525
Server MCPYaYaYaYa
Penggunaan komersialYa, dengan atribusi berisi tautanYaYaYa

Coba tanpa API key

Endpoint data bisa diakses tanpa key dengan data paket Free. Batas per alamat IP adalah 10 permintaan per menit dan 100 per jam. Jika terlampaui, API mengembalikan 429 dengan body JSON yang menyebut batas tersebut.

Langkah berikutnya

Baca dokumentasi untuk endpoint dan parameternya, lalu dapatkan key gratis untuk memakai kuota sendiri.

Pertanyaan

Apakah API kurs ini gratis?

Ya. Free mencakup 5.000 permintaan per bulan dan 10 per menit, dengan kurs tertunda 15 menit. Kurs real-time tersedia di paket berbayar. Lihat [harga](/id/pricing).

Bisa mengambil kurs IDR?

Bisa. Cantumkan IDR pada `symbols` di `/v1/latest/{BASE}`, atau konversikan nominal lewat `/v1/convert/{FROM}/{TO}/{AMT}`.

Apakah perlu API key?

Untuk mencoba, tidak perlu. Endpoint data tanpa key menerima 10 permintaan per menit dan 100 per jam untuk setiap alamat IP. Untuk memakai kuota sendiri, kirim key lewat header `Authorization: Bearer` dari server Anda.

Seberapa jauh riwayat kursnya?

Free menyediakan 30 hari terakhir, Basic menyediakan 1 tahun, dan Plus menyediakan riwayat lengkap sejak 1999.

Baca juga

Mulai dengan API key gratis

Free mencakup 5.000 permintaan per bulan dan riwayat 30 hari terakhir. Tanpa kartu kredit.

Dapatkan key gratis