Kurs referensi ECB, konversi, dan data historis.
Kurs terbaru, konversi, daftar mata uang, dan deret waktu historis dari Frankfurter (data European Central Bank). Kurs diperbarui pada hari kerja dan bukan kurs real-time maupun kurs bank. Data historis adalah endpoint Premium.
/api/v1/currency/latestFreecache 30 menitKurs referensi ECB terbaru. Batasi dengan symbols untuk respons lebih ringkas.
| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| base | query | string | Tidak | Mata uang dasar (ISO-4217). Default: USD. |
| symbols | query | string | Tidak | Daftar mata uang tujuan dipisah koma. |
curl "https://layananapirannz.web.id/api/v1/currency/latest?base=USD&symbols=IDR%2CEUR%2CJPY" \
-H "Authorization: Bearer YOUR_API_KEY"{
"data": {
"base": "USD",
"date": "2026-10-16",
"rates": {
"IDR": 16240.5,
"EUR": 0.92
}
},
"meta": {
"requestId": "…",
"endpoint": "currency.latest",
"cached": false
}
}Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.
{
"error": {
"code": "INVALID_INPUT",
"message": "Input tidak valid.",
"requestId": "…",
"details": [
{
"field": "base",
"message": "Parameter wajib diisi"
}
]
}
}400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu./api/v1/currency/convertFreecache 30 menitMenghitung nilai konversi memakai kurs referensi ECB terbaru.
| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| from | query | string | Ya | Mata uang asal. |
| to | query | string | Ya | Mata uang tujuan. |
| amount | query | number | Tidak | Jumlah yang dikonversi. Default: 1. Rentang: 0.01 - 1000000000. |
curl "https://layananapirannz.web.id/api/v1/currency/convert?from=USD&to=IDR&amount=10" \
-H "Authorization: Bearer YOUR_API_KEY"{
"data": {
"from": "USD",
"to": "IDR",
"amount": 10,
"result": 162405,
"rate": 16240.5,
"date": "2026-10-16"
},
"meta": {
"requestId": "…",
"endpoint": "currency.convert",
"cached": false
}
}Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.
{
"error": {
"code": "INVALID_INPUT",
"message": "Input tidak valid.",
"requestId": "…",
"details": [
{
"field": "from",
"message": "Parameter wajib diisi"
}
]
}
}400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu./api/v1/currency/currenciesFreecache 24 jamKode ISO-4217 beserta nama mata uang.
Endpoint ini tidak memiliki parameter.
curl "https://layananapirannz.web.id/api/v1/currency/currencies" \
-H "Authorization: Bearer YOUR_API_KEY"{
"data": {
"currencies": {
"IDR": "Indonesian Rupiah",
"USD": "United States Dollar"
}
},
"meta": {
"requestId": "…",
"endpoint": "currency.list",
"cached": false
}
}Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.
{
"error": {
"code": "INVALID_INPUT",
"message": "Input tidak valid.",
"requestId": "…",
"details": [
{
"field": "param",
"message": "Parameter wajib diisi"
}
]
}
}400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu./api/v1/currency/historyPremiumcache 1 jamDeret waktu kurs referensi ECB. Rentang maksimum 366 hari. Endpoint Premium.
| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| base | query | string | Tidak | Mata uang dasar. Default: USD. |
| symbols | query | string | Tidak | Daftar mata uang tujuan dipisah koma. |
| start | query | string | Ya | Tanggal mulai (YYYY-MM-DD). |
| end | query | string | Ya | Tanggal akhir (YYYY-MM-DD). |
curl "https://layananapirannz.web.id/api/v1/currency/history?base=USD&symbols=IDR&start=2026-09-01&end=2026-09-30" \
-H "Authorization: Bearer YOUR_API_KEY"{
"data": {
"base": "USD",
"startDate": "2026-09-01",
"endDate": "2026-09-30",
"rates": {
"2026-09-01": {
"IDR": 16100.2
},
"2026-09-02": {
"IDR": 16120.9
}
}
},
"meta": {
"requestId": "…",
"endpoint": "currency.history",
"cached": false
}
}Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.
{
"error": {
"code": "INVALID_INPUT",
"message": "Input tidak valid.",
"requestId": "…",
"details": [
{
"field": "base",
"message": "Parameter wajib diisi"
}
]
}
}400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.