Muutosloki
Kaikki Data API -rajapinnan ja sen sopimuksen muutokset, uusimmat ensin. Versionumerot noudattavat versiointi- ja vanhentumiskäytäntöä.
/mcp hyväksyy nyt MCP-avaimen myös otsakkeessa X-API-Key: YOUR_API_KEY niitä asiakasohjelmia ja yhdyskäytäviä varten, jotka Smitheryn tavoin varaavat Authorization-otsakkeen omaan kirjautumiseensa. Authorization: Bearer toimii jatkossakin ja pysyy dokumentoituna oletuksena; kun molemmat otsakkeet lähetetään, tarkistetaan X-API-Key-otsakkeen avain. Osoitteessa /api/v1 sijaitseva Data API -rajapinta hyväksyy edelleen vain Bearer-avaimet. Epäonnistuneita todennusyrityksiä rajoitetaan nyt sekä avain- että IP-kohtaisesti, joten yhden asiakasohjelman virheellinen avain ei enää lukitse ulos muita saman IP-osoitteen takana olevia asiakasohjelmia.
GET /calculators/compound-interest pyöristi keston kokonaisiksi korkojaksoiksi, joten kesken jakson päättyvä kesto simuloitiin liian pitkänä tai liian lyhyenä: 6 kuukautta annually-korkojaksolla kesti koko vuoden (12 talletusta ja koko vuoden korko), ja 5 kuukautta ei kestänyt yhtään jaksoa (ei talletuksia, ei korkoa). Kokonaiset jaksot lasketaan nyt kuten ennenkin, viimeinen osittainen jakso kerryttää korkoa suhteellisesti (yksinkertainen korko jakson osalle) ja jokainen keston aikana tehty talletus lasketaan mukaan. Tulokset eivät muutu, kun kesto on kokonainen määrä korkojaksoja; parametrit ja vastauksen kentät pysyvät ennallaan.
API ja sen dokumentaatio käsittelivät rate-arvoa korkojakson korkona, kun taas verkkosivuston laskuri ja sen ohje käyttivät vuosikorkoa. GET /calculators/compound-interest sovelsi rate-arvon kokonaan jokaiseen korkojaksoon, joten 5 % kuukausittain pääomitettuna kasvoi kuin 5 % kuukaudessa. rate on nyt nimellinen vuosikorko: jokainen jakso kerryttää rate-arvon jaettuna vuoden jaksojen määrällä (5 % kuukausittain pääomitettuna tuottaa 5/12 % kuukaudessa), kuten meta.note nyt kertoo. Parametrit ja vastauksen kentät eivät muutu; tulokset muuttuvat kaikilla pääomitustiheyksillä paitsi annually. Lisäksi sijoitukset eivät enää viivästy tai jää pois liukulukupyöristyksen vuoksi, kun contribution_frequency ja compound_frequency ovat molemmat daily tai molemmat weekly, joten total_contributions voi olla duration_unit=months-asetuksella yhden sijoituksen verran suurempi. Tämä muuttaa olemassa olevan parametrin merkitystä: saat aiemmat tulokset kertomalla rate-arvon korkojaksojen määrällä vuodessa.
Jokainen Fear & Greed -lukema sisältää nyt kentän index kentän score rinnalla: Fear & Greed -indeksin asteikolla 0–100 täsmälleen niin kuin Bitculator sen näyttää (0–19 äärimmäinen pelko, 20–39 pelko, 40–59 neutraali, 60–79 ahneus, 80–100 äärimmäinen ahneus) — käytä sitä näyttämiseen. Kenttä score on ennallaan: raaka yhdistelmäarvo väliltä −100…+100, josta index johdetaan. Koskee reittiä GET /sentiment/fear-greed (päälukema ja jokainen kentän intervals kohta), kenttää fear_greed reitillä GET /global ja kenttää meta.fear_greed reitillä GET /global/heatmap. Pelkkä lisäys; mikään olemassa oleva kenttä ei muuttunut.
GET /coins/{slug} palautti fully_diluted_valuation-kentän arvona 0 kolikoille, joilla ei ole maksimitarjontaa (esimerkiksi Solana ja Ethereum, joiden tarjontaa ei ole rajattu). Nyt käytetään kokonaistarjontaa, ja arvo on null, kun kumpaakaan ei tiedetä, kuten OpenAPI-sopimus jo dokumentoi.
marketcap ja dominance voivat olla null, jos kolikolla ei ole kierrossa olevaa määrää, ja luottamuspisteiden score ja breakdown ovat null pörssille, jota ei ole luokiteltu. POST /alarms palauttaa 422, kun kolikolla ei ole nykyistä arvoa valitulle mittarille. /coins/recently-added ja /wallets/timeline noudattavat nyt sort-parametria. /coins/gainers ja /coins/losers järjestetään muutoksen mukaan (aiemmin käytännössä markkina-arvon mukaan), ja laskijoista jätetään pois kolikot arvolla 0.00. Nousevassa järjestyksessä null-arvot palautetaan viimeisinä. /prices ratkaisee moniselitteisen symbolin korkeimmalle sijoittuvaksi aktiiviseksi kolikoksi. OpenAPI-sopimus merkitsee null-arvon sallivat markkinakentät ja määrittää 24 tunnin vaihdon numeroksi.
Julkaistu sopimus sisältää nyt esimerkit media-tyypin tasolla, yhden yhteisen virheskeeman, johon jokainen 4xx/5xx-vastaus viittaa, 401-, 429- ja 500-vastaukset, jotka jokainen avaimella tehty kutsu voi palauttaa, X-RateLimit-*- ja X-Quota-*-otsakkeet jokaisessa onnistuneessa vastauksessa, alarm.triggered-toimituksen callbackina kohdassa POST /webhooks sekä yhteys-, lisenssi- ja ehtometatiedot. Pyynnöt tai vastaukset eivät muuttuneet – vain se, miten ne kuvataan.
Uutta: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), JSON Schema -paketti yhteisistä vastausrakenteista, julkinen tilasivu JSON-vastineineen, tämä muutosloki sekä versiointi- ja vanhentumiskäytäntö.
MCP-palvelin siirtyi omiin avaimiinsa ja suunnitelmiinsa, jotka luodaan MCP-konsolissa. Data API -avaimia ei enää hyväksytä osoitteessa /mcp; jokainen työkalukutsu kuluttaa edelleen yhden pyynnön.
Bitculatorin MCP-palvelin julkaistiin osoitteessa /mcp: 19 vain luku -työkalua Streamable HTTP -yhteyden yli Claudelle, Cursorille, VS Codelle ja mille tahansa MCP-asiakkaalle, ja ne palauttavat samat desimaalimerkkijonot kuin REST-rajapinta.
TypeScript-, Python-, PHP-, Go-, Rust-, Java-, C#- ja C++-asiakkaat, joista jokainen kattaa kaikki päätepisteet samalla siirtoydimellä: Bearer-tunnistus, kuoren purkaminen, X-Quota-*-arvojen talteenotto, uudelleenyritykset virheissä 429 ja 5xx, tyypitetyt virheet ja sivutus.
Osa päätepisteistä ja pidemmistä indikaattori-ikkunoista vaatii nyt Starterin tai Pron. Suunnitelmasi ulkopuolinen kutsu palauttaa 403 plan_required, jossa details.required_plan kertoo sen avaavan suunnitelman, eikä kutsu kuluta kvoottia.
Julkaisu: 85 operaatiota 15 ryhmässä – kolikot, hinnat, markkinat, pörssit, lompakot, globaalit luvut, sentimentti, indikaattorit, likvidaatiot, muunnos, laskurit, sisältö, hälytykset, webhookit ja meta. Bearer-avaimet data-api-oikeudella, { data, meta }-kuori, desimaalimerkkijonojen tarkkuus, X-Quota-*-otsakkeet, allekirjoitetut webhookit sekä Free-, Starter- ja Pro-suunnitelmat omalla kuukausikvootillaan.
Vanhentumisista ilmoitetaan täällä ja sähköpostilla jokaiselle avaimen haltijalle vähintään kuusi kuukautta ennen poistoa – katso vanhentumiskäytäntö. Koneluettava hakemisto osoitteessa /apis.json sisältää uusimman merkinnän päivämäärän modified-aikaleimanaan.