Začínáme
Finexly API poskytuje aktuální a historické směnné kurzy pro více než 170 měn. Začít je snadné:
- Zaregistrujte se k bezplatnému účtu
- Získejte svůj přístupový klíč API z ovládacího panelu
- 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:
Možnost 1: Autorizační záhlaví (doporučeno)
Záhlaví autorizace (povinné)
Authorization: Bearer YOUR_API_KEY
Možnost 2: Dotazovací parametr
Předat svůj API klíč jako parametr dotazu:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Bezpečnostní poznámka: Klíče API v URL mohou být zaznamenány v záznamech přístupu serveru a mohou uniknout prostřednictvím HTTP Referrer hlaviček. Pro produkční použití doporučujeme metodu Authorization header. Parametr dotazu je poskytován jako pohodlí pro rychlé testování a jednoduché integrace.
Omezení rychlosti: Zkontrolujte hlavičky odpovědi pro aktuální využití:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Koncové body API
/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"
]
/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
}
/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
}
}
/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
# 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é 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. |
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.