Първи стъпки

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 Да Двойки, разделени със запетая във формат BASE_QUOTE

Пример

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 Възникна вътрешна сървърна грешка. Моля, опитайте отново.