Початок роботи
API Finexly надає обмінні курси в реальному часі та історичні дані для понад 170 валют. Почати легко:
- Зареєструйтесь для безкоштовного облікового запису
- Отримайте ключ доступу до API з панелі керування
- Зробіть свій перший запит API
Базова URL-адреса
https://api.finexly.com/v1/
Автентифікація
Усі запити до API вимагають автентифікації за допомогою токена Bearer. Включіть свій API ключ у заголовок Authorization:
Варіант 1: Заголовок авторизації (рекомендовано)
Заголовок авторизації (обов'язково)
Authorization: Bearer YOUR_API_KEY
Варіант 2: Параметр запиту
Передайте свій ключ API як параметр запиту:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Примітка щодо безпеки: Ключі API в URL можуть бути записані в журналах доступу сервера і можуть витікати через заголовки HTTP Referrer. Для використання в продакшені ми рекомендуємо метод заголовка Authorization. Параметр запиту надається для зручності швидкого тестування та простих інтеграцій.
Обмеження швидкості: Перевірте заголовки відповіді для вашого поточного використання:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Кінцеві точки API
/v1/currencies
Отримати список усіх підтримуваних кодів валют.
Параметри
| Ім'я | Тип | Обов'язково | Опис |
|---|
Приклад
GET https://api.finexly.com/v1/currencies
// Відповідь
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Отримати курс обміну для конкретної валютної пари.
Параметри
| Ім'я | Тип | Обов'язково | Опис |
|---|---|---|---|
| from | string | Так | Код базової валюти (великі літери) |
| to | string | Так | Код котируваної валюти (великі літери) |
Приклад
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Відповідь
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Отримати курси обміну для кількох валютних пар в одному запиті.
Параметри
| Ім'я | Тип | Обов'язково | Опис |
|---|---|---|---|
| q | string | Так | Пари через кому у форматі БАЗА_КОТИРУВАННЯ |
Приклад
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Відповідь
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Конвертувати певну суму з однієї валюти в іншу.
Параметри
| Ім'я | Тип | Обов'язково | Опис |
|---|---|---|---|
| from | string | Так | Код вихідної валюти (великі літери) |
| to | string | Так | Код цільової валюти (великі літери) |
| amount | number | Так | Сума для конвертації |
Приклад
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Відповідь
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Приклади коду
# 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")
Коди помилок
| Код | Тип | Опис |
|---|---|---|
| 400 | BAD_REQUEST | Недійсні параметри запиту або відсутні обов'язкові поля. |
| 401 | UNAUTHORIZED | API-токен відсутній або недійсний. |
| 403 | FORBIDDEN | Доступ заборонено. Ваш обліковий запис може бути неактивним. |
| 413 | PAYLOAD_TOO_LARGE | Розмір запиту перевищує максимально допустимий. |
| 429 | RATE_LIMIT_EXCEEDED | Ви перевищили ліміт швидкості. Перевірте заголовки X-RateLimit. |
| 500 | INTERNAL_ERROR | Сталася внутрішня помилка сервера. Будь ласка, спробуйте ще раз. |
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.