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:

Možnosť 1: Autorizačná hlavička (Odporúčané)

Autorizácia hlavičky (povinné)

Authorization: Bearer YOUR_API_KEY

Možnosť 2: Parametre dotazu

Prejdite svoj API kľúč ako parameter dotazu:

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

⚠ Bezpečnostná poznámka: API kľúče v URL môžu byť zaznamenané v prístupových logoch servera a môžu uniknúť cez HTTP Referrer hlavičky. Pre produkčné použitie odporúčame metódu Authorization header. Parameter dotazu je poskytnutý ako pohodlná možnosť pre rýchle testovanie a jednoduché integrácie.

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

# Using Authorization header (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/rate?from=USD&to=EUR"

# Using query parameter
curl "https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY"

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

# 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.

AI konektory (MCP)

Finexly hovorí Model Context Protocol, takže AI asistent môže čítať kurzy priamo namiesto toho, aby mu boli poskytnuté. Toto je samostatný kanál od REST API nižšie: autentifikuje sa pomocou OAuth namiesto API kľúča a je iba na čítanie.

URL servera

https://mcp.finexly.com

Nástroje, ktoré poskytuje

Meno Popis
get_exchange_rate Súčasný kurz medzi dvoma menami.
convert_amount Preveďte sumu, ak je to potrebné, cez americký dolár.
list_currencies Každá mena, ktorú pokrývame.
get_historical_rates Denno-denné kurzy za obdobie, pre páry získané priamo.

Autorizácia

Konektor vykonáva tok autorizačného kódu OAuth 2.1 s PKCE. Objavovanie je na nižšie uvedených URL; jediný rozsah je fx:read a neexistuje žiadny rozsah, ktorý by poskytoval prístup k účtu.

  • https://finexly.com/.well-known/oauth-authorization-server
  • https://finexly.com/oauth/authorize
  • https://finexly.com/oauth/token
  • https://finexly.com/oauth/jwks
Nastavenie sprievodcu a plánovanie príspevkov →

Tutorials & Guides

Learn how to integrate Finexly with your favorite programming languages and frameworks.