Changelog
Hver ændring af Data API'et og dets kontrakt, nyeste først. Versionsnumrene følger politikken for versionering og udfasning.
/mcp accepterer nu også MCP-nøglen som en X-API-Key: YOUR_API_KEY-header af hensyn til klienter og gateways som for eksempel Smithery, der reserverer Authorization til deres eget login. Authorization: Bearer virker fortsat og forbliver den dokumenterede standard; når begge headers sendes, er X-API-Key den nøgle, der kontrolleres. Data API'et på /api/v1 accepterer stadig kun Bearer-nøgler. Mislykkede godkendelsesforsøg begrænses nu både pr. nøgle og pr. IP, så én klients ugyldige nøgle ikke længere blokerer andre klienter bag samme IP.
GET /calculators/compound-interest afrundede varigheden til hele rentetilskrivningsperioder, så en varighed, der sluttede midt i en periode, blev simuleret for lang eller for kort: 6 måneder med annually-tilskrivning løb et helt år (12 indskud og et helt års renter), og 5 måneder løb slet ingen periode (ingen indskud, ingen renter). Hele perioder kører nu som før, den sidste delvise periode giver forholdsmæssig rente (simpel rente for brøkdelen), og hvert indskud inden for varigheden tælles med. Resultaterne er uændrede, når varigheden er et helt antal rentetilskrivningsperioder; parametre og svarfelter er uændrede.
API’et og dokumentationen behandlede rate som renten pr. renteperiode, mens beregneren på hjemmesiden og dens vejledning brugte en årlig rente. GET /calculators/compound-interest anvendte hele rate på hver renteperiode, så 5 % med månedlig rentetilskrivning voksede som 5 % om måneden. rate er nu den årlige nominelle rente: hver periode giver rate divideret med antallet af perioder pr. år (5 % med månedlig rentetilskrivning giver 5/12 % om måneden), som meta.note nu angiver. Parametre og svarfelter er uændrede; resultaterne ændres for alle tilskrivningsfrekvenser undtagen annually. Uafhængigt heraf: når contribution_frequency og compound_frequency begge er daily eller begge er weekly, bliver indbetalinger ikke længere forsinket eller tabt på grund af afrundingsfejl i flydende kommatal, så total_contributions kan være én indbetaling højere ved duration_unit=months. Det ændrer betydningen af en eksisterende parameter: For at genskabe tidligere resultater skal du gange din rate med antallet af rentetilskrivningsperioder pr. år.
Hver Fear & Greed-aflæsning indeholder nu index ved siden af score: Fear & Greed-indekset fra 0–100 præcis som vist på Bitculator (0–19 ekstrem frygt, 20–39 frygt, 40–59 neutral, 60–79 grådighed, 80–100 ekstrem grådighed) — brug det til visning. score er uændret: den rå sammensatte værdi på −100…+100, som index er afledt af. Gælder GET /sentiment/fear-greed (hovedaflæsningen og hver post i intervals), fear_greed på GET /global og meta.fear_greed på GET /global/heatmap. Kun en tilføjelse; intet eksisterende felt er ændret.
GET /coins/{slug} returnerede fully_diluted_valuation som 0 for coins uden et maksimalt udbud (for eksempel Solana og Ethereum, hvis udbud ikke har et loft). Den falder nu tilbage til det samlede udbud og er null, når ingen af dem kendes, som OpenAPI-kontrakten allerede dokumenterede.
marketcap og dominance kan være null for en coin uden cirkulerende udbud, og trust scorens score og breakdown er null for en børs uden rang. POST /alarms svarer med 422, når coinen ikke har nogen aktuel værdi for den valgte metrik. /coins/recently-added og /wallets/timeline respekterer nu sort. /coins/gainers og /coins/losers sorteres efter selve ændringen (tidligere reelt efter markedsværdi), og losers udelader coins på 0.00. Stigende sorteringer returnerer null-værdier til sidst. /prices opløser et tvetydigt symbol til den aktive coin med den højeste rangering. OpenAPI-kontrakten markerer de markedsfelter, der kan være null, og angiver 24t-volumen som et tal.
Den offentliggjorte kontrakt bærer nu eksempler på medietype-niveau, ét fælles fejlskema, som hvert 4xx/5xx-svar refererer til, de 401-, 429- og 500-svar, som ethvert kald med nøgle kan returnere, X-RateLimit-*- og X-Quota-*-headerne på hvert succesfuldt svar, alarm.triggered-leveringen som callback på POST /webhooks, samt metadata om kontakt, licens og vilkår. Ingen request eller response er ændret - kun hvordan de beskrives.
Nyt: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), et JSON Schema-bundle med de fælles svarformer, en offentlig statusside med en JSON-tvilling, denne changelog og politikken for versionering og udfasning.
MCP-serveren er flyttet til sine egne nøgler og planer, oprettet i MCP-konsollen. Data API-nøgler accepteres ikke længere på /mcp; hvert værktøjskald koster stadig ét request.
Bitculators MCP-server gik live på /mcp: 19 skrivebeskyttede værktøjer over Streamable HTTP til Claude, Cursor, VS Code og enhver anden MCP-klient, med de samme decimalstreng-data som REST API'et.
Klienter til TypeScript, Python, PHP, Go, Rust, Java, C# og C++, som hver dækker hvert endpoint på samme transportkerne: Bearer-auth, udpakning af envelopen, opsamling af X-Quota-*, retries ved 429 og 5xx, typede fejl og paginering.
Nogle endpoints og længere indikatorvinduer kræver nu Starter eller Pro. Et kald uden for din plan returnerer 403 plan_required, hvor details.required_plan nævner den plan, der låser det op - og det bruger ikke af kvoten.
Lancering: 85 operationer fordelt på 15 grupper - coins, priser, markeder, børser, wallets, global, sentiment, indikatorer, likvidationer, konvertering, beregnere, redaktionelt, alarmer, webhooks og meta. Bearer-nøgler med data-api-tilladelsen, { data, meta }-envelopen, decimalstreng-præcision, X-Quota-*-headers, signerede webhooks samt planerne Free, Starter og Pro med hver sin månedlige kvote.
Udfasninger annonceres her og pr. e-mail til alle nøgleejere mindst seks måneder før fjernelse - se udfasningspolitikken. Det maskinlæsbare indeks på /apis.json bærer datoen for den nyeste post som sit modified-stempel.