CoinGecko-API am ESP32: Gratis-Limits und Abfragerate
Der Gratis-Demo-Plan von CoinGecko: 100 Aufrufe pro Minute, 10.000 pro Monat. Wie oft ein ESP32 abfragen darf, wie du den Key sendest und was 429 heißt.
- Autor
Mauro Brambilla- Veroffentlicht
- Lesezeit
- 7 Min.
- Kategorie
- Anleitungen

Kurz gesagt
Stand November 2026 bietet der kostenlose Demo-Plan von CoinGecko 100 Aufrufe pro Minute und 10.000 pro Monat. Ein ESP32 mit Abfrage alle 6 Minuten braucht in 30 Tagen etwa 7.200, ein Gerät passt.
Die CoinGecko-API ist für Hobbyprojekte kostenlos: Der Demo-Plan kostet 0 $, braucht keine Kreditkarte und erlaubt Stand November 2026 100 Aufrufe pro Minute und 10.000 pro Monat. Ein ESP32, der einmal alle 6 Minuten abfragt, macht in 30 Tagen etwa 7.200 Aufrufe, ein Board passt also unter das Limit.
Vielleicht willst du gerade einen Ticker flashen und fragst dich, wie oft er einen Preis abrufen darf, bevor CoinGecko ihn aussperrt. In dieser Anleitung rechnen wir die Abfragerate durch, lesen die echte Firmware des Gizmo Ticker, um zu sehen, wie sie ihren Key sendet und die Aufrufe plant, und schauen uns an, was ein 429 auslöst. Die Zahlen stammen von den Preis- und Doku-Seiten von CoinGecko, die Zeiten aus dem Firmware-Quellcode.
Welche Limits hat der Demo-Plan von CoinGecko?
Der Demo-Plan ist die kostenlose Stufe von CoinGecko: ein Key, den du bei CoinGecko anforderst, mit einem Limit pro Minute und einem monatlichen Aufrufbudget. Stand November 2026 steht auf der Preisseite und der Seite zu Fehlern und Rate Limits Folgendes:
| Punkt | Demo-Plan (kostenlos) | Öffentliche API ohne Key |
|---|---|---|
| Preis | 0 $ pro Monat, keine Kreditkarte | Kostenlos |
| Rate Limit | 100 Aufrufe pro Minute | Etwa 5 Aufrufe pro Minute, IP-basiert und geteilt |
| Monatsbudget | 10.000 Aufrufe (10k Call Credits) | Nicht angegeben |
| Kosten eines Aufrufs | 1 Aufruf = 1 Credit | Nicht anwendbar |
| Namensnennung | Pflicht | Pflicht |
| Kommerzielle Lizenz | Auf der Preisseite nicht aufgeführt | Nicht enthalten; CoinGecko verweist auf einen bezahlten Plan |
| Produktivbetrieb | Für private Projekte gedacht | Nicht empfohlen |
Die Spalte ohne Key stammt von CoinGeckos Seite zur öffentlichen API ohne Key. Dort steht, dass sich alle mit derselben IP den Pool teilen, dass das tatsächliche Limit mit der Serverlast schwankt und dass sie für Produktivumgebungen nicht empfohlen wird. Ein Ticker, der den ganzen Tag unbeaufsichtigt läuft, ist näher am Produktivbetrieb als an einem schnellen Test, also nimm einen Demo-Key.
Ältere Artikel nennen oft 30 Aufrufe pro Minute für den kostenlosen Plan. Ich konnte das an keiner archivierten CoinGecko-Seite prüfen, deshalb nutzt dieser Artikel nur die Zahlen, die heute auf den Seiten stehen. Prüf sie nach, bevor du dein Design auf ein Limit baust.
Eines konnte ich nicht bestätigen: Die Preisseite sagt nicht, was im Demo-Plan passiert, wenn die 10.000 Aufrufe aufgebraucht sind. Der Text zu Überschreitungen betrifft nur die bezahlten Pläne. Bleib lieber unter dem Limit, statt es auszuprobieren.
Wie viele Aufrufe pro Monat braucht ein ESP32?
Ein Monat mit 30 Tagen hat 43.200 Minuten. Jede Abfrage ist ein Aufruf, also gilt:
Aufrufe pro Monat = 43.200 ÷ Intervall in Minuten
Damit bekommst du das Budget für jedes Intervall. Das Limit liegt bei 10.000, das kürzeste sichere Intervall für ein Gerät ist also 43.200 ÷ 10.000 = 4,32 Minuten. Ein Monat mit 31 Tagen erhöht die Summe um etwa 3 % (44.640 Minuten), womit die Grenze bei etwa 4,5 Minuten liegt. In der Praxis sind 5 Minuten die Untergrenze, wenn du etwas Spielraum willst.

| Abfrageintervall (min) | Aufrufe pro Stunde | Aufrufe in 30 Tagen | Unter dem Limit von 10.000? |
|---|---|---|---|
| 1 | 60 | 43.200 | Nein |
| 2 | 30 | 21.600 | Nein |
| 4 | 15 | 10.800 | Nein |
| 5 | 12 | 8.640 | Ja |
| 6 (Gizmo Ticker) | 10 | 7.200 | Ja |
| 10 | 6 | 4.320 | Ja |
| 15 | 4 | 2.880 | Ja |
Beachte, dass das Limit pro Minute hier nie eine Rolle spielt. Bei einem Aufruf alle 6 Minuten nutzt du etwa 0,2 % der 100 Aufrufe pro Minute. Das Monatsbudget bremst ein Gerät aus, und zwar gnadenlos.
Wie fragt der Gizmo Ticker CoinGecko ab?
Der Ticker fragt einmal alle 6 Minuten ab. In market_refresh.h steht die Konstante MARKET_REFRESH_INTERVAL_MS auf 360000, und ein fehlgeschlagener Aufruf wird nach MARKET_RETRY_INTERVAL_MS wiederholt, das sind 30000 (30 Sekunden). Die Planungslogik steckt in market_refresh.cpp.

Warum 6 Minuten? Das Repository hält den Grund nicht fest, also erfinde ich keinen. Die Rechnung zeigt, dass bei 6 Minuten in einem Monat mit 30 Tagen etwa 2.800 von 10.000 Aufrufen übrig bleiben (in einem mit 31 Tagen etwa 2.560). Diesen Puffer verbraucht alles, was keine geplante Abfrage ist:
- Eine Abfrage direkt nach dem Booten, weil der Zeitplan mit einer bereits offenen Anfrage startet.
- Eine Abfrage, nachdem du einen neuen API-Key speicherst oder die Münze in der Web-App änderst.
- Die Retries im 30-Sekunden-Takt, solange ein Aufruf weiter fehlschlägt.

Werden die Daten alt, sagt dir die Firmware das. Vergehen 12 Minuten (MARKET_STALE_AFTER_MS, das Doppelte des Aktualisierungsintervalls) ohne Erfolg, beginnt die Matrix jeden Durchlauf mit Prices from N min ago. und dem letzten Fehler. Den ganzen Aufbau findest du in So baust du einen Krypto-Ticker mit ESP32 und MAX7219.
Wie sendest du den Demo-Key von einem ESP32?
Die Demo-Authentifizierungsdoku von CoinGecko nennt zwei Möglichkeiten: den Header x-cg-demo-api-key (empfohlen) oder den Query-Parameter x_cg_demo_api_key. Die Basis-URL für einen Demo-Key ist https://api.coingecko.com/api/v3/. Die Firmware in api.cpp nutzt den Header:
const char marketApiUrlTemplate[] = "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=%s&price_change_percentage=24h";
const char apiKeyHeaderName[] = "x-cg-demo-api-key";
...
http.setTimeout(5000);
http.addHeader("Accept", "application/json");
http.addHeader(apiKeyHeaderName, getDeviceConfig().apiKey);
const int httpCode = http.GET();
if (httpCode != HTTP_CODE_OK) {
http.end();
return false;
}Ein Header hält den Key außerdem aus der Anfrage-URL heraus, die die Firmware in ihr serielles Log schreibt (Requesting URL: ...). Diese Überlegung zum Header stammt von mir, nicht von CoinGecko. Jede Abfrage ist eine einzelne /coins/markets-Anfrage für eine Münze, deshalb kostet eine Abfrage einen Aufruf. Die Firmware fordert über einen ArduinoJson-Filter außerdem nur die Felder an, die sie anzeigt, um Speicher zu sparen.
Der Key steht nie im Code. Du fügst ihn auf der Seite API Key der Web-App des Boards ein, und er wird auf dem Board in einem Puffer von 35 Bytes gespeichert, also höchstens 34 Zeichen. Ohne Key ruft die Firmware CoinGecko gar nicht erst auf und lässt stattdessen API key is not present. durchlaufen. Zum Eingeben muss das Board zuerst in deinem WLAN sein: Der Vergleich der WLAN-Provisioning-Methoden erklärt, wie der Einrichtungs-Hotspot funktioniert.
Bevor du feierst, teste den Key am Computer:
curl -s -o /dev/null -w "%{http_code}\n" -H "x-cg-demo-api-key: YOUR_KEY" "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin"Ein 200 heißt, der Key funktioniert. Laut CoinGeckos Fehlerliste bedeutet ein 401 einen fehlenden oder ungültigen Key, und der Fehlercode 10011 heißt, dass du einen Demo-Key an den falschen Host geschickt hast.
Was passiert, wenn der ESP32 HTTP 429 bekommt?
HTTP 429 heißt "Too Many Requests": Du hast das Rate Limit überschritten. CoinGecko zählt jede Anfrage auf das Limit, auch solche, die 4xx- und 5xx-Fehler liefern, Fehler verschaffen einem scheiternden Gerät also keinen Freifahrtschein. Die Doku rät, die Aufrufhäufigkeit zu senken oder den Plan zu wechseln.
Und was macht der Ticker? Alles, was kein 200 ist, wird gleich behandelt: fetchMarketData gibt false zurück, der Zeitplan wählt den Retry nach 30 Sekunden, und die Matrix zeigt weiter die letzten guten Daten. Es gibt keinen Sonderfall für 429 und kein Backoff, und die Firmware liest keinen Rate-Limit-Header. Auch Retry-After oder Rate-Limit-Header habe ich auf CoinGeckos Fehlerseite nicht beschrieben gefunden, ich kann dir also nicht sagen, was der Server sendet.
Ist das ein Problem? Mit einem Gerät kaum. Ein dauerhafter Retry alle 30 Sekunden sind 2 Aufrufe pro Minute, weit unter 100. Das Risiko ist ein anderes: Bei einem langen Ausfall auf einer der beiden Seiten summieren sich diese Retries. Eine Stunde voller Fehlschläge sind etwa 120 Aufrufe, über 1 % des Monatsbudgets. Wenn du die Firmware änderst, ist ein exponentielles Backoff die sinnvolle Anpassung, das CoinGecko selbst für die API ohne Key empfiehlt. Ob ein fehlgeschlagener Aufruf auch einen Monats-Credit verbraucht, ist für den Pro-Plan dokumentiert (nein, laut der Pro-Authentifizierungsseite), für Demo aber nicht, also würde ich mich nicht darauf verlassen.
Wenn du auf einem echten Ticker ein 429 siehst, ändere immer nur eine Sache auf einmal:
- Prüfe, wie viele Geräte den Key nutzen. Das Kontingent gehört zum Key, zwei Boards mit Abfrage alle 6 Minuten machen also etwa 14.400 Aufrufe in 30 Tagen.
- Prüfe, ob sonst nichts den Key benutzt, etwa ein Skript oder ein zweites Projekt.
- Verlängere das Abfrageintervall. Bei 10 Minuten kann ein Key 2 Boards versorgen (8.640 Aufrufe).
Gehört der Key nicht dir, frag zuerst den Besitzer.
Welche Alternativen gibt es, wenn der kostenlose Plan nicht reicht?
Bei CoinGecko selbst gibt es zwei Wege. Die API ohne Key braucht keine Anmeldung, ist aber geteilt und auf etwa 5 Aufrufe pro Minute begrenzt, und CoinGecko empfiehlt sie nicht für den Produktivbetrieb. Ein bezahlter Plan hebt die Limits an und bringt eine kommerzielle Lizenz mit, die Preisseite listet die Pläne auf. Andere Preisanbieter habe ich nicht verglichen, deshalb kann ich nichts über deren kostenlose Stufen sagen.
Ein günstigerer Trick ist, seltener abzufragen. Krypto-Preise bewegen sich den ganzen Tag, aber ein Deko-Display braucht keine minutengenauen Werte. Von 6 auf 10 Minuten zu gehen senkt die Monatsaufrufe von 7.200 auf 4.320 und schafft Platz für ein zweites Gerät oder für Retries.
Noch etwas: Demo-Daten verlangen eine Namensnennung. Wenn du ein Projekt veröffentlichst, das CoinGecko-Preise zeigt, folge dem Attribution Guide von CoinGecko, den die Preisseite in der Demo-Zeile verlinkt.
Was haben wir geprüft, und was bleibt offen?
Wir haben den Demo-Plan Stand November 2026 mit den CoinGecko-Seiten abgeglichen: 100 Aufrufe pro Minute, 10.000 Aufrufe pro Monat, 1 Aufruf = 1 Credit. Wir haben ausgerechnet, dass eine Abfrage alle 6 Minuten in 30 Tagen etwa 7.200 Aufrufe kostet, die Firmware gelesen, um Header, Endpoint und die Zeiten von 6 Minuten und 30 Sekunden zu bestätigen, und gesehen, dass ein 429 denselben festen Retry bekommt wie jeder andere Fehler.
Ich habe nicht getestet, was bei 10.000 Aufrufen passiert, und CoinGeckos Zahlen haben sich schon früher geändert. Wirf also einen Blick auf die Preisseite, wenn ein Ticker nach Monaten plötzlich Fehler zeigt. Die Firmware nutzt außerdem einen HTTPS-Client ohne Zertifikatsprüfung, wie in der Bauanleitung erwähnt.
Und wenn du das Display noch verkabelst, lies als Nächstes die Verkabelungsanleitung für das MAX7219 FC16. Das Gesamtbild der Projektfamilie findest du unter Was ist OpenGizmo.
Haufig gestellte Fragen
Finden Sie schnelle Antworten auf die haufigsten Fragen zu diesem Thema.
Ja. Der Demo-Plan von CoinGecko kostet 0 $ pro Monat, braucht keine Kreditkarte und erlaubt Stand November 2026 100 Aufrufe pro Minute und 10.000 pro Monat. CoinGecko verlangt eine Namensnennung, und die Preistabelle führt eine kommerzielle Lizenz nur bei den bezahlten Plänen auf. Ein privater Ticker ist also der vorgesehene Einsatz.
Autor
Mauro BrambillaLust, dein eigenes Gizmo zu bauen?
Such dir ein Open-Source-Projekt mit dem ESP32 aus und folge der Schritt-für-Schritt-Anleitung, von der Teileliste und der Verkabelung bis zur Firmware und zum ersten Start.





