Începeți

API-ul Finexly oferă rate de schimb în timp real și istorice pentru peste 170 de valute. Începerea este simplă:

  1. Creează un cont gratuit
  2. Obține cheia de acces API din panou.
  3. Efectuați prima cerere API

URL de bază

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

Autentificare

Toate cererile API necesită autentificare prin token Bearer. Includeți cheia API în antetul Authorization:

Opțiunea 1: Antet de autorizare (Recomandat)

Antet de autorizare (Obligatoriu)

Authorization: Bearer YOUR_API_KEY

Opțiunea 2: Parametru de interogare

Transmiteți cheia API ca parametru de interogare:

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

⚠ Notă de securitate: Cheile API în URL-uri pot fi înregistrate în jurnalele de acces ale serverului și pot fi expuse prin anteturile HTTP Referrer. Pentru utilizarea în producție, recomandăm metoda cu antetul Authorization. Parametrul de interogare este oferit ca o comoditate pentru testare rapidă și integrări simple.

Limitare Rată: Verificați anteturile răspunsului pentru utilizarea curentă: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Puncte finale API

GET /v1/currencies

Obțineți o listă cu toate codurile valutare acceptate.

Parametri

Nume Tip Obligatoriu Descriere

Exemplu

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

// Răspuns
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Obțineți cursul de schimb pentru o pereche valutară specifică.

Parametri

Nume Tip Obligatoriu Descriere
from string Da Cod valută de bază (majuscule)
to string Da Cod valută cotată (majuscule)

Exemplu

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

// Răspuns
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Obțineți cursuri de schimb pentru mai multe perechi valutare într-o singură solicitare.

Parametri

Nume Tip Obligatoriu Descriere
q string Da Perechi separate prin virgulă în format BAZĂ_COTAȚIE

Exemplu

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

// Răspuns
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Convertiți o sumă specifică dintr-o valută în alta.

Parametri

Nume Tip Obligatoriu Descriere
from string Da Cod valută sursă (majuscule)
to string Da Cod valută țintă (majuscule)
amount number Da Suma de convertit

Exemplu

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

// Răspuns
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Exemple de cod

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

Coduri de eroare

Cod Tip Descriere
400 BAD_REQUEST Parametri de solicitare invalizi sau câmpuri obligatorii lipsă.
401 UNAUTHORIZED Token API lipsește sau este invalid.
403 FORBIDDEN Acces refuzat. Contul dvs. poate fi inactiv.
413 PAYLOAD_TOO_LARGE Dimensiunea solicitării depășește dimensiunea maximă permisă.
429 RATE_LIMIT_EXCEEDED Ați depășit limita de rată. Verificați anteturile X-RateLimit.
500 INTERNAL_ERROR A apărut o eroare internă de server. Vă rugăm să încercați din nou.