Başlarken

Finexly API, 170'den fazla para birimi için gerçek zamanlı ve geçmiş döviz kurları sağlar. Başlamak kolaydır:

  1. Ücretsiz bir hesap oluşturun
  2. API erişim anahtarınızı kontrol panelinden alın
  3. İlk API isteğinizi yapın

Temel URL

https://api.finexly.com/v1/

Kimlik Doğrulama

Tüm API istekleri, Bearer token ile kimlik doğrulaması gerektirir. API anahtarınızı Authorization başlığına ekleyin:

Yetkilendirme Başlığı (Gerekli)

Authorization: Bearer YOUR_API_KEY

Oran Sınırlandırma: Mevcut kullanımınızı kontrol etmek için yanıt başlıklarına bakın. X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API Uç Noktaları

GET /v1/currencies

Desteklenen tüm para birimi kodlarının listesini alın.

Parametreler

Ad Türü Gerekli Açıklama

Örnek

GET https://api.finexly.com/v1/currencies

// Yanıt
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Belirli bir döviz çifti için döviz kurunu alın.

Parametreler

Ad Türü Gerekli Açıklama
from string Evet Temel para birimi kodu (büyük harf)
to string Evet Karşıt para birimi kodu (büyük harf)

Örnek

GET https://api.finexly.com/v1/rate?from=USD&to=EUR

// Yanıt
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Tek bir istekte birden fazla döviz çifti için döviz kurlarını alın.

Parametreler

Ad Türü Gerekli Açıklama
q string Evet BASE_QUOTE formatında virgülle ayrılmış çiftler

Örnek

GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP

// Yanıt
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Belirli bir tutarı bir para biriminden diğerine dönüştürün.

Parametreler

Ad Türü Gerekli Açıklama
from string Evet Kaynak para birimi kodu (büyük harf)
to string Evet Hedef para birimi kodu (büyük harf)
amount number Evet Dönüştürülecek tutar

Örnek

GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100

// Yanıt
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Kod Örnekleri

# Get single rate
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/rate?from=USD&to=EUR"

# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP,BTC_USD"

# Convert amount
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100"
<?php
$apiKey = 'YOUR_API_KEY';

// Using cURL
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.finexly.com/v1/rate?from=USD&to=EUR',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "USD/EUR Rate: " . $data['rate'];
const apiKey = 'YOUR_API_KEY';

// Get single rate
const response = await fetch('https://api.finexly.com/v1/rate?from=USD&to=EUR', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const data = await response.json();
console.log(`USD/EUR Rate: ${data.rate}`);

// Convert amount
const convertResponse = await fetch(
  'https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100',
  { headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const result = await convertResponse.json();
console.log(`100 USD = ${result.result} EUR`);
import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': f'Bearer {api_key}'}

# Get single rate
response = requests.get(
    'https://api.finexly.com/v1/rate',
    params={'from': 'USD', 'to': 'EUR'},
    headers=headers
)
data = response.json()
print(f"USD/EUR Rate: {data['rate']}")

# Convert amount
response = requests.get(
    'https://api.finexly.com/v1/convert-amount',
    params={'from': 'USD', 'to': 'EUR', 'amount': 100},
    headers=headers
)
result = response.json()
print(f"100 USD = {result['result']} EUR")

Hata Kodları

Kod Türü Açıklama
400 BAD_REQUEST Geçersiz istek parametreleri veya eksik zorunlu alanlar.
401 UNAUTHORIZED API token'ı eksik veya geçersiz.
403 FORBIDDEN Erişim reddedildi. Hesabınız aktif olmayabilir.
413 PAYLOAD_TOO_LARGE İstek boyutu izin verilen maksimum boyutu aşıyor.
429 RATE_LIMIT_EXCEEDED Hız limitinizi aştınız. X-RateLimit başlıklarını kontrol edin.
500 INTERNAL_ERROR Dahili sunucu hatası oluştu. Lütfen tekrar deneyin.