Začíname
Finexly API poskytuje aktuálne a historické výmenné kurzy pre viac ako 170 mien. Začať je jednoduché:
- Zaregistrujte sa na bezplatný účet
- Získajte svoj prístupový kľúč API z panela.
- 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
/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"
]
/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
}
/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
}
}
/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. |
Tutorials & Guides
Learn how to integrate Finexly with your favorite programming languages and frameworks.
JavaScript Integration Tutorial
Step-by-step guide to integrating Finexly API with JavaScript and Node.js.
Python Integration Tutorial
Complete guide to using Finexly API with Python and popular libraries.
Developer Guide
Comprehensive guide to free currency API features and best practices.
Historical Rates Guide
Learn how to retrieve and work with historical exchange rate data.