CurrencyRateAPI

Alat Pelancaran Pantas

Perlu menguji API tanpa perlu meneliti dokumentasi penuh? Pergi ke Panel Kawalan, di mana anda akan menemui Alat Pelancaran Pantas — cara mudah untuk mencuba semua titik akhir yang tersedia dengan satu klik.

Klik butang di bawah untuk mendaftar secara percuma dan mula menggunakan Alat Pelancaran Pantas.

Bermula

Istilah dan konsep utama yang anda perlukan untuk mula menggunakan Currency Rate API:

Respons API

Kadar pertukaran yang disediakan oleh CurrencyRateAPI adalah secara lalai dalam Euro. Semua data dikembalikan dalam format JSON standard dan boleh dihuraikan dengan mudah menggunakan mana-mana bahasa pengaturcaraan.

Contoh respons:
Di bawah anda akan menemui contoh respons API yang mengandungi pelbagai mata wang dunia biasa, semuanya relatif kepada mata wang EUR dan dengan cap waktu ia diterima.

{
    "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 kadar pertukaran masa nyata merangkumi beberapa medan utama:

• success menunjukkan sama ada permintaan itu berjaya.
• base mengembalikan kod 3 huruf mata wang asas yang digunakan untuk permintaan ini.
• date mengembalikan tarikh sebenar kadar pertukaran diberikan (format YYYY-MM-DD).
• rates menyimpan senarai mata wang yang diminta dan kadar pertukaran semasa mereka.
• last_update_unix menunjukkan cap waktu (dalam format Unix) bagi data terkini yang tersedia dalam sistem.

Titik Akhir yang Tersedia

CurrencyRateAPI merangkumi beberapa titik akhir API, setiap satunya menawarkan fungsi khusus. Ketersediaan titik akhir tertentu bergantung pada pelan langganan anda.

• Titik akhir senarai mata wang. Titik akhir ini mengembalikan senarai penuh semua mata wang yang disokong. /api/codes (Alternatif: /api/currencies)
• Titik akhir kadar terkini. Titik akhir ini mengembalikan data kadar pertukaran masa nyata untuk semua mata wang yang disokong. /api/latest
• Titik akhir kadar sejarah. Titik akhir ini mengembalikan data kadar pertukaran sejarah untuk tarikh tertentu. /api/YYYY-MM-DD (Alternatif: /api/history?date=YYYY-MM-DD). Data sejarah tersedia dari 4 Januari 1999.

Metodologi Kadar Pertukaran

Untuk memastikan ketepatan dan konsistensi data, CurrencyRateAPI mengikuti metodologi yang ketat untuk mengurus dan menyampaikan kadar pertukaran:

• Kadar Pasaran Sederhana: Secara lalai, API mengembalikan kadar mid . Ini mewakili purata aritmetik antara harga beli pasaran ( bid ) dan jual ( ask ), atau kadar rujukan rasmi daripada bank pusat.
• Penyiapan Akhir Hari (EOD): Kadar sejarah yang disediakan oleh API dimuktamadkan pada penghujung hari dalam UTC (Waktu Sejagat Terselaras).
• Pengiraan Kadar Silang: Bagi pasangan mata wang yang tidak tersedia secara langsung daripada sumber kami, sistem akan mengira kadar silang yang sangat tepat secara automatik menggunakan mata wang global utama sebagai jambatan (pangsi).
• Mekanisme Guna Balik Pintar: Jika data untuk tarikh yang diminta tidak tersedia (contohnya, disebabkan oleh penutupan pasaran pada hujung minggu atau cuti umum), sistem akan mencari kadar sah terkini secara automatik dalam tempoh 8 hari yang terhad.
• Ketepatan Tinggi: Untuk mengelakkan ralat pembundaran dalam pengiraan kewangan, kadar pertukaran disimpan dan diproses sehingga 18 tempat perpuluhan .

Titik akhir

Titik Akhir Simbol yang Disokong

https://currencyrateapi.com/api/codes

Titik akhir ini mengembalikan senarai penuh semua mata wang yang disokong. Anda juga boleh menggunakan alias /api/currencies.

Senarai semua mata wang yang disokong yang boleh dibaca oleh manusia juga tersedia di halaman Mata Wang yang Disokong kami.

Mata Wang Asas: Secara lalai, beberapa titik akhir lain (seperti /latest dan /{YYYY-MM-DD}) mengembalikan set mata wang global utama yang terhad untuk meminimumkan trafik. Mata wang "asas" ini ialah:

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 Kadar Terkini

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 Kadar Sejarah

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:

Kod Contoh

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 (ambil)

 // 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);
    });