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. |
KI-Connectoren (MCP)
Finexly spricht das Model Context Protocol, sodass ein KI-Assistent die Kurse direkt lesen kann, anstatt sie übergeben zu bekommen. Dies ist ein separater Kanal von der untenstehenden REST-API: Er authentifiziert sich mit OAuth anstelle eines API-Schlüssels und ist schreibgeschützt.
Server-URL
https://mcp.finexly.com
Verfügbare Werkzeuge
| Name | Beschreibung |
|---|---|
| get_exchange_rate | Der aktuelle Wechselkurs zwischen zwei Währungen. |
| convert_amount | Konvertieren Sie einen Betrag, der bei Bedarf über den US-Dollar umgerechnet wird. |
| list_currencies | Jede Währung, die wir abdecken. |
| get_historical_rates | Tägliche Raten über einen Zeitraum, für Paare direkt gesammelt. |
Autorisierung
Der Connector führt einen OAuth 2.1-Autorisierungscodefluss mit PKCE durch. Die Entdeckung erfolgt über die untenstehenden URLs; der einzige Scope ist fx:read, und es gibt keinen Scope, der den Zugriff auf Konten gewährt.
- https://finexly.com/.well-known/oauth-authorization-server
- https://finexly.com/oauth/authorize
- https://finexly.com/oauth/token
- https://finexly.com/oauth/jwks
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.