Aan de slag
De Finexly API biedt realtime en historische wisselkoersen voor meer dan 170 valuta's. Aan de slag gaan is eenvoudig:
- Registreer voor een gratis account
- Haal je API-toegangssleutel van het dashboard
- 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:
Optie 1: Autorisatieheader (Aanbevolen)
Autorisatieheader (Vereist)
Authorization: Bearer YOUR_API_KEY
Optie 2: Queryparameter
Geef uw API-sleutel door als een queryparameter:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Beveiligingsnotitie: API-sleutels in URL's kunnen worden vastgelegd in servertoegangslogboeken en kunnen lekken via HTTP Referrer-headers. Voor productiegebruik raden we de Authorization-header methode aan. De queryparameter wordt aangeboden als een gemak voor snel testen en eenvoudige integraties.
Rate Limiting: Controleer de response headers voor uw huidige gebruik:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
API-eindpunten
/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"
]
/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
}
/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
}
}
/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
# 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")
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. |
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.