Endringslogg
Hver endring i Data API-et og kontrakten, nyeste først. Versjonsnumrene følger retningslinjene for versjonering og utfasing.
POST /webhooks og POST /webhooks/{id}/test deler nå en grense på 5 forespørsler i minuttet per konto, i tillegg til planens burst-grense. Forespørsler over grensen får 429 rate_limited med Retry-After. En testhendelse sendes nå én gang, uten nye forsøk; andre leveringer forsøkes fortsatt opptil 3 ganger, med backoff mellom forsøkene. Dette er en grense mot misbruk og lar hver plans månedlige kvote og burst-grense være uendret. Retningslinjene for versjonering og utfasing ble endret samme dag, slik at slike grenser kan gjelde umiddelbart; frem til da gjaldt tidslinjen for utfasing på seks måneder for enhver senking av en kallgrense en plan hadde. På disse to endepunktene viser X-RateLimit-*-headerne den av de to grensene som har færrest forespørsler igjen.
POST /webhooks slår ikke lenger opp vertsnavnet i URL-en. Kallet returnerer fortsatt 422 når URL-en ikke bruker https, inneholder påloggingsopplysninger eller har en ikke-offentlig IP-adresse som vert. Et vertsnavn som ikke kan slås opp, eller som peker til en ikke-offentlig adresse, fikk hittil 422; det godtas nå med 201 og teller mot grensen på 5 endepunkter per konto. Hver levering til et slikt endepunkt feiler da uten nye forsøk, error på GET /webhooks/{id}/deliveries oppgir årsaken, og 10 mislykkede leveringer på rad deaktiverer endepunktet. Send en testhendelse med POST /webhooks/{id}/test etter at du har opprettet et endepunkt, og sjekk leveringsloggen for å se at det kan nås.
endpoints[].endpoint på GET /usage oppgir nå rutemalen i stedet for den forespurte stien - api/v1/coins/{slug} i stedet for api/v1/coins/bitcoin - så hvert endepunkt har én rad i stedet for én per slug eller id. Forespørsler som ble registrert tidligere i den gjeldende faktureringsperioden, beholder stien sin, så begge formene kan vises til perioden er over.
GET /exchanges/{slug} og GET /exchanges/{slug}/trust-score hadde feilet med 500 for alle børser siden Data API-et ble lansert. Begge svarer nå; parametere og svarfelt er uendret, og en børs uten rangering returnerer score og breakdown som null.
Den publiserte OpenAPI-kontrakten markerer nå hvert felt som kan være null, som nullable og angir verdier med desimaler som tall (for eksempel invested på GET /calculators/dca og indikatorverdier); de felles feltene logo og last_updated samt pagineringsfeltene from/to er nullable på alle endepunkter, og det samme gjelder myntfeltene name og price på alle endepunkter for myntlister og priser. Den angir også series for DCA som en array, dokumenterer svarene fra GET /coins/{slug}/markets, GET /coins/losers, GET /global/history/{metric} og GET /sentiment/altseason, dokumenterer days på GET /sentiment/altseason som 1–365 (0 har alltid blitt avvist; utelat den for å få gjeldende avlesning) og lister opp kodene endpoint_unavailable (503) og http_error i feilskjemaet. Ingen forespørsel eller respons er endret - bare hvordan de beskrives.
Mislykket autentisering var tidligere begrenset til 30 forsøk i minuttet per IP, og deretter fikk hver nøkkel bak den IP-en 429. Nå kan én nøkkel feile 30 ganger i minuttet fra én IP og én IP 300 ganger, nøkler som har autentisert seg i løpet av omtrent de siste 15 minuttene, blokkeres ikke av IP-grensen, og en forespørsel uten nøkkel returnerer 401 uten å telles. Blokkerte forespørsler får 429 rate_limited med Retry-After.
GET- og HEAD-forespørsler der stien har en avsluttende skråstrek, en dobbel skråstrek eller en innledende /index.php, får nå en 301 til den rene URL-en i stedet for å bli besvart - for eksempel fra /api/v1/coins/ til /api/v1/coins. Andre metoder påvirkes ikke.
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.
En Fear & Greed-avlesning som ennå ikke hadde noen score, ble rapportert som score: 0. Den er nå null på GET /sentiment/fear-greed, og det samme gjelder fear_greed på GET /global og meta.fear_greed på GET /global/heatmap.
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.
Hver innsikt på GET /insights, GET /insights/{id} og GET /coins/{slug}/insights har nå generated_by: "ai" og model, modellen som skrev den. Kun et tillegg; ingen eksisterende felt er endret.
Børsen Huobi fikk det nye navnet HTX, og sluggen endret seg fra huobi til htx; API-et følger ikke slug-omdirigeringer, så /exchanges/huobi returnerer nå 404. CoinEx ble satt som inaktiv og returneres ikke lenger.
change_24h og change_7d er nå null når en mynts endringer ikke er beregnet på nytt på 15 minutter, i stedet for å vise en utdatert bevegelse. Siden 18. september gjelder det samme for change_rank_24h og change_rank_7d.
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-verktøykall sluttet å telle mot Data API-planens månedlige kvote og burst-grense; MCP-serveren har hatt egne nøkler og planer siden denne dagen. tokens[].kind på GET /usage kan nå være mcp, og 429-meldingen ved overskredet kvote lyder «Your Data API plan has reached its monthly request limit.» (tidligere sto det embed-plan).
Å opprette eller rotere en Data API-nøkkel i utviklerkonsollen krever nå en verifisert e-postadresse; kontoer uten e-post, for eksempel innlogginger med lommebok, er unntatt. Opprettelse av nøkler er begrenset til 10 i minuttet. Eksisterende nøkler fortsetter å fungere.
volume_usd på GET /tickers, GET /pairs, GET /pairs/{id}, GET /coins/{slug}/markets og GET /exchanges/{slug}/tickers ble lagret som et heltall, så centene gikk tapt og markeder under 0,50 dollar viste 0. Volumene beholder nå to desimaler, og totalene som bygges av dem, arver ikke lenger avrundingen.
change på GET /coins/{slug}/sparkline og GET /exchanges/{slug}/sparkline var en brøk for 30d til 365d (0,05 betydde +5 %), men en prosent for 24h og 7d. Den er nå en prosent for alle perioder (1.25 betyr +1,25 %), så verdiene for de lengre periodene er 100 ganger større enn før, og bevegelser under 0,5 % rundes ikke lenger av til 0.
På begge sparkline-endepunktene kom low og high fra et sammendrag bygget over et annet vindu og kunne motsi points - for eksempel en low over prisene i serien. De er nå de faktiske ytterpunktene i perioden som points er samplet fra.
GET /wallets, /wallets/timeline, /wallets/compare, /wallets/{slug} og /wallets/{slug}/assets returnerer nå også lommebøker med statusen vaporware, så status kan ha den verdien.
Kildenes title og excerpt i innsikter inneholder ikke lenger rå HTML-entiteter som í.
For en artikkel som aldri var redigert, viste updated_at på GET /articles og GET /articles/{slug} siste gang posten endret seg av en hvilken som helst grunn, for eksempel et visningstall eller en stemme. Den viser nå siste redaksjonelle redigering, med publiseringsdatoen som reserve, og POST /articles/{slug}/feedback flytter den ikke lenger.
Innsikter inkluderer nå sentiment: bullish, bearish, sheepish, eller null når den ikke er klassifisert.
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.
Endepunkter kan nå kreve en plan. Ved innføringen krevde GET /sentiment/indicators Pro, og GET /sentiment/bull-bear, GET /sentiment/altseason, GET /global, GET /global/heatmap og GET /global/history/{metric} krevde Starter. 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.
De seks /liquidations-endepunktene ble slått av på alle planer: de returnerer 503 endpoint_unavailable («This endpoint is temporarily unavailable.») og bruker ikke kvote.
Pro-planens månedlige kvote gikk fra 500 000 til 250 000 forespørsler.
Det generiske GET /coins/{slug}/indicators/{family} ble til 13 separat dokumenterte endepunkter på de samme stiene: rsi, stoch-rsi, sma, cci, mfi, williams-r, price-volatility, volume-volatility, macd, obv, adx, vwap og cmf. Eksisterende kall er uendret; et ukjent indikatornavn får nå en enkel 404 uten listen over gyldige navn.
Ved lanseringen trakk Data API-kall og forespørsler fra embed-widgets fra én felles månedlig pott knyttet til embed-planen. Data API-et har nå egne Free-, Starter- og Pro-planer, eget abonnement og egen månedlig kvote, med egen faktureringsperiode: kalendermåneden i UTC på Free, forankret til fornyelsesdagen på betalte planer. GET /ping og GET /usage rapporterer Data API-planen, og /usage teller bare Data API-kall. Grensene var uendret ved delingen.
Referansen flyttet fra /{locale}/documentation til /{locale}/documentation/api/v1, og Postman-samlingen og OpenAPI-YAML-en fra /documentation.postman og /documentation.openapi til /documentation/api/v1.postman og /documentation/api/v1.openapi. De gamle stiene ble fjernet uten omdirigeringer; /api/v1/openapi.json er uendret.
Lansering: 73 operasjoner fordelt på 15 grupper - mynter, priser, markeder, børser, lommebøker, 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 og signerte webhooks. Data API-kall og forespørsler fra embed-widgets delte én månedlig kvote under embed-planen, og lengre indikatorvinduer krevde Starter.
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.