Változásnapló
A Data API és szerződésének minden változása, a legújabbal kezdve. A verziószámok a verziózási és megszüntetési szabályzatot követik.
A /mcp mostantól X-API-Key: YOUR_API_KEY fejlécként is elfogadja az MCP-kulcsot azon kliensek és átjárók kedvéért, amelyek (például a Smithery) a saját bejelentkezésükhöz foglalják le az Authorization fejlécet. Az Authorization: Bearer fejléc továbbra is működik, és ez marad a dokumentált alapértelmezés; ha mindkét fejlécet elküldik, az X-API-Key fejlécben szereplő kulcsot ellenőrzi a kiszolgáló. A /api/v1 címen elérhető Data API továbbra is csak Bearer kulcsokat fogad el. A sikertelen hitelesítési kísérletek száma mostantól nemcsak IP-címenként, hanem kulcsonként is korlátozott, így egy kliens érvénytelen kulcsa már nem zárja ki az ugyanazon IP-cím mögötti többi klienst.
GET /calculators/compound-interest egész tőkésítési időszakokra kerekítette a futamidőt, így az időszak közepén végződő futamidőt túl hosszúnak vagy túl rövidnek szimulálta: 6 hónap annually tőkésítéssel egy teljes évig futott (12 befizetés és egy teljes év kamata), 5 hónap pedig egyetlen időszakot sem futott (se befizetés, se kamat). Az egész időszakok most a korábbiak szerint futnak, az utolsó töredék időszak arányos kamatot hoz (egyszerű kamat a töredékre), és a futamidőn belüli minden befizetés beleszámít. Az eredmények nem változnak, ha a futamidő egész számú tőkésítési időszak; a paraméterek és a válaszmezők nem változnak.
Az API és a dokumentációja a rate paramétert kamatperiódusonkénti kamatlábként kezelte, míg a weboldal kalkulátora és útmutatója éves kamatlábat használt. A GET /calculators/compound-interest a rate paramétert teljes egészében minden kamatperiódusra alkalmazta, így a havi kamatozású 5% havi 5%-ként nőtt. A rate paraméter mostantól a névleges éves kamatláb: minden periódusra a rate paraméter és az évi periódusszám hányadosa jut (5% havi kamatozással havonta 5/12%), ahogy a meta.note mező is jelzi. A paraméterek és a válaszmezők nem változnak; az eredmények minden kamatozási gyakoriságnál változnak, kivéve az annually értéket. Ettől függetlenül, ha a contribution_frequency és a compound_frequency értéke egyaránt daily vagy egyaránt weekly, a befizetések a lebegőpontos kerekítés miatt már nem késnek, és nem is maradnak ki, így duration_unit=months esetén a total_contributions egy befizetéssel magasabb lehet. Ez egy meglévő paraméter jelentését változtatja meg: a korábbi eredmények visszaállításához szorozza meg a rate értékét az évenkénti tőkésítési időszakok számával.
Minden Fear & Greed érték mostantól a score mező mellett az index mezőt is tartalmazza: a 0–100-as Fear & Greed indexet pontosan úgy, ahogy a Bitculator mutatja (0–19 extrém félelem, 20–39 félelem, 40–59 semleges, 60–79 kapzsiság, 80–100 extrém kapzsiság) — megjelenítéshez ezt használja. A score mező változatlan: a −100…+100 közötti nyers összetett érték, amelyből az index mező származik. Érintett: GET /sentiment/fear-greed (a fő érték és az intervals minden eleme), a fear_greed mező a GET /global válaszban és a meta.fear_greed mező a GET /global/heatmap válaszban. Csak bővítés; egyetlen meglévő mező sem változott.
A GET /coins/{slug} 0 értékkel adta vissza a fully_diluted_valuation mezőt a maximális kínálat nélküli coinoknál (például Solana és Ethereum, amelyek kínálata nincs korlátozva). Most a teljes kínálatot használja helyette, és null, ha egyik sem ismert, ahogy az OpenAPI-szerződés már dokumentálta.
A marketcap és a dominance értéke null lehet olyan érménél, amelynek nincs forgalomban lévő kínálata, a trust score score és breakdown értéke pedig null a rangsorolatlan tőzsdéknél. A POST /alarms 422-t ad vissza, ha az érméhez nincs aktuális érték a választott metrikánál. A /coins/recently-added és a /wallets/timeline mostantól figyelembe veszi a sort paramétert. A /coins/gainers és a /coins/losers magára a változásra rendez (korábban gyakorlatilag piaci kapitalizációra), a vesztesek közül pedig kimaradnak a 0.00 értéken álló érmék. Növekvő rendezésnél a null értékek a végére kerülnek. A /prices a kétértelmű szimbólumot a legmagasabban rangsorolt aktív érmére oldja fel. Az OpenAPI-szerződés megjelöli a nullázható piaci mezőket, a 24 órás forgalmat pedig számként írja le.
A közzétett szerződés mostantól médiatípus szintű példákat, egyetlen közös hibasémát, amelyre minden 4xx/5xx válasz hivatkozik, a 401-es, 429-es és 500-as válaszokat, amelyeket minden kulccsal hitelesített hívás visszaadhat, az X-RateLimit-* és X-Quota-* fejléceket minden sikeres válaszon, az alarm.triggered kiszállítást a POST /webhooks visszahívásaként, valamint kapcsolattartási, licenc- és feltételekre vonatkozó metaadatokat is tartalmaz. Sem a kérések, sem a válaszok nem változtak – csak a leírásuk.
Új: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), egy JSON Schema csomag a közös válaszformákról, egy nyilvános állapotoldal JSON-párjával, ez a változásnapló, valamint a verziózási és megszüntetési szabályzat.
Az MCP-kiszolgáló saját kulcsokra és csomagokra váltott, amelyek az MCP-konzolban hozhatók létre. A Data API kulcsait a /mcp már nem fogadja el; minden eszközhívás továbbra is egy kérésbe kerül.
A Bitculator MCP-kiszolgálója elindult a /mcp címen: 19 csak olvasható eszköz Streamable HTTP felett a Claude, a Cursor, a VS Code és bármely MCP-kliens számára, ugyanazokat a decimális sztringes adatokat adva vissza, mint a REST API.
TypeScript-, Python-, PHP-, Go-, Rust-, Java-, C#- és C++-kliensek, mindegyik minden végpontot lefedve, ugyanazzal a transzportmaggal: Bearer hitelesítés, boríték kicsomagolása, X-Quota-* beolvasása, újrapróbálkozás 429 és 5xx esetén, tipizált hibák és lapozás.
Néhány végpont és a hosszabb indikátor-időablakok mostantól Starter vagy Pro csomagot igényelnek. A csomagodon kívüli hívás 403 plan_required hibát ad vissza, a details.required_plan pedig megnevezi a feloldáshoz szükséges csomagot, és nem fogyaszt kvótát.
Indulás: 85 művelet 15 csoportban – érmék, árak, piacok, tőzsdék, tárcák, globális adatok, hangulat, indikátorok, likvidálások, átváltás, kalkulátorok, szerkesztői tartalom, riasztások, webhookok és metaadatok. Bearer kulcsok a data-api jogosultsággal, a { data, meta } boríték, decimális sztringes pontosság, X-Quota-* fejlécek, aláírt webhookok, valamint Free, Starter és Pro csomagok saját havi kvótával.
A megszüntetéseket itt és e-mailben, minden kulcstulajdonosnak legalább hat hónappal az eltávolítás előtt bejelentjük – lásd a megszüntetési szabályzatot. A gépi olvasásra kész index a /apis.json címen a legújabb bejegyzés dátumát viseli modified bélyegként.