Erste Schritte

Die Finexly-API bietet Echtzeit- und historische Wechselkurse für über 170 Währungen. Der Einstieg ist einfach:

  1. Registrieren Sie sich für ein kostenloses Konto
  2. Holen Sie sich Ihren API-Zugangsschlüssel vom Dashboard
  3. 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:

Autorisierungs-Header (Erforderlich)

Authorization: Bearer YOUR_API_KEY

Ratenbegrenzung: Überprüfen Sie die Antwort-Header für Ihre aktuelle Nutzung: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-Endpunkte

GET /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"
]
GET /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
}
GET /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
    }
}
GET /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

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

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.