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