Pierwsze kroki

API Finexly dostarcza kursy wymiany w czasie rzeczywistym oraz historyczne dla ponad 170 walut. Rozpoczęcie jest proste:

  1. Zarejestruj się, aby utworzyć darmowe konto
  2. Uzyskaj klucz dostępu do API z panelu.
  3. Wykonaj swoje pierwsze żądanie API

Podstawowy URL

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

Uwierzytelnianie

Wszystkie żądania API wymagają uwierzytelnienia za pomocą tokenu Bearer. Dołącz swój klucz API w nagłówku Authorization:

Nagłówek autoryzacji (wymagany)

Authorization: Bearer YOUR_API_KEY

Ograniczanie szybkości: Sprawdź nagłówki odpowiedzi, aby zobaczyć swoje bieżące użycie: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Punkty końcowe API

GET /v1/currencies

Pobierz listę wszystkich obsługiwanych kodów walut.

Parametry

Nazwa Rodzaj Wymagane Opis

Przykład

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

// Odpowiedź
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Pobierz kurs wymiany dla określonej pary walut.

Parametry

Nazwa Rodzaj Wymagane Opis
from string Tak Kod waluty bazowej (wielkimi literami)
to string Tak Kod waluty kwotowanej (wielkimi literami)

Przykład

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

// Odpowiedź
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Pobierz kursy wymiany dla wielu par walut w jednym żądaniu.

Parametry

Nazwa Rodzaj Wymagane Opis
q string Tak Pary oddzielone przecinkami w formacie BAZA_KWOTOWANIE

Przykład

GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP

// Odpowiedź
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Przelicz określoną kwotę z jednej waluty na inną.

Parametry

Nazwa Rodzaj Wymagane Opis
from string Tak Kod waluty źródłowej (wielkimi literami)
to string Tak Kod waluty docelowej (wielkimi literami)
amount number Tak Kwota do przeliczenia

Przykład

GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100

// Odpowiedź
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Przykłady kodu

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

Kody błędów

Kod Rodzaj Opis
400 BAD_REQUEST Nieprawidłowe parametry żądania lub brakujące wymagane pola.
401 UNAUTHORIZED Brak tokenu API lub nieprawidłowy token.
403 FORBIDDEN Dostęp zabroniony. Twoje konto może być nieaktywne.
413 PAYLOAD_TOO_LARGE Rozmiar żądania przekracza maksymalny dozwolony rozmiar.
429 RATE_LIMIT_EXCEEDED Przekroczono limit szybkości. Sprawdź nagłówki X-RateLimit.
500 INTERNAL_ERROR Wystąpił wewnętrzny błąd serwera. Spróbuj ponownie.