Endringslogg
Hver endring i Data API-et og kontrakten, nyeste først. Versjonsnumrene følger retningslinjene for versjonering og utfasing.
/mcp godtar nå også MCP-nøkkelen som en X-API-Key: YOUR_API_KEY-header av hensyn til klienter og gatewayer, for eksempel Smithery, som reserverer Authorization til sin egen innlogging. Authorization: Bearer fungerer fremdeles og forblir den dokumenterte standarden; når begge headerne sendes, er X-API-Key nøkkelen som kontrolleres. Data API-et på /api/v1 godtar fortsatt bare Bearer-nøkler. Mislykkede autentiseringsforsøk begrenses nå både per nøkkel og per IP, slik at én klients ugyldige nøkkel ikke lenger låser ute andre klienter bak samme IP.
GET /calculators/compound-interest rundet varigheten av til hele renteperioder, slik at en varighet som sluttet midt i en periode ble simulert for lang eller for kort: 6 måneder med annually-rentetilskrivning løp et helt år (12 innskudd og et helt års renter), og 5 måneder løp ingen periode i det hele tatt (ingen innskudd, ingen renter). Hele perioder kjøres nå som før, den siste delvise perioden gir forholdsmessig rente (enkel rente for brøkdelen), og hvert innskudd innenfor varigheten telles med. Resultatene er uendret når varigheten er et helt antall renteperioder; parametere og svarfelt er uendret.
API-et og dokumentasjonen behandlet rate som renten per renteperiode, mens kalkulatoren på nettstedet og veiledningen brukte en årlig rente. GET /calculators/compound-interest brukte hele rate på hver renteperiode, så 5 % med månedlig rentesrente vokste som 5 % per måned. rate er nå den nominelle årsrenten: hver periode gir rate delt på antall perioder per år (5 % med månedlig rentesrente gir 5/12 % per måned), slik meta.note nå sier. Parametere og svarfelt er uendret; resultatene endres for alle rentesrentefrekvenser unntatt annually. Uavhengig av dette blir innskudd ikke lenger forsinket eller utelatt på grunn av avrundingsfeil i flyttall når contribution_frequency og compound_frequency begge er daily eller begge er weekly, så total_contributions kan bli ett innskudd høyere med duration_unit=months. Dette endrer betydningen av en eksisterende parameter: For å gjenskape tidligere resultater må du gange rate med antall renteperioder per år.
Hver Fear & Greed-avlesning inneholder nå index ved siden av score: Fear & Greed-indeksen fra 0–100 nøyaktig slik Bitculator viser den (0–19 ekstrem frykt, 20–39 frykt, 40–59 nøytral, 60–79 grådighet, 80–100 ekstrem grådighet) — bruk den til visning. score er uendret: den rå sammensatte verdien på −100…+100 som index er avledet fra. Gjelder GET /sentiment/fear-greed (hovedavlesningen og hver oppføring i intervals), fear_greed på GET /global og meta.fear_greed på GET /global/heatmap. Kun et tillegg; ingen eksisterende felt er endret.
GET /coins/{slug} returnerte fully_diluted_valuation som 0 for coins uten maksimalt tilbud (for eksempel Solana og Ethereum, der tilbudet ikke har noe tak). Nå brukes det totale tilbudet i stedet, og verdien er null når ingen av dem er kjent, slik OpenAPI-kontrakten allerede dokumenterte.
marketcap og dominance kan være null for en mynt uten sirkulerende forsyning, og tillitsscorens score og breakdown er null for en børs uten rangering. POST /alarms svarer med 422 når mynten ikke har noen gjeldende verdi for den valgte metrikken. /coins/recently-added og /wallets/timeline respekterer nå sort. /coins/gainers og /coins/losers sorteres etter selve endringen (tidligere i praksis etter markedsverdi), og losers utelater mynter på 0.00. Stigende sorteringer returnerer null-verdier sist. /prices løser et tvetydig symbol til den aktive mynten med høyest rangering. OpenAPI-kontrakten markerer markedsfeltene som kan være null, og angir 24t-volum som et tall.
Den publiserte kontrakten bærer nå eksempler på medietypenivå, ett felles feilskjema referert fra hvert 4xx/5xx-svar, 401-, 429- og 500-svarene hvert nøkkelbasert kall kan returnere, X-RateLimit-*- og X-Quota-*-headerne på hvert vellykkede svar, alarm.triggered-leveringen som en callback på POST /webhooks, samt metadata for kontakt, lisens og vilkår. Ingen forespørsel eller respons er endret - bare hvordan de beskrives.
Nytt: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), en JSON Schema-pakke med de felles responsformene, en offentlig statusside med JSON-tvilling, denne endringsloggen og retningslinjene for versjonering og utfasing.
MCP-serveren har gått over til egne nøkler og planer, opprettet i MCP-konsollen. Data API-nøkler godtas ikke lenger på /mcp; hvert verktøykall koster fortsatt én forespørsel.
Bitculators MCP-server gikk live på /mcp: 19 skrivebeskyttede verktøy over Streamable HTTP for Claude, Cursor, VS Code og enhver MCP-klient, som returnerer de samme desimalstreng-dataene som REST API-et.
TypeScript-, Python-, PHP-, Go-, Rust-, Java-, C#- og C++-klienter, som hver dekker hvert endepunkt på samme transportkjerne: Bearer-autentisering, utpakking av konvolutten, innhenting av X-Quota-*, nye forsøk ved 429 og 5xx, typede feil og paginering.
Enkelte endepunkter og lengre indikatorvinduer krever nå Starter eller Pro. Et kall utenfor planen din returnerer 403 plan_required med details.required_plan som navngir planen som låser det opp, og bruker ikke kvote.
Lansering: 85 operasjoner fordelt på 15 grupper - coins, priser, markeder, børser, wallets, globalt, sentiment, indikatorer, likvidasjoner, konvertering, kalkulatorer, redaksjonelt, alarmer, webhooks og meta. Bearer-nøkler med data-api-tillatelsen, { data, meta }-konvolutten, desimalstreng-presisjon, X-Quota-*-headere, signerte webhooks, og Free-, Starter- og Pro-planer med hver sin månedlige kvote.
Utfasinger kunngjøres her og på e-post til hver nøkkeleier minst seks måneder før fjerning - se retningslinjene for utfasing. Den maskinlesbare indeksen på /apis.json bærer datoen for den nyeste oppføringen som sitt modified-stempel.