Aan de slag

De Finexly API biedt realtime en historische wisselkoersen voor meer dan 170 valuta's. Aan de slag gaan is eenvoudig:

  1. Registreer voor een gratis account
  2. Haal je API-toegangssleutel van het dashboard
  3. Doe uw eerste API-verzoek

Basis-URL

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

Authenticatie

Alle API-verzoeken vereisen authenticatie via een Bearer-token. Voeg uw API-sleutel toe in de Authorization-header:

Autorisatieheader (Vereist)

Authorization: Bearer YOUR_API_KEY

Rate Limiting: Controleer de response headers voor uw huidige gebruik: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-eindpunten

GET /v1/currencies

Verkrijg een lijst van alle ondersteunde valutacodes.

Parameters

Naam Type Vereist Beschrijving

Voorbeeld

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

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

Verkrijg de wisselkoers voor een specifiek valutapaar.

Parameters

Naam Type Vereist Beschrijving
from string Ja Basisvalutacode (hoofdletters)
to string Ja Koersvalutacode (hoofdletters)

Voorbeeld

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

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

Verkrijg wisselkoersen voor meerdere valutaparen in één verzoek.

Parameters

Naam Type Vereist Beschrijving
q string Ja Kommagescheiden paren in BASIS_KOERS formaat

Voorbeeld

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

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

Reken een specifiek bedrag om van de ene valuta naar de andere.

Parameters

Naam Type Vereist Beschrijving
from string Ja Bronvalutacode (hoofdletters)
to string Ja Doelvalutacode (hoofdletters)
amount number Ja Te converteren bedrag

Voorbeeld

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

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

Codevoorbeelden

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

Foutcodes

Code Type Beschrijving
400 BAD_REQUEST Ongeldige verzoekparameters of ontbrekende verplichte velden.
401 UNAUTHORIZED API-token ontbreekt of is ongeldig.
403 FORBIDDEN Toegang geweigerd. Uw account is mogelijk inactief.
413 PAYLOAD_TOO_LARGE Verzoekgrootte overschrijdt de maximaal toegestane grootte.
429 RATE_LIMIT_EXCEEDED U heeft uw snelheidslimiet overschreden. Controleer de X-RateLimit headers.
500 INTERNAL_ERROR Er is een interne serverfout opgetreden. Probeer het opnieuw.