Začíname

Finexly API poskytuje aktuálne a historické výmenné kurzy pre viac ako 170 mien. Začať je jednoduché:

  1. Zaregistrujte sa na bezplatný účet
  2. Získajte svoj prístupový kľúč API z panela.
  3. Vykonajte svoju prvú API požiadavku

Základná URL adresa

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

Overenie

Všetky API požiadavky vyžadujú autentifikáciu prostredníctvom Bearer tokenu. Zahrňte svoj API kľúč v hlavičke Authorization:

Autorizácia hlavičky (povinné)

Authorization: Bearer YOUR_API_KEY

Obmedzenie rýchlosti: Skontrolujte hlavičky odpovedí pre aktuálne využitie: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API koncové body

GET /v1/currencies

Získajte zoznam všetkých podporovaných kódov mien.

Parametre

Meno Typ Povinné Popis

Príklad

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

// Odpoveď
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Získajte výmenný kurz pre konkrétny menový pár.

Parametre

Meno Typ Povinné Popis
from string Áno Kód základnej meny (veľké písmená)
to string Áno Kód kótovanej meny (veľké písmená)

Príklad

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

// Odpoveď
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Získajte výmenné kurzy pre viacero menových párov v jednej požiadavke.

Parametre

Meno Typ Povinné Popis
q string Áno Páry oddelené čiarkou vo formáte ZÁKLAD_KÓTOVANIE

Príklad

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

// Odpoveď
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Preveďte konkrétnu sumu z jednej meny na druhú.

Parametre

Meno Typ Povinné Popis
from string Áno Kód zdrojovej meny (veľké písmená)
to string Áno Kód cieľovej meny (veľké písmená)
amount number Áno Suma na prevod

Príklad

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

// Odpoveď
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Príklady kódu

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

Chybové kódy

Kód Typ Popis
400 BAD_REQUEST Neplatné parametre požiadavky alebo chýbajúce povinné polia.
401 UNAUTHORIZED API token chýba alebo je neplatný.
403 FORBIDDEN Prístup odmietnutý. Váš účet môže byť neaktívny.
413 PAYLOAD_TOO_LARGE Veľkosť požiadavky prekračuje maximálnu povolenú veľkosť.
429 RATE_LIMIT_EXCEEDED Prekročili ste svoj limit rýchlosti. Skontrolujte hlavičky X-RateLimit.
500 INTERNAL_ERROR Vyskytla sa interná chyba servera. Skúste to znova.