Anfragelimits & Tarife

Zwei Arten von Limits

Jeder Tarif hat ein Monatskontingent, also die Zahl der berechneten Anfragen pro Kalendermonat, und ein Limit pro Minute, das die API vor Lastspitzen schützt. Kontingente werden am 1. jedes Monats um 00:00 UTC zurückgesetzt.

Die Tarife unterscheiden sich außerdem im Aktualisierungsintervall, also darin, wie aktuell die Preise sind. Fragen Sie häufiger ab, als Ihr Intervall vorgibt, erhalten Sie dieselben Preise erneut und verbrauchen nur Kontingent.

Die Tarife im Überblick

• Free: 100 Anfragen/Monat, tägliche Aktualisierung, 10 Anfragen/Minute
• Lite: 1.000 Anfragen/Monat, Aktualisierung alle 30 Minuten, 30 Anfragen/Minute
• Standard: 10.000 Anfragen/Monat, Aktualisierung alle 10 Minuten, 60 Anfragen/Minute
• Advanced: 50.000 Anfragen/Monat, Aktualisierung alle 60 Sekunden, 120 Anfragen/Minute
• Pro: 100.000 Anfragen/Monat, Aktualisierung alle 60 Sekunden, 300 Anfragen/Minute
• Ultra: 500.000 Anfragen/Monat, Aktualisierung alle 15 Sekunden, 600 Anfragen/Minute
• Business: 500.000 Anfragen/Monat, Aktualisierung alle 15 Sekunden, 600 Anfragen/Minute, dazu ein Verfügbarkeits-SLA
• Enterprise: 1.500.000 Anfragen/Monat, Aktualisierung alle 5 Sekunden, 1.200 Anfragen/Minute

Auch der Funktionsumfang wächst mit dem Tarif. Karatpreise erfordern einen kostenpflichtigen Tarif, Geld-/Briefkurse gibt es ab Standard, Webhook-Alarme ab Advanced und den Echtzeit-Stream ab Pro. Die aktuellen Preise finden Sie unter Preise.

Was als Anfrage zählt

• Jeder erfolgreiche Aufruf eines Datenendpunkts zählt als eine Anfrage, unabhängig davon, wie viele Symbole er zurückgibt.
• /symbols und /usage sind kostenlos und werden nie gezählt.
• Anfragen, die mit 104 (Limit pro Minute), 106 (nicht in Ihrem Tarif enthalten), 107 (Origin nicht erlaubt) oder einem Serverfehler (500, 503) abgelehnt werden, werden nicht berechnet.
• Anfragen, die an der Abfrage selbst scheitern, zählen dagegen. Das betrifft die Validierungsfehler 201 bis 210 sowie 300 (keine Ergebnisse). Prüfen Sie Datumsangaben und Symbole daher, bevor Sie sie senden.

Nutzung verfolgen

Jede authentifizierte Antwort meldet Ihr Kontingent in Headern:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9876
X-RateLimit-Used: 124
X-RateLimit-Reset: 1793491200
X-RateLimit-Reset-Date: 2026-11-01T00:00:00.000Z
X-RateLimit-Plan: Standard
X-RateLimit-Minute-Limit: 60
X-RateLimit-Minute-Remaining: 59

Dieselben Werte stehen im rate_limit-Objekt des JSON-Bodys. reset ist ein Unix-Zeitstempel und reset_date derselbe Zeitpunkt im ISO-8601-Format: der Beginn des nächsten Monats in UTC.

Nutzung prüfen, ohne Kontingent zu verbrauchen

Rufen Sie /usage aus Dashboards oder Ihrem Monitoring auf. Der Endpunkt ist kostenlos:

{
  "success": true,
  "usage": {
    "requests_made": 124,
    "requests_quota": 10000,
    "requests_remaining": 9876,
    "plan": "standard",
    "period_start": "2026-10-01T00:00:00.000Z",
    "period_end": "2026-11-01T00:00:00.000Z"
  },
  "result": { "plan": "Standard", "used": 124, "total": 10000, "remaining": 9876 },
  "rate_limit": {
    "limit": 10000,
    "remaining": 9876,
    "reset": 1793491200,
    "used": 124,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Wenn Sie ein Limit erreichen

Beide Limits antworten mit HTTP-Status 429 und einem Fehler-Body:

• 104 too_many_requests: zu viele Anfragen in der laufenden Minute. Die Antwort enthält einen Retry-After-Header mit der Anzahl der Sekunden, die Sie warten sollten. Drosseln Sie das Tempo und versuchen Sie es erneut.
• 105 quota_exceeded: Das Monatskontingent ist aufgebraucht. Anfragen schlagen weiter fehl, bis das Kontingent am 1. (UTC) zurückgesetzt wird. Ein Tarif-Upgrade wirkt sofort.

{
  "success": false,
  "error": {
    "code": 105,
    "type": "quota_exceeded",
    "info": "User has reached or exceeded his subscription plan's monthly API request allowance"
  }
}

Im Kontingent bleiben

• Cachen Sie Antworten mindestens für die Dauer des Aktualisierungsintervalls Ihres Tarifs.
• Fragen Sie alle benötigten Symbole in einem Aufruf ab, statt einen Aufruf pro Symbol zu senden.
• Eine Abfrage alle 10 Minuten verbraucht etwa 4.500 Anfragen im Monat, eine Abfrage pro Minute etwa 45.000. Wählen Sie den Tarif passend zu Ihrer Abfragefrequenz.
• Nutzen Sie ab Pro den Echtzeit-Stream statt Polling und reagieren Sie mit Preisalarmen auf Schwellenwerte.

Weitere Tipps finden Sie unter Best Practices.