Začínáme

Finexly API poskytuje aktuální a historické směnné kurzy pro více než 170 měn. Začít je snadné:

  1. Zaregistrujte se k bezplatnému účtu
  2. Získejte svůj přístupový klíč API z ovládacího panelu
  3. Proveďte svůj první API požadavek

Základní URL

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

Ověření

Všechny požadavky na API vyžadují autentizaci prostřednictvím Bearer tokenu. Zahrňte svůj API klíč do hlavičky Authorization:

Záhlaví autorizace (povinné)

Authorization: Bearer YOUR_API_KEY

Omezení rychlosti: Zkontrolujte hlavičky odpovědi pro aktuální využití: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Koncové body API

GET /v1/currencies

Získejte seznam všech podporovaných kódů měn.

Parametry

Jméno Typ Povinné Popis

Příklad

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

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

Získejte směnný kurz pro konkrétní měnový pár.

Parametry

Jméno Typ Povinné Popis
from string Ano Kód základní měny (velká písmena)
to string Ano Kód kotované měny (velká písmena)

Příklad

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

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

Získejte směnné kurzy pro více měnových párů v jednom požadavku.

Parametry

Jméno Typ Povinné Popis
q string Ano Páry oddělené čárkou ve formátu ZÁKLAD_KOTACE

Příklad

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

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

Převeďte konkrétní částku z jedné měny na druhou.

Parametry

Jméno Typ Povinné Popis
from string Ano Kód zdrojové měny (velká písmena)
to string Ano Kód cílové měny (velká písmena)
amount number Ano Částka k převodu

Příklad

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

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

Pří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é parametry požadavku nebo chybějící povinná pole.
401 UNAUTHORIZED API token chybí nebo je neplatný.
403 FORBIDDEN Přístup odepřen. Váš účet může být neaktivní.
413 PAYLOAD_TOO_LARGE Velikost požadavku překračuje maximální povolenou velikost.
429 RATE_LIMIT_EXCEEDED Překročili jste svůj limit rychlosti. Zkontrolujte hlavičky X-RateLimit.
500 INTERNAL_ERROR Došlo k interní chybě serveru. Zkuste to prosím znovu.