CurrencyRateAPI

Alat Peluncuran Cepat

Perlu menguji API tanpa harus membaca dokumentasi lengkap? Kunjungi Panel Kontrol, di mana Anda akan menemukan Alat Peluncuran Cepat — cara mudah untuk mencoba semua endpoint yang tersedia hanya dengan satu klik.

Klik tombol di bawah ini untuk mendaftar secara gratis dan mulai menggunakan Alat Peluncuran Cepat.

Memulai

Istilah dan konsep kunci yang Anda perlukan untuk mulai bekerja dengan API Kurs Mata Uang:

Respons API

Nilai tukar yang disediakan oleh CurrencyRateAPI secara default adalah dalam Euro. Semua data dikembalikan dalam format JSON standar dan dapat dengan mudah diuraikan menggunakan bahasa pemrograman apa pun.

Contoh jawaban:
Di bawah ini Anda akan menemukan contoh respons API yang berisi berbagai mata uang dunia umum, semuanya relatif terhadap mata uang EUR dan dengan stempel waktu penerimaannya.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Seperti yang ditunjukkan di atas, respons API untuk nilai tukar real-time mencakup beberapa bidang utama:

• success Menunjukkan apakah permintaan tersebut berhasil.
• base Mengembalikan kode 3 huruf dari mata uang dasar yang digunakan untuk permintaan ini.
• date Mengembalikan tanggal sebenarnya di mana nilai tukar diberikan (format YYYY-MM-DD).
• rates berisi daftar mata uang yang diminta dan nilai tukar saat ini.
• last_update_unix Menampilkan stempel waktu (dalam format Unix) dari data terbaru yang tersedia dalam sistem.

Endpoint yang Tersedia

CurrencyRateAPI mencakup beberapa endpoint API, yang masing-masing menawarkan fungsionalitas spesifik. Ketersediaan endpoint tertentu bergantung pada paket langganan Anda.

• Titik akhir daftar mata uang. Endpoint ini mengembalikan daftar lengkap semua mata uang yang didukung. /api/codes (Alternatif: /api/currencies)
• Titik akhir dari tarif terbaru. Endpoint ini mengembalikan data nilai tukar secara real-time untuk semua mata uang yang didukung. /api/latest
• Titik akhir dari tingkat historis. Endpoint ini mengembalikan data nilai tukar historis untuk tanggal tertentu. /api/YYYY-MM-DD (Alternatif: /api/history?date=YYYY-MM-DD). Data historis tersedia sejak 4 Januari 1999.

Metodologi Nilai Tukar

Untuk memastikan keakuratan dan konsistensi data, CurrencyRateAPI mengikuti metodologi ketat untuk mengelola dan menyampaikan nilai tukar:

• Suku Bunga Pasar Tengah: Secara default, API mengembalikan nilai tukar mid . Nilai ini mewakili rata-rata aritmatika antara harga beli ( bid ) dan harga jual ( ask ) pasar, atau nilai tukar referensi resmi dari bank sentral.
• Finalisasi Akhir Hari (EOD): Tarif historis yang disediakan oleh API telah difinalisasi pada akhir hari dalam UTC (Waktu Universal Terkoordinasi).
• Perhitungan Kurs Silang: Untuk pasangan mata uang yang tidak tersedia langsung dari sumber kami, sistem secara otomatis menghitung nilai tukar silang yang sangat akurat menggunakan mata uang global utama sebagai jembatan (pivot).
• Mekanisme Cadangan Cerdas: Jika data untuk tanggal yang diminta tidak tersedia (misalnya, karena penutupan pasar pada akhir pekan atau hari libur), sistem secara otomatis mencari kurs valid terbaru dalam rentang waktu 8 hari .
• Presisi Tinggi: Untuk mencegah kesalahan pembulatan dalam perhitungan keuangan, nilai tukar disimpan dan diproses hingga 18 angka desimal .

Titik akhir

Endpoint Simbol yang Didukung

https://currencyrateapi.com/api/codes

Endpoint ini mengembalikan daftar lengkap semua mata uang yang didukung. Anda juga dapat menggunakan alias /api/currencies.

Daftar lengkap mata uang yang didukung dan mudah dibaca juga tersedia di halaman Mata Uang yang Didukung kami.

Mata Uang Dasar: Secara default, beberapa endpoint lain (seperti /latest dan /{YYYY-MM-DD}) mengembalikan sejumlah mata uang global utama yang terbatas untuk meminimalkan lalu lintas. Mata uang "dasar" ini adalah:

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

Respons API:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

Objek Respons:

Titik Akhir Tarif Terbaru

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

Parameter Permintaan:

Respons API:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

Objek Respons:

Titik Akhir Tingkat Historis

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

Format alternatif: /api/history?date=2025-08-25...

Parameter Permintaan:

Respons API:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Objek Respons:

Contoh Kode

PHP (cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

JavaScript (fetch)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });