Changelog
Jede Änderung an der Data API und ihrem Vertrag, neueste zuerst. Versionsnummern folgen der Versionierungs- und Abkündigungsrichtlinie.
/mcp akzeptiert den MCP-Key jetzt auch als Header X-API-Key: YOUR_API_KEY, gedacht für Clients und Gateways wie Smithery, die den Authorization-Header für ihre eigene Anmeldung reservieren. Authorization: Bearer funktioniert nach wie vor und bleibt der dokumentierte Standard; werden beide Header gesendet, wird der Key aus X-API-Key geprüft. Die Data API unter /api/v1 akzeptiert weiterhin nur Bearer-Keys. Fehlgeschlagene Authentifizierungsversuche werden jetzt sowohl pro Key als auch pro IP gedrosselt, sodass der ungültige Key eines Clients andere Clients hinter derselben IP-Adresse nicht mehr aussperrt.
GET /calculators/compound-interest rundete die Laufzeit auf ganze Zinsperioden, sodass eine Laufzeit, die mitten in einer Periode endete, zu lang oder zu kurz simuliert wurde: 6 Monate mit annually-Verzinsung liefen ein ganzes Jahr (12 Einzahlungen und ein volles Jahr Zinsen), 5 Monate dagegen keine einzige Periode (keine Einzahlungen, keine Zinsen). Ganze Perioden laufen jetzt wie bisher, die letzte angebrochene Periode wird anteilig verzinst (einfache Zinsen für den Bruchteil), und jede Einzahlung innerhalb der Laufzeit wird gezählt. Entspricht die Laufzeit einer ganzen Zahl von Zinsperioden, bleiben die Ergebnisse unverändert; Parameter und Antwortfelder bleiben unverändert.
Die API und ihre Dokumentation behandelten rate als Zinssatz pro Zinsperiode, während der Rechner auf der Website und seine Anleitung einen Jahreszins verwendeten. GET /calculators/compound-interest wandte rate in voller Höhe auf jede Zinsperiode an, sodass 5 % bei monatlicher Verzinsung wie 5 % pro Monat wuchsen. rate ist jetzt der nominale Jahreszins: Jede Periode bringt rate geteilt durch die Anzahl der Perioden pro Jahr (5 % bei monatlicher Verzinsung ergeben 5/12 % pro Monat), wie meta.note jetzt angibt. Parameter und Antwortfelder bleiben unverändert; die Ergebnisse ändern sich bei jeder Verzinsungshäufigkeit außer annually. Unabhängig davon werden Einzahlungen, wenn contribution_frequency und compound_frequency beide daily oder beide weekly sind, nicht mehr durch Gleitkomma-Rundungsfehler verzögert oder ausgelassen, sodass total_contributions bei duration_unit=months um eine Einzahlung höher ausfallen kann. Damit ändert sich die Bedeutung eines bestehenden Parameters: Um frühere Ergebnisse zu reproduzieren, multiplizieren Sie Ihren rate mit der Anzahl der Zinsperioden pro Jahr.
Jeder Fear-&-Greed-Wert enthält jetzt index neben score: den Fear-&-Greed-Index von 0–100 genau so, wie Bitculator ihn anzeigt (0–19 extreme Angst, 20–39 Angst, 40–59 neutral, 60–79 Gier, 80–100 extreme Gier) — verwenden Sie ihn für die Anzeige. score bleibt unverändert: der rohe Gesamtwert von −100…+100, aus dem index abgeleitet wird. Gilt für GET /sentiment/fear-greed (den Hauptwert und jeden Eintrag in intervals), fear_greed bei GET /global und meta.fear_greed bei GET /global/heatmap. Rein additiv; kein bestehendes Feld wurde geändert.
GET /coins/{slug} lieferte fully_diluted_valuation als 0 für Coins ohne maximales Angebot (zum Beispiel Solana und Ethereum, deren Angebot nicht begrenzt ist). Jetzt wird auf das Gesamtangebot zurückgegriffen, und der Wert ist null, wenn keines von beiden bekannt ist, wie es der OpenAPI-Vertrag bereits dokumentierte.
marketcap und dominance können für einen Coin ohne zirkulierendes Angebot null sein, und score und breakdown des Trust-Scores sind für eine Börse ohne Rang null. POST /alarms antwortet mit 422, wenn der Coin für die gewählte Metrik keinen aktuellen Wert hat. /coins/recently-added und /wallets/timeline berücksichtigen jetzt sort. /coins/gainers und /coins/losers sind nach der Veränderung selbst sortiert (bisher faktisch nach Marktkapitalisierung), und die Losers schließen Coins bei 0.00 aus. Aufsteigende Sortierungen liefern Null-Werte zuletzt. /prices löst ein mehrdeutiges Symbol zum höchstplatzierten aktiven Coin auf. Der OpenAPI-Vertrag kennzeichnet die nullbaren Marktfelder und typisiert das 24h-Volumen als Zahl.
Der veröffentlichte Vertrag enthält jetzt Beispiele auf Media-Type-Ebene, ein gemeinsames Fehlerschema, auf das jede 4xx/5xx-Antwort verweist, die Antworten 401, 429 und 500, die jeder Aufruf mit Key zurückgeben kann, die Header X-RateLimit-* und X-Quota-* auf jeder Erfolgsantwort, die alarm.triggered-Zustellung als Callback auf POST /webhooks sowie Metadaten zu Kontakt, Lizenz und Nutzungsbedingungen. Kein Request und keine Response hat sich geändert - nur, wie sie beschrieben werden.
Neu: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), ein JSON-Schema-Bundle der gemeinsamen Antwortformen, eine öffentliche Statusseite mit JSON-Zwilling, dieses Changelog sowie die Versionierungs- und Abkündigungsrichtlinie.
Der MCP-Server ist auf eigene Keys und Pläne umgezogen, erstellt in der MCP-Konsole. Data-API-Keys werden unter /mcp nicht mehr akzeptiert; jeder Tool-Aufruf kostet weiterhin eine Anfrage.
Der Bitculator-MCP-Server ist unter /mcp live gegangen: 19 schreibgeschützte Tools über Streamable HTTP für Claude, Cursor, VS Code und jeden MCP-Client, mit denselben Dezimal-String-Daten wie die REST API.
Clients für TypeScript, Python, PHP, Go, Rust, Java, C# und C++, jeder deckt jeden Endpunkt ab und sitzt auf demselben Transportkern: Bearer-Auth, Entpacken des Envelopes, Erfassung von X-Quota-*, Retries bei 429 und 5xx, typisierte Fehler und Paging.
Einige Endpunkte und längere Indikator-Zeitfenster erfordern jetzt Starter oder Pro. Ein Aufruf außerhalb deines Plans liefert 403 plan_required, wobei details.required_plan den Plan nennt, der ihn freischaltet - und verbraucht kein Kontingent.
Launch: 85 Operationen in 15 Gruppen - Coins, Kurse, Märkte, Börsen, Wallets, Global, Sentiment, Indikatoren, Liquidationen, Umrechnung, Rechner, Redaktionelles, Alarme, Webhooks und Meta. Bearer-Keys mit der data-api-Berechtigung, der { data, meta }-Envelope, Dezimal-String-Präzision, X-Quota-*-Header, signierte Webhooks sowie die Pläne Free, Starter und Pro mit jeweils eigenem Monatskontingent.
Abkündigungen werden hier und per E-Mail an jeden Key-Inhaber mindestens sechs Monate vor der Entfernung angekündigt - siehe die Abkündigungsrichtlinie. Der maschinenlesbare Index unter /apis.json trägt das Datum des neuesten Eintrags als modified-Stempel.