CoinGecko mit Google Sheets verbinden

1. Legen Sie fest, was die Preisübersicht leisten soll, bevor Sie das Tabellenblatt erstellen

Beginnen Sie mit einer kurzen Spezifikation statt mit einer Formel. Listen Sie die Coins, Kurswährungen und Aktualisierungsintervalle auf und legen Sie fest, ob Sie den aktuellen Preis, historische Werte oder beides benötigen. Eine Tabelle zur Beobachtung von BTC und ETH in USD erfüllt einen anderen Zweck als eine Tabelle, die ein gemischtes Portfolio in EUR und GBP erfasst.

Halten Sie die erste Version klein. Verfolgen Sie beispielsweise drei Coins in einer Währung und aktualisieren Sie die Daten einmal pro Stunde. Fügen Sie erst dann weitere Zeilen oder Währungen hinzu, wenn Sie geprüft haben, ob die Ergebnisse mit den von CoinGecko angezeigten Daten übereinstimmen. Das erforderliche Anfragevolumen und die verfügbaren Aktualisierungsoptionen hängen von der gewählten Zugriffsmethode und den jeweiligen Kontobedingungen ab. Prüfen Sie daher die aktuellen Limits, bevor Sie einen Zeitplan festlegen.

Legen Sie fest, was in Ihrer Tabelle als „Preis“ gilt. Ein aktueller Kurs ist ein Wert zu einem bestimmten Zeitpunkt und kein garantierter Ausführungspreis. Wenn Sie ihn mit einem Trade vergleichen möchten, speichern Sie den Zeitstempel des Kurses und behandeln Sie ein verzögertes oder zwischengespeichertes Ergebnis nicht als Live-Kurs.

2. Wählen Sie eine API-Zugriffsmethode, die zu Ihrer Einrichtung passt

Es gibt drei gängige Möglichkeiten, CoinGecko-Daten mit Google Sheets zu verbinden: ein Sheets-Add-on, ein kleines Apps Script oder einen Drittanbieter-Connector. Für technisch weniger versierte Nutzer ist ein Add-on oft der schnellste Weg. Mit einem Script haben Sie mehr Kontrolle über das Format der Anfragen und die Speicherung der Daten. Ein Connector erspart Ihnen möglicherweise das Programmieren, bringt aber einen weiteren Dienst mit sich, den Sie überprüfen müssen, falls die Aktualisierung nicht mehr funktioniert. Wenn Sie CoinGecko API mit Google Sheets verbinden möchten, wählen Sie die Methode anhand ihrer Authentifizierung, Anfragekontingente und Wartungsanforderungen.

Vergleichen Sie vor der Auswahl Authentifizierung, Anfragekontingente und Wartungsaufwand. Klären Sie, ob die Methode einen API-Schlüssel benötigt, wo dieser gespeichert wird, welche Aktualisierungsfrequenz unterstützt wird und ob die Limits für die geplante Anzahl an Coins und Währungen ausreichen. Die API-Zugriffsoptionen und Nutzungsbedingungen von CoinGecko können sich ändern. Informieren Sie sich daher in der Dokumentation über die aktuellen Anforderungen.

Wenn Sie Apps Script verwenden, öffnen Sie den Script-Editor der Tabelle und erstellen Sie eine Funktion, die Daten von CoinGecko abruft, die Antwort ausliest und ausgewählte Felder in ein Tabellenblatt schreibt. So können Sie CoinGecko Preise mit Apps Script importieren und die Aktualisierungslogik an Ihre Tabelle anpassen. Ein einfaches Script lässt sich leichter überprüfen, wenn es nur eine Aufgabe erfüllt und verständliche Fehlermeldungen ausgibt. Speichern Sie einen privaten API-Schlüssel nicht in einer Zelle, die für alle Personen sichtbar ist, die Zugriff auf die Tabelle haben.

Wenn Sie noch verschiedene Tools vergleichen, behandelt der Leitfaden dazu, was eine gute Kryptobörse ausmacht, eine andere Frage: die Wahl einer Handelsplattform statt einer Datenquelle. Diese Entscheidungen getrennt zu betrachten, hilft dabei, einen API-Datenfeed nicht mit einem Börsenkonto zu verwechseln.

3. Erstellen Sie eine Zuordnungstabelle für Coins und Währungen

Verwenden Sie in Anfragen CoinGecko-Coin-IDs und nicht ausschließlich Tickersymbole. Ein Ticker kann von verschiedenen, nicht miteinander verbundenen Projekten verwendet werden. Eine ID hingegen gibt der API ein bestimmtes Asset zur Suche vor. Erstellen Sie einen Tab namens „Lookup“ mit Spalten für Anzeigename, CoinGecko-ID, Ticker und Zielwährung.

Die ersten beiden Zeilen zeigen, welche Art von Kennung Sie speichern sollten. Prüfen Sie jede ID bei CoinGecko, bevor Sie sich darauf verlassen. Ein Ticker eignet sich als Bezeichnung, sollte aber in einer Anfrage nicht die ID ersetzen. Das ist besonders wichtig, wenn ein Portfolio einen kleinen Token enthält, dessen Symbol dem eines anderen Projekts ähnelt.

Verwenden Sie Währungscodes in einem einheitlichen Format, beispielsweise kleingeschrieben als usd oder eur, sofern dies vom gewählten Endpunkt erwartet wird. Mit einer Datenvalidierungsregel in Google Sheets können Sie die Währungsspalte auf die von Ihrer Einrichtung unterstützten Währungen beschränken. So verhindern Sie einfache Tippfehler wie usdd, die sonst an die API übermittelt würden.

4. Rufen Sie aktuelle Preise ab und speichern Sie sie in einer übersichtlichen Datentabelle

Trennen Sie die rohen API-Daten von dem Tabellenblatt, in dem Preise angezeigt werden. In einem Tab namens „Raw“ können Sie die Antwort oder die zuletzt importierten Werte speichern. Ein Tab namens „Prices“ kann Coin-Name, Ticker, Währung, Preis und Zeitstempel anzeigen. Diese Trennung erleichtert es, die Formatierung zu ändern, ohne versehentlich die Anfragelogik zu beschädigen.

Bei einer typischen Anfrage für aktuelle Preise werden die ausgewählten Coin-IDs und die Kurswährung an den Preis-Endpunkt von CoinGecko übermittelt. Die genaue URL, die Parameter, die Authentifizierungsmethode und die Antwortfelder hängen vom API-Produkt und der Zugriffsmethode ab. Einzelheiten zum Endpunkt finden Sie in der Dokumentation von CoinGecko. Ordnen Sie den zurückgegebenen Wert in der Tabelle der passenden ID zu, statt anzunehmen, dass die Reihenfolge der Antwort immer mit den von Ihnen eingegebenen Zeilen übereinstimmt.

Ihre Tabelle könnte beispielsweise „Bitcoin | BTC | USD | Preis | Aktualisiert am“ anzeigen. Formatieren Sie die Preisspalte als Zahl mit einer passenden Anzahl an Nachkommastellen, bewahren Sie für die verfolgten Assets aber genügend Genauigkeit. Den angezeigten Wert zu runden, ist eine Formatierungsentscheidung. Den gespeicherten Wert zu runden, kann spätere Berechnungen verfälschen.

Wer Kryptokurse in Google Sheets abrufen möchte, sollte mit einem Coin und einer Währung beginnen und prüfen, ob ID, Währung und Kurs mit der Quelle übereinstimmen. Sobald das funktioniert, können Sie die Zuordnungstabelle erweitern und jede neue Zeile testen. Ein großes Dashboard aufzubauen, macht zwar mehr Spaß, aber mit dieser Vorgehensweise entdecken Sie falsch zugeordnete IDs frühzeitig.

Verwenden Sie Formeln für Berechnungen und nicht dazu, fehlende Daten zu verschleiern. Schlägt eine Anfrage fehl, zeigen Sie eine klare Meldung wie „Anfragefehler“ an oder lassen Sie den Fehler sichtbar, statt den Wert als null auszugeben, als wäre das Asset wertlos geworden. Ein Nullwert kann Portfoliosummen beeinflussen und Entscheidungen auslösen, die nichts mit dem Markt zu tun haben.

5. Planen Sie Aktualisierungen und berücksichtigen Sie Anfragekontingente

Eine automatische Aktualisierung ist nur dann sinnvoll, wenn sie in einem von Ihrem API-Zugang erlaubten Intervall ausgeführt wird. Aktualisierungsoptionen von Add-ons, Apps-Script-Trigger und Zeitpläne von Connectoren funktionieren unterschiedlich. Prüfen Sie vor dem Festlegen eines Intervalls die aktuellen Kontingente und Aktualisierungsregeln Ihrer gewählten Methode. Die genauen Limits können je nach Tarif variieren und sich ändern.

Beginnen Sie mit einem großzügigen Intervall und einer kleinen Anfrage. Wenn Sie fünf Assets verfolgen, vermeiden Sie separate Anfragen für jede einzelne Zelle, sofern sich die benötigten Werte mit einer einzigen Anfrage abrufen lassen. Weniger Anfragen können die Pflege der Tabelle erleichtern. Prüfen Sie aber, ob der Endpunkt die IDs und Währungen unterstützt, die Sie gemeinsam übermitteln.

Planen Sie auch für Fehlerfälle. Die API kann eine Fehlermeldung zurückgeben, ein Dienst kann nicht verfügbar sein oder ein Kontingent kann ausgeschöpft werden. Lassen Sie den Zeitstempel der letzten erfolgreichen Aktualisierung sichtbar und ersetzen Sie gültige vorhandene Daten nicht durch eine leere Antwort, sofern Sie diese nicht ausdrücklich löschen möchten. Auch ein veralteter Kurs bleibt veraltet. Kennzeichnen Sie ihn deshalb entsprechend, statt ihn als aktuell darzustellen.

Apps-Script-Trigger können nach einem Zeitplan ausgeführt werden, unterliegen aber Googles eigenen Ausführungsgrenzen und Autorisierungsanforderungen. Prüfen Sie nach der Einrichtung den Status der Trigger und sehen Sie sich das Ausführungsprotokoll an, falls die Aktualisierungen ausbleiben. Die Limits von Google und CoinGecko sind voneinander unabhängig. Dass Sie das eine einhalten, garantiert nicht, dass jede Anfrage auch vom anderen akzeptiert wird.

6. Fügen Sie Zeitstempel hinzu und speichern Sie Preisschnappschüsse

Eine Tabelle, in der der Preis von gestern durch den heutigen ersetzt wird, zeigt nicht, was sich geändert hat. Erstellen Sie einen Tab namens „History“, in dem für jeden Coin und jede Aktualisierung eine neue Zeile mit Zeitstempel, Coin-ID, Währung und Preis gespeichert wird. Schreiben Sie jede erfolgreiche Antwort in eine neue Zeile, statt den vorherigen Datensatz zu überschreiben.

Eine solche Zeile könnte beispielsweise so aussehen: „2026-11-12 10:00 | bitcoin | usd | [zurückgegebener Wert]“. Verwenden Sie die tatsächliche Uhrzeit, die von Ihrer Verbindung oder Ihrem Script gemeldet wird, und geben Sie an, ob es sich um UTC oder die Ortszeit handelt. Der angezeigte Preis sollte mit dem Zeitstempel derselben Aktualisierung verknüpft sein und nicht mit dem Zeitpunkt, zu dem jemand die Tabelle zuletzt geöffnet hat.

Legen Sie einen Aufbewahrungsplan fest, bevor der Verlaufstab zu umfangreich wird. Je nach Zweck und Anfragekontingent können Sie für einen langfristig genutzten persönlichen Tracker beispielsweise tägliche Schnappschüsse oder für eine kurzfristige Beobachtung häufigere Datensätze speichern. Gehen Sie nicht davon aus, dass eine API-Antwort historische Daten enthält, nur weil sich in Ihrer Tabelle inzwischen Schnappschüsse angesammelt haben. Es handelt sich um unterschiedliche Datenquellen.

Mit datierten Zeilen können Sie die Veränderung zwischen zwei erfassten Werten berechnen, sofern Coin-ID und Kurswährung übereinstimmen. Ein BTC/USD-Datensatz mit einem BTC/EUR-Datensatz zu vergleichen, zeigt neben der Preisänderung auch einen Währungseffekt. Kennzeichnen Sie diese Reihen daher eindeutig, bevor Sie sie in einem Diagramm darstellen.

7. Prüfen Sie die Ergebnisse und halten Sie die Verbindung instand

Führen Sie einige Prüfungen durch, bevor Sie einem Dashboard vertrauen. Kontrollieren Sie, ob die Coin-ID stimmt, die Währungsangabe zur Anfrage passt, der zurückgegebene Preis eine Zahl ist und der Zeitstempel zu dieser Aktualisierung gehört. Vergleichen Sie anschließend ein Beispielergebnis mit der CoinGecko-Website und berücksichtigen Sie dabei, dass die beiden Ansichten möglicherweise zu unterschiedlichen Zeitpunkten aktualisiert werden.

Lassen Sie Fehlermeldungen während der Testphase sichtbar. Eine fehlgeschlagene Anfrage kann auf einen ungültigen Schlüssel, einen fehlerhaften Parameter, ein überschrittenes Kontingent oder ein vorübergehendes Dienstproblem hinweisen. Notieren Sie die Meldung und den Zeitpunkt ihres Auftretens. Wenn Sie mehrere Einstellungen gleichzeitig ändern, lässt sich die Ursache schwerer eingrenzen. Bei wiederholten Fehlern prüfen Sie die Dokumentation zum Endpunkt und Ihren Zugriffstarif.

Dokumentieren Sie, wer für das Script oder den Connector zuständig ist, wo Zugangsdaten gespeichert werden und welche Tabs gefahrlos bearbeitet werden können. Wenn jemand eine Spalte umbenennt, die ein Script erwartet, kann eine funktionierende Verbindung ausfallen, obwohl sich bei CoinGecko nichts geändert hat. Schützen Sie die Tabs mit Zuordnungen und Rohdaten vor versehentlichen Änderungen, um solche Ausfälle zu vermeiden.

Überprüfen Sie die Einrichtung, wenn CoinGecko API-Bedingungen, Authentifizierung, verfügbare Endpunkte oder Kontingente ändert, und prüfen Sie die aktuellen Details, bevor Sie eine produktiv genutzte Tabelle anpassen. Ein Test mit nur einem Coin nach jeder Änderung reicht in der Regel aus, um einen falschen Parameter zu erkennen, bevor er sich auf alle Zeilen auswirkt. Belassen Sie diesen Test in der Arbeitsmappe, damit die nächste Person ihn wiederholen kann.