Rannz Currency API

Kurs referensi ECB, konversi, dan data historis.

GET/api/v1/currency/latestFreecache 30 menit

Kurs terbaru terhadap mata uang dasar

Kurs 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.

Contoh request

curl "https://layananapirannz.web.id/api/v1/currency/latest?base=USD&symbols=IDR%2CEUR%2CJPY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "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.

Contoh respons error

{
  "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.

GET/api/v1/currency/convertFreecache 30 menit

Konversi sejumlah uang antar mata uang

Menghitung 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.

Contoh request

curl "https://layananapirannz.web.id/api/v1/currency/convert?from=USD&to=IDR&amount=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "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.

Contoh respons error

{
  "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.

GET/api/v1/currency/currenciesFreecache 24 jam

Daftar mata uang yang didukung

Kode ISO-4217 beserta nama mata uang.

Endpoint ini tidak memiliki parameter.

Contoh request

curl "https://layananapirannz.web.id/api/v1/currency/currencies" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "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.

Contoh respons error

{
  "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.

GET/api/v1/currency/historyPremiumcache 1 jam

Kurs historis harian dalam rentang tanggal

Deret 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).

Contoh request

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"

Contoh respons sukses (200)

{
  "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.

Contoh respons error

{
  "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.

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.

{ "data": { "base": "USD", "date": "2026-10-16", "rates": { "IDR": 16240.5, "EUR": 0.92 } }, "meta": { "requestId": "…", "endpoint": "currency.latest", "cached": false } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "base", "message": "Parameter wajib diisi" } ] } }

Parameter

Lokasi

Tipe

Wajib

Keterangan

from

query

string

Mata uang asal.

query

string

Mata uang tujuan.

amount

query

number

Tidak

Jumlah yang dikonversi. Default: 1. Rentang: 0.01 - 1000000000.

{ "data": { "from": "USD", "to": "IDR", "amount": 10, "result": 162405, "rate": 16240.5, "date": "2026-10-16" }, "meta": { "requestId": "…", "endpoint": "currency.convert", "cached": false } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "from", "message": "Parameter wajib diisi" } ] } }

{ "data": { "currencies": { "IDR": "Indonesian Rupiah", "USD": "United States Dollar" } }, "meta": { "requestId": "…", "endpoint": "currency.list", "cached": false } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "param", "message": "Parameter wajib diisi" } ] } }

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

Tanggal mulai (YYYY-MM-DD).

end

query

string

Tanggal akhir (YYYY-MM-DD).

{ "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 } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "base", "message": "Parameter wajib diisi" } ] } }