CurrencyRateAPI

Hızlı Başlatma Aracı

Tüm dokümantasyonu incelemeden API'yi test etmeniz mi gerekiyor? Kontrol Paneline gidin; burada Hızlı Başlatma Aracını bulacaksınız. Bu araç, tek bir tıklamayla tüm kullanılabilir uç noktaları denemenizi sağlayan basit bir yöntemdir.

Aşağıdaki düğmeye tıklayarak ücretsiz kayıt olun ve Hızlı Başlatma Aracını kullanmaya başlayın.

Başlarken

Döviz Kuru API'si ile çalışmaya başlamak için ihtiyacınız olacak temel terimler ve kavramlar:

API Yanıtı

CurrencyRateAPI tarafından sağlanan döviz kurları varsayılan olarak Euro cinsindendir. Tüm veriler standart JSON formatında döndürülür ve herhangi bir programlama dili kullanılarak kolayca ayrıştırılabilir.

Örnek yanıt:
Aşağıda, yaygın olarak kullanılan çeşitli dünya para birimlerini içeren, tümü EUR para birimine göre ve alındıkları zaman damgasıyla birlikte örnek bir API yanıtı bulacaksınız.

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

Yukarıda gösterildiği gibi, gerçek zamanlı döviz kurlarına ilişkin API yanıtı birkaç önemli alan içermektedir:

• success İsteğin başarılı olup olmadığını gösterir.
• base Bu istek için kullanılan temel para biriminin 3 harfli kodunu döndürür.
• date Döviz kurlarının verildiği gerçek tarihi döndürür (YYYY-MM-DD formatı).
• rates Talep edilen para birimlerinin listesini ve güncel döviz kurlarını içerir.
• last_update_unix Sistemdeki en son kullanılabilir verinin zaman damgasını (Unix formatında) gösterir.

Mevcut Uç Noktalar

CurrencyRateAPI, her biri belirli işlevsellik sunan çeşitli API uç noktaları içerir. Belirli uç noktaların kullanılabilirliği abonelik planınıza bağlıdır.

• Para birimleri listesinin bitiş noktası. Bu uç nokta, desteklenen tüm para birimlerinin tam listesini döndürür. /api/codes (Alternatif: /api/currencies)
• En son oranların bitiş noktası. Bu uç nokta, desteklenen tüm para birimleri için gerçek zamanlı döviz kuru verilerini döndürür. /api/latest
• Tarihsel oranların son noktası. Bu uç nokta, belirli bir tarih için geçmiş döviz kuru verilerini döndürür. /api/YYYY-MM-DD (Alternatif: /api/history?date=YYYY-MM-DD). Tarihsel veriler 4 Ocak 1999 tarihinden itibaren mevcuttur.

Döviz Kuru Metodolojisi

Veri doğruluğunu ve tutarlılığını sağlamak için, CurrencyRateAPI döviz kurlarını yönetme ve sunma konusunda katı bir metodoloji izlemektedir:

• Orta Piyasa Fiyatları: Varsayılan olarak, API mid oranlarını döndürür. Bunlar, piyasa alış ( bid ) ve satış ( ask ) fiyatları veya merkez bankalarından alınan resmi referans oranları arasındaki aritmetik ortalamayı temsil eder.
• Gün Sonu (EOD) Kesinleştirme: API tarafından sağlanan geçmişe dönük döviz kurları, UTC (Koordineli Evrensel Zaman) saat diliminde gün sonu itibarıyla kesinleşir.
• Çapraz Oran Hesaplaması: Kaynaklarımızdan doğrudan elde edilemeyen döviz çiftleri için sistem, başlıca küresel para birimlerini köprü (pivot) olarak kullanarak otomatik olarak son derece doğru çapraz kurlar hesaplar.
• Akıllı Yedekleme Mekanizması: İstenen tarih için veri mevcut değilse (örneğin, hafta sonları veya tatillerde piyasaların kapalı olması nedeniyle), sistem otomatik olarak 8 günlük kayan bir pencere içinde en son geçerli kuru arar.
• Yüksek Hassasiyet: Finansal hesaplamalarda yuvarlama hatalarını önlemek için döviz kurları 18 ondalık basamağa kadar saklanır ve işlenir.

Uç noktalar

Desteklenen Semboller Uç Noktası

https://currencyrateapi.com/api/codes

Bu uç nokta, desteklenen tüm para birimlerinin tam listesini döndürür. Ayrıca /api/currencies takma adını da kullanabilirsiniz.

Desteklenen tüm para birimlerinin insan tarafından okunabilir bir listesi, Desteklenen Para Birimleri sayfamızda da mevcuttur.

Temel Para Birimleri: Varsayılan olarak, bazı diğer uç noktalar (/latest ve /{YYYY-MM-DD}), trafiği en aza indirmek için sınırlı sayıda önemli küresel para birimi döndürür. Bu "temel" para birimleri şunlardır:

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

API Yanıtı:

{
    "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"
        },
        [...]
    }
}

Yanıt Nesneleri:

En Son Fiyatlar Uç Noktası

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

İstek Parametreleri:

API Yanıtı:

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

Yanıt Nesneleri:

Tarihsel Oranların Bitiş Noktası

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

Alternatif format: /api/history?date=2025-08-25...

İstek Parametreleri:

API Yanıtı:

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

Yanıt Nesneleri:

Örnek Kod

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