Ändringslogg
Varje ändring i Data API och dess kontrakt, nyast först. Versionsnumren följer policyn för versionering och utfasning.
/mcp godtar nu även MCP-nyckeln som en X-API-Key: YOUR_API_KEY-header, för klienter och gateways, till exempel Smithery, som reserverar Authorization för sin egen inloggning. Authorization: Bearer fortsätter att fungera och förblir den dokumenterade standarden; när båda headrarna skickas, är X-API-Key den nyckel som kontrolleras. Data API på /api/v1 godtar fortfarande endast Bearer-nycklar. Misslyckade autentiseringsförsök begränsas nu både per nyckel och per IP, så att en klients ogiltiga nyckel inte längre låser ute andra klienter bakom samma IP.
GET /calculators/compound-interest avrundade löptiden till hela ränteperioder, så en löptid som slutade mitt i en period simulerades för lång eller för kort: 6 månader med annually-ränta löpte ett helt år (12 insättningar och ett helt års ränta) och 5 månader löpte ingen period alls (inga insättningar, ingen ränta). Hela perioder beräknas nu som tidigare, den sista delvisa perioden ger ränta proportionellt (enkel ränta för bråkdelen) och varje insättning inom löptiden räknas. Resultaten är oförändrade när löptiden är ett helt antal ränteperioder; parametrar och svarsfält är oförändrade.
API-tjänsten och dess dokumentation behandlade rate som räntan per kapitaliseringsperiod, medan kalkylatorn på webbplatsen och dess guide använde en årsränta. GET /calculators/compound-interest tillämpade hela rate på varje kapitaliseringsperiod, så 5 % med månatlig ränta-på-ränta växte som 5 % per månad. rate är nu den nominella årsräntan: varje period ger rate delat med antalet perioder per år (5 % med månatlig ränta-på-ränta ger 5/12 % per månad), vilket meta.note nu anger. Parametrar och svarsfält är oförändrade; resultaten ändras för alla kapitaliseringsfrekvenser utom annually. Oberoende av detta skjuts insättningar inte längre upp och faller inte bort på grund av flyttalsavrundning när contribution_frequency och compound_frequency båda är daily eller båda är weekly, så total_contributions kan bli en insättning högre med duration_unit=months. Det ändrar innebörden av en befintlig parameter: för att återskapa tidigare resultat multiplicerar du din rate med antalet ränteperioder per år.
Varje Fear & Greed-avläsning innehåller nu index bredvid score: Fear & Greed-indexet 0–100 exakt som det visas på Bitculator (0–19 extrem rädsla, 20–39 rädsla, 40–59 neutral, 60–79 girighet, 80–100 extrem girighet) — använd det för visning. score är oförändrat: det råa sammansatta värdet −100…+100 som index härleds från. Gäller GET /sentiment/fear-greed (huvudavläsningen och varje post i intervals), fear_greed på GET /global och meta.fear_greed på GET /global/heatmap. Endast ett tillägg; inget befintligt fält har ändrats.
GET /coins/{slug} returnerade fully_diluted_valuation som 0 för coins utan maximalt utbud (till exempel Solana och Ethereum, vars utbud saknar tak). Nu används det totala utbudet i stället, och värdet är null när inget av dem är känt, som OpenAPI-kontraktet redan dokumenterade.
marketcap och dominance kan vara null för ett coin utan cirkulerande utbud, och trust scorens score och breakdown är null för en börs utan rankning. POST /alarms svarar med 422 när coinet saknar ett aktuellt värde för det valda måttet. /coins/recently-added och /wallets/timeline respekterar nu sort. /coins/gainers och /coins/losers sorteras efter själva förändringen (tidigare i praktiken efter börsvärde), och losers utesluter coins på 0.00. Stigande sorteringar returnerar null-värden sist. /prices löser en tvetydig symbol till det högst rankade aktiva coinet. OpenAPI-kontraktet markerar de marknadsfält som kan vara null och anger 24h-volymen som ett tal.
Det publicerade kontraktet bär nu exempel på medietypsnivå, ett gemensamt felschema som refereras från varje 4xx/5xx-svar, de 401-, 429- och 500-svar som varje nyckelbaserat anrop kan returnera, X-RateLimit-*- och X-Quota-*-headrarna på varje lyckat svar, alarm.triggered-leveransen som en callback på POST /webhooks, samt metadata för kontakt, licens och villkor. Ingen begäran eller något svar har ändrats - bara hur de beskrivs.
Nytt: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), ett JSON Schema-paket med de gemensamma svarsformerna, en publik statussida med JSON-tvilling, den här ändringsloggen samt policyn för versionering och utfasning.
MCP-servern har gått över till egna nycklar och planer, skapade i MCP-konsolen. Data API-nycklar godtas inte längre på /mcp; varje verktygsanrop kostar fortfarande en begäran.
Bitculators MCP-server gick live på /mcp: 19 skrivskyddade verktyg över Streamable HTTP för Claude, Cursor, VS Code och valfri MCP-klient, som returnerar samma decimalsträngsdata som REST-API:et.
Klienter för TypeScript, Python, PHP, Go, Rust, Java, C# och C++, som var och en täcker varje endpoint på samma transportkärna: Bearer-autentisering, uppackning av höljet, infångning av X-Quota-*, omförsök vid 429 och 5xx, typade fel och paginering.
Vissa endpoints och längre indikatorfönster kräver nu Starter eller Pro. Ett anrop utanför din plan returnerar 403 plan_required med details.required_plan som anger vilken plan som låser upp det, och förbrukar ingen kvot.
Lansering: 85 operationer fördelade på 15 grupper - coins, priser, marknader, börser, wallets, globalt, sentiment, indikatorer, likvidationer, konvertering, kalkylatorer, redaktionellt, alarm, webhooks och meta. Bearer-nycklar med data-api-behörigheten, { data, meta }-höljet, decimalsträngsprecision, X-Quota-*-headrar, signerade webhooks samt Free-, Starter- och Pro-planer med var sin månatliga kvot.
Utfasningar tillkännages här och via e-post till varje nyckelägare minst sex månader före borttagning - se utfasningspolicyn. Det maskinläsbara indexet på /apis.json bär datumet för den nyaste posten som sin modified-stämpel.