Початок роботи

API Finexly надає обмінні курси в реальному часі та історичні дані для понад 170 валют. Почати легко:

  1. Зареєструйтесь для безкоштовного облікового запису
  2. Отримайте ключ доступу до API з панелі керування
  3. Зробіть свій перший запит API

Базова URL-адреса

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

Автентифікація

Усі запити до API вимагають автентифікації за допомогою токена Bearer. Включіть свій API ключ у заголовок Authorization:

Заголовок авторизації (обов'язково)

Authorization: Bearer YOUR_API_KEY

Обмеження швидкості: Перевірте заголовки відповіді для вашого поточного використання: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Кінцеві точки API

GET /v1/currencies

Отримати список усіх підтримуваних кодів валют.

Параметри

Ім'я Тип Обов'язково Опис

Приклад

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

// Відповідь
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Отримати курс обміну для конкретної валютної пари.

Параметри

Ім'я Тип Обов'язково Опис
from string Так Код базової валюти (великі літери)
to string Так Код котируваної валюти (великі літери)

Приклад

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

// Відповідь
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /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
    }
}
GET /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
}

Приклади коду

# 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")

Коди помилок

Код Тип Опис
400 BAD_REQUEST Недійсні параметри запиту або відсутні обов'язкові поля.
401 UNAUTHORIZED API-токен відсутній або недійсний.
403 FORBIDDEN Доступ заборонено. Ваш обліковий запис може бути неактивним.
413 PAYLOAD_TOO_LARGE Розмір запиту перевищує максимально допустимий.
429 RATE_LIMIT_EXCEEDED Ви перевищили ліміт швидкості. Перевірте заголовки X-RateLimit.
500 INTERNAL_ERROR Сталася внутрішня помилка сервера. Будь ласка, спробуйте ще раз.