Erste Schritte
Die Finexly-API bietet Echtzeit- und historische Wechselkurse für über 170 Währungen. Der Einstieg ist einfach:
- Registrieren Sie sich für ein kostenloses Konto
- Holen Sie sich Ihren API-Zugangsschlüssel vom Dashboard
- Stellen Sie Ihre erste API-Anfrage
Basis-URL
https://api.finexly.com/v1/
Authentifizierung
Alle API-Anfragen erfordern eine Authentifizierung über ein Bearer-Token. Fügen Sie Ihren API-Schlüssel im Authorization-Header ein:
Option 1: Autorisierungs-Header (Empfohlen)
Autorisierungs-Header (Erforderlich)
Authorization: Bearer YOUR_API_KEY
Option 2: Abfrageparameter
Übergeben Sie Ihren API-Schlüssel als Abfrageparameter:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Sicherheitshinweis: API-Schlüssel in URLs können in Serverzugriffsprotokollen protokolliert werden und über HTTP-Referrer-Header durchsickern. Für den Produktionseinsatz empfehlen wir die Verwendung der Authorization-Header-Methode. Der Abfrageparameter wird als praktische Lösung für schnelle Tests und einfache Integrationen bereitgestellt.
Ratenbegrenzung: Überprüfen Sie die Antwort-Header für Ihre aktuelle Nutzung:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
API-Endpunkte
/v1/currencies
Eine Liste aller unterstützten Währungscodes abrufen.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|
Beispiel
GET https://api.finexly.com/v1/currencies
// Antwort
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Den Wechselkurs für ein bestimmtes Währungspaar abrufen.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| from | string | Ja | Basiswährungscode (Großbuchstaben) |
| to | string | Ja | Kurswährungscode (Großbuchstaben) |
Beispiel
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Antwort
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Wechselkurse für mehrere Währungspaare in einer einzigen Anfrage abrufen.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| q | string | Ja | Kommagetrennte Paare im Format BASIS_KURS |
Beispiel
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Antwort
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Einen bestimmten Betrag von einer Währung in eine andere umrechnen.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| from | string | Ja | Quellwährungscode (Großbuchstaben) |
| to | string | Ja | Zielwährungscode (Großbuchstaben) |
| amount | number | Ja | Umzurechnender Betrag |
Beispiel
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Antwort
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Code-Beispiele
# 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")
Fehlercodes
| Code | Typ | Beschreibung |
|---|---|---|
| 400 | BAD_REQUEST | Ungültige Anfrageparameter oder fehlende Pflichtfelder. |
| 401 | UNAUTHORIZED | API-Token fehlt oder ist ungültig. |
| 403 | FORBIDDEN | Zugriff verweigert. Ihr Konto ist möglicherweise inaktiv. |
| 413 | PAYLOAD_TOO_LARGE | Die Anfragegröße überschreitet die maximal zulässige Größe. |
| 429 | RATE_LIMIT_EXCEEDED | Sie haben Ihr Ratenlimit überschritten. Prüfen Sie die X-RateLimit-Header. |
| 500 | INTERNAL_ERROR | Ein interner Serverfehler ist aufgetreten. Bitte versuchen Sie es erneut. |
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.