Muutosloki
Kaikki Data API -rajapinnan ja sen sopimuksen muutokset, uusimmat ensin. Versionumerot noudattavat versiointi- ja vanhentumiskäytäntöä.
POST /webhooks ja POST /webhooks/{id}/test jakavat nyt yhteisen rajan, 5 pyyntöä minuutissa tiliä kohti, suunnitelman purskerajan lisäksi. Rajan ylittävät pyynnöt saavat vastauksen 429 rate_limited ja otsakkeen Retry-After. Testitapahtuma lähetetään nyt kerran ilman uudelleenyrityksiä; muita toimituksia yritetään edelleen enintään 3 kertaa, ja yritysten välillä on kasvava viive. Tämä on väärinkäytön estävä raja, joka jättää jokaisen suunnitelman kuukausikvootan ja purskerajan ennalleen. Versiointi- ja vanhentumiskäytäntöä muutettiin samana päivänä, jotta tällaiset rajat voivat tulla voimaan heti; siihen asti minkä tahansa suunnitelmaan kuuluvan nopeusrajan laskeminen noudatti kuuden kuukauden poistumisaikataulua. Näissä kahdessa päätepisteessä otsakkeet X-RateLimit-* kertovat sen kahdesta rajasta, jossa pyyntöjä on jäljellä vähemmän.
POST /webhooks ei enää selvitä URL-osoitteen isäntänimeä. Se palauttaa edelleen vastauksen 422, jos URL ei käytä https:ää, sisältää tunnistetietoja tai sen isäntänä on muu kuin julkinen IP-osoite. Isäntänimi, jota ei voi selvittää tai joka osoittaa muuhun kuin julkiseen osoitteeseen, sai tähän asti vastauksen 422; nyt se hyväksytään vastauksella 201 ja lasketaan tilikohtaiseen 5 päätepisteen rajaan. Jokainen toimitus tällaiseen päätepisteeseen epäonnistuu silloin ilman uudelleenyritystä, reitin GET /webhooks/{id}/deliveries kenttä error kertoo syyn, ja 10 peräkkäistä epäonnistunutta toimitusta poistaa päätepisteen käytöstä. Lähetä päätepisteen luomisen jälkeen testitapahtuma reitillä POST /webhooks/{id}/test ja tarkista toimituslokista, että päätepiste on tavoitettavissa.
Reitin GET /usage kenttä endpoints[].endpoint ilmoittaa nyt reittimallin pyydetyn polun sijaan – api/v1/coins/{slug} eikä api/v1/coins/bitcoin – joten kullakin päätepisteellä on yksi rivi eikä oma rivinsä jokaista slugia tai id:tä kohden. Kuluvan laskutusjakson aiemmin kirjatut pyynnöt säilyttävät polkunsa, joten molemmat muodot voivat näkyä jakson loppuun asti.
GET /exchanges/{slug} ja GET /exchanges/{slug}/trust-score epäonnistuivat Data API -rajapinnan julkaisusta lähtien virheellä 500 jokaisen pörssin kohdalla. Molemmat vastaavat nyt; parametrit ja vastauksen kentät pysyvät ennallaan, ja pörssi, jolla ei ole sijoitusta, palauttaa kentät score ja breakdown arvolla null.
Julkaistu OpenAPI-sopimus merkitsee nyt jokaisen kentän, joka voi olla null, null-arvon sallivaksi ja määrittää desimaaliarvot numeroiksi (esimerkiksi invested-kenttä reitillä GET /calculators/dca ja indikaattoriarvot); yhteiset kentät logo ja last_updated sekä sivutuskentät from/to sallivat null-arvon kaikissa päätepisteissä, samoin kolikon kentät name ja price kaikissa kolikkolistojen ja hintojen päätepisteissä. Lisäksi se määrittää DCA:n series-kentän taulukoksi, dokumentoi reittien GET /coins/{slug}/markets, GET /coins/losers, GET /global/history/{metric} ja GET /sentiment/altseason vastaukset, dokumentoi days-parametrin arvoalueeksi 1–365 reitillä GET /sentiment/altseason (arvo 0 on aina hylätty; jätä parametri pois, jos haluat nykyisen lukeman) ja luettelee virheskeemassa koodit endpoint_unavailable (503) ja http_error. Pyynnöt tai vastaukset eivät muuttuneet – vain se, miten ne kuvataan.
Epäonnistuneet todennusyritykset rajattiin aiemmin 30 yritykseen minuutissa IP-osoitetta kohti, minkä jälkeen jokainen saman IP-osoitteen takana oleva avain sai vastauksen 429. Nyt yksi avain voi epäonnistua 30 kertaa minuutissa yhdestä IP-osoitteesta ja yksi IP-osoite 300 kertaa, noin viimeisten 15 minuutin aikana onnistuneesti todennettuja avaimia ei estetä IP-rajan vuoksi, ja pyyntö ilman avainta saa vastauksen 401 ilman, että sitä lasketaan rajaan. Estetyt pyynnöt saavat vastauksen 429 rate_limited ja otsakkeen Retry-After.
GET- ja HEAD-pyynnöt, joiden polussa on loppukauttaviiva, kaksoiskauttaviiva tai alussa /index.php, saavat nyt vastauksen 301 siistiin URL-osoitteeseen sen sijaan, että ne palveltaisiin – esimerkiksi /api/v1/coins/ ohjataan osoitteeseen /api/v1/coins. Muihin metodeihin muutos ei vaikuta.
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.
Fear & Greed -lukema, jolla ei vielä ollut pisteitä, raportoitiin muodossa score: 0. Se on nyt null reitillä GET /sentiment/fear-greed, ja samoin kenttä fear_greed reitillä GET /global ja kenttä meta.fear_greed reitillä GET /global/heatmap.
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.
Jokainen analyysi reiteillä GET /insights, GET /insights/{id} ja GET /coins/{slug}/insights sisältää nyt kentän generated_by: "ai" sekä kentässä model mallin, joka sen kirjoitti. Pelkkä lisäys; mikään olemassa oleva kenttä ei muuttunut.
Huobi-pörssin uusi nimi on HTX, ja sen slug muuttui arvosta huobi arvoon htx; API ei seuraa slugien uudelleenohjauksia, joten /exchanges/huobi palauttaa nyt vastauksen 404. CoinEx merkittiin passiiviseksi, eikä sitä enää palauteta.
change_24h ja change_7d ovat nyt null, kun kolikon muutoksia ei ole laskettu uudelleen 15 minuuttiin, sen sijaan että ne näyttäisivät vanhentunutta liikettä. 18. syyskuuta lähtien sama koskee myös kenttiä change_rank_24h ja change_rank_7d.
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-työkalukutsut lakkasivat tästä päivästä lähtien kuluttamasta Data API -suunnitelman kuukausikvoottia ja purskerajaa; MCP-palvelimella on siitä lähtien omat avaimet ja suunnitelmat. Reitin GET /usage kenttä tokens[].kind voi nyt olla mcp, ja kvootin ylityksen 429-viesti kuuluu: ”Your Data API plan has reached its monthly request limit.” (aiemmin siinä mainittiin upotussuunnitelma).
Data API -avaimen luominen tai kierrättäminen kehittäjäkonsolissa vaatii nyt vahvistetun sähköpostiosoitteen; tilit, joilla ei ole sähköpostiosoitetta, kuten lompakolla kirjautuneet, on vapautettu tästä. Avaimia voi luoda enintään 10 minuutissa. Olemassa olevat avaimet toimivat edelleen.
volume_usd reiteillä GET /tickers, GET /pairs, GET /pairs/{id}, GET /coins/{slug}/markets ja GET /exchanges/{slug}/tickers tallennettiin kokonaislukuna, joten sentit katosivat ja alle 0,50 dollarin markkinat näyttivät arvoa 0. Vaihtomäärät säilyttävät nyt kaksi desimaalia, eivätkä niistä muodostetut summat enää peri pyöristystä.
change reiteillä GET /coins/{slug}/sparkline ja GET /exchanges/{slug}/sparkline oli murtoluku jaksoilla 30d–365d (0,05 tarkoitti +5 %) mutta prosentti jaksoilla 24h ja 7d. Se on nyt prosentti jokaisella jaksolla (1.25 tarkoittaa +1,25 %), joten pidempien jaksojen arvot ovat 100 kertaa aiempaa suurempia, eivätkä alle 0,5 prosentin liikkeet enää pyöristy arvoon 0.
Molemmissa sparkline-päätepisteissä low ja high tulivat eri ikkunasta lasketusta yhteenvedosta ja saattoivat olla ristiriidassa kentän points kanssa – esimerkiksi low saattoi olla sarjan hintoja korkeampi. Ne ovat nyt sen jakson todelliset ääriarvot, jolta points on otettu.
GET /wallets, /wallets/timeline, /wallets/compare, /wallets/{slug} ja /wallets/{slug}/assets palauttavat nyt myös lompakot, joiden tila on vaporware, joten status voi saada tämän arvon.
Analyysien lähteiden kentät title ja excerpt eivät enää sisällä raakoja HTML-entiteettejä, kuten í.
Artikkelilla, jota ei ollut koskaan muokattu, updated_at reiteillä GET /articles ja GET /articles/{slug} näytti viimeisimmän hetken, jolloin tietue muuttui mistä tahansa syystä, kuten katselukerran tai äänen vuoksi. Se näyttää nyt viimeisimmän toimituksellisen muokkauksen ja sen puuttuessa julkaisupäivän, eikä POST /articles/{slug}/feedback enää muuta sitä.
Analyysit sisältävät nyt kentän sentiment: bullish, bearish, sheepish tai null, kun luokitusta ei ole.
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.
Päätepisteet voivat nyt vaatia suunnitelman. Käyttöönoton yhteydessä GET /sentiment/indicators vaati Pro-suunnitelman, ja GET /sentiment/bull-bear, GET /sentiment/altseason, GET /global, GET /global/heatmap ja GET /global/history/{metric} vaativat Starter-suunnitelman. Suunnitelmasi ulkopuolinen kutsu palauttaa vastauksen 403 plan_required, jossa details.required_plan nimeää sen avaavan suunnitelman, eikä kutsu kuluta kvoottia.
Kuusi /liquidations-päätepistettä poistettiin käytöstä kaikissa suunnitelmissa: ne palauttavat vastauksen 503 endpoint_unavailable (”This endpoint is temporarily unavailable.”) eivätkä kuluta kvoottia.
Pro-suunnitelman kuukausikvootti laski 500 000 pyynnöstä 250 000 pyyntöön.
Yleisestä päätepisteestä GET /coins/{slug}/indicators/{family} tuli 13 erikseen dokumentoitua päätepistettä samoissa poluissa: rsi, stoch-rsi, sma, cci, mfi, williams-r, price-volatility, volume-volatility, macd, obv, adx, vwap ja cmf. Olemassa olevat kutsut eivät muutu; tuntematon indikaattorin nimi saa nyt pelkän vastauksen 404 ilman kelvollisten nimien listaa.
Julkaisun aikaan Data API -kutsut ja upotuswidgettien pyynnöt käyttivät yhtä upotussuunnitelmaan sidottua kuukausikvoottia. Data API -rajapinnalla on nyt omat Free-, Starter- ja Pro-suunnitelmat, tilaus ja kuukausikvootti sekä oma laskutusjakso: Free-suunnitelmassa UTC-ajan kalenterikuukausi, maksullisissa suunnitelmissa uusimispäivään sidottu jakso. GET /ping ja GET /usage raportoivat Data API -suunnitelman, ja /usage laskee vain Data API -kutsut. Rajat eivät muuttuneet erottamisen yhteydessä.
Referenssi siirtyi osoitteesta /{locale}/documentation osoitteeseen /{locale}/documentation/api/v1, ja Postman-kokoelma ja OpenAPI-YAML siirtyivät osoitteista /documentation.postman ja /documentation.openapi osoitteisiin /documentation/api/v1.postman ja /documentation/api/v1.openapi. Vanhat polut poistettiin ilman uudelleenohjauksia; /api/v1/openapi.json ei muuttunut.
Julkaisu: 73 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 ja allekirjoitetut webhookit. Data API -kutsut ja upotuswidgettien pyynnöt jakoivat yhden kuukausikvootin upotussuunnitelman alla, ja pidemmät indikaattori-ikkunat vaativat Starter-suunnitelman.
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.