Első lépések

A Finexly API valós idejű és történelmi árfolyamokat biztosít több mint 170 valutához. A kezdés egyszerű:

  1. Regisztráljon ingyenes fiókot
  2. Szerezze be az API hozzáférési kulcsot a vezérlőpultról
  3. Küldje el első API-kérését

Alap URL

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

Hitelesítés

Minden API-kérés hitelesítést igényel Bearer tokenen keresztül. Az API kulcsot az Authorization fejlécben kell megadni:

Hitelesítési fejléc (Kötelező)

Authorization: Bearer YOUR_API_KEY

Korlátozás: Ellenőrizze a válaszfejléceket az aktuális használatért: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API végpontok

GET /v1/currencies

Az összes támogatott devizakód listájának lekérése.

Paraméterek

Név Típus Kötelező Leírás

Példa

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

// Válasz
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Árfolyam lekérése egy adott devizapárhoz.

Paraméterek

Név Típus Kötelező Leírás
from string Igen Alapdeviza kód (nagybetűk)
to string Igen Jegyzett deviza kód (nagybetűk)

Példa

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

// Válasz
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Árfolyamok lekérése több devizapárhoz egyetlen kérésben.

Paraméterek

Név Típus Kötelező Leírás
q string Igen Vesszővel elválasztott párok ALAP_JEGYZETT formátumban

Példa

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

// Válasz
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Adott összeg átváltása egyik devizából a másikba.

Paraméterek

Név Típus Kötelező Leírás
from string Igen Forrás deviza kód (nagybetűk)
to string Igen Cél deviza kód (nagybetűk)
amount number Igen Átváltandó összeg

Példa

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

// Válasz
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Kódpéldák

# 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")

Hibakódok

Kód Típus Leírás
400 BAD_REQUEST Érvénytelen kérési paraméterek vagy hiányzó kötelező mezők.
401 UNAUTHORIZED API token hiányzik vagy érvénytelen.
403 FORBIDDEN Hozzáférés megtagadva. Fiókja lehet, hogy inaktív.
413 PAYLOAD_TOO_LARGE A kérés mérete meghaladja a maximálisan engedélyezett méretet.
429 RATE_LIMIT_EXCEEDED Túllépte a sebességkorlátot. Ellenőrizze az X-RateLimit fejléceket.
500 INTERNAL_ERROR Belső szerverhiba történt. Kérjük, próbálja újra.