Değişiklik günlüğü
Data API'de ve sözleşmesinde yapılan her değişiklik, en yeniden başlayarak. Sürüm numaraları sürümleme ve kullanımdan kaldırma politikasını izler.
/mcp, Authorization başlığını kendi oturum açma işlemleri için ayıran, Smithery gibi istemciler ve ağ geçitleri için MCP anahtarını artık X-API-Key: YOUR_API_KEY başlığı olarak da kabul ediyor. Authorization: Bearer çalışmaya devam ediyor ve belgelenmiş varsayılan yöntem olarak kalıyor; her iki başlık da gönderildiğinde X-API-Key başlığındaki anahtar kontrol ediliyor. /api/v1 adresindeki Data API ise hâlâ yalnızca Bearer anahtarlarını kabul ediyor. Başarısız kimlik doğrulama denemeleri artık yalnızca IP başına değil, anahtar başına da kısıtlanıyor; böylece bir istemcinin geçersiz anahtarı, aynı IP'nin arkasındaki diğer istemcileri artık engellemiyor.
GET /calculators/compound-interest süreyi tam bileşik faiz dönemlerine yuvarlıyordu; bu nedenle bir dönemin ortasında biten bir süre olduğundan uzun ya da kısa simüle ediliyordu: annually bileşik faizle 6 ay tam bir yıl sürüyordu (12 yatırım ve tam bir yıllık faiz), 5 ay ise hiç dönem içermiyordu (yatırım yok, faiz yok). Tam dönemler artık eskisi gibi hesaplanıyor, son kısmi dönem orantılı faiz kazandırıyor (kesir için basit faiz) ve süre içindeki her yatırım sayılıyor. Süre tam sayıda bileşik faiz dönemine denk geldiğinde sonuçlar değişmez; parametreler ve yanıt alanları değişmedi.
API ve dokümantasyonu, rate değerini bileşik dönem başına faiz oranı olarak ele alıyordu; web sitesindeki hesaplayıcı ve kullanım kılavuzu ise yıllık faiz oranı kullanıyordu. GET /calculators/compound-interest, rate değerini her bileşik döneme tam olarak uyguluyordu; bu yüzden aylık bileşik %5, ayda %5 gibi büyüyordu. rate artık yıllık nominal faiz oranıdır: her dönem, rate değerinin yıllık dönem sayısına bölümü kadar getiri sağlar (aylık bileşik %5, ayda %5/12 demektir); meta.note artık bunu belirtir. Parametreler ve yanıt alanları değişmez; sonuçlar annually dışındaki tüm bileşik sıklıklarında değişir. Ayrıca contribution_frequency ve compound_frequency ikisi de daily veya ikisi de weekly olduğunda, düzenli para yatırma işlemleri artık kayan nokta yuvarlaması yüzünden gecikmiyor ya da atlanmıyor; bu nedenle duration_unit=months ile total_contributions bir yatırım tutarı kadar daha yüksek olabilir. Bu, mevcut bir parametrenin anlamını değiştirir: önceki sonuçları yeniden üretmek için rate değerinizi yıllık bileşik dönem sayısıyla çarpın.
Her Fear & Greed değeri artık score alanının yanında index alanını da içeriyor: Bitculator'da gösterildiği şekliyle 0–100 Fear & Greed endeksi (0–19 aşırı korku, 20–39 korku, 40–59 nötr, 60–79 açgözlülük, 80–100 aşırı açgözlülük) — görüntüleme için bunu kullanın. score değişmedi: index alanının türetildiği −100…+100 aralığındaki ham bileşik değerdir. GET /sentiment/fear-greed (ana değer ve intervals içindeki her kayıt), GET /global yanıtındaki fear_greed ve GET /global/heatmap yanıtındaki meta.fear_greed için geçerlidir. Yalnızca ekleme; mevcut hiçbir alan değişmedi.
GET /coins/{slug}, maksimum arzı olmayan coinler (örneğin arzı sınırsız olan Solana ve Ethereum) için fully_diluted_valuation alanını 0 olarak döndürüyordu. Artık toplam arza başvuruyor ve hiçbiri bilinmiyorsa null dönüyor; OpenAPI sözleşmesi bunu zaten belgeliyordu.
Dolaşımdaki arzı olmayan bir coin için marketcap ve dominance null olabilir; sıralamaya girmemiş bir borsa için güven puanının score ve breakdown alanları null olur. Coin'in seçilen metrik için mevcut bir değeri yoksa POST /alarms 422 döndürür. /coins/recently-added ve /wallets/timeline artık sort parametresine uyar. /coins/gainers ve /coins/losers değişimin kendisine göre sıralanır (önceden fiilen piyasa değerine göre) ve losers 0.00 seviyesindeki coin'leri hariç tutar. Artan sıralamalar null değerleri en sona koyar. /prices, belirsiz bir sembolü en yüksek sıralamadaki aktif coin olarak çözümler. OpenAPI sözleşmesi null olabilen piyasa alanlarını işaretler ve 24 saatlik hacmi sayı olarak tanımlar.
Yayımlanan sözleşme artık medya türü düzeyinde örnekleri, her 4xx/5xx yanıtından referans verilen tek bir ortak hata şemasını, anahtarlı her çağrının döndürebileceği 401, 429 ve 500 yanıtlarını, her başarılı yanıttaki X-RateLimit-* ve X-Quota-* başlıklarını, POST /webhooks üzerinde callback olarak tanımlanan alarm.triggered teslimatını ve iletişim, lisans ve kullanım koşulları meta verilerini içeriyor. Hiçbir istek ya da yanıt değişmedi - yalnızca nasıl tanımlandıkları değişti.
Yeni: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), ortak yanıt şekillerinin JSON Schema paketi, JSON ikiziyle birlikte herkese açık bir durum sayfası, bu değişiklik günlüğü ve sürümleme ve kullanımdan kaldırma politikası.
MCP sunucusu, MCP konsolunda oluşturulan kendi anahtarlarına ve planlarına taşındı. Data API anahtarları artık /mcp adresinde kabul edilmiyor; her araç çağrısı yine bir isteğe mal oluyor.
Bitculator MCP sunucusu /mcp adresinde yayına girdi: Claude, Cursor, VS Code ve herhangi bir MCP istemcisi için Streamable HTTP üzerinden 19 salt okunur araç; REST API ile aynı ondalık dize verisini döndürür.
TypeScript, Python, PHP, Go, Rust, Java, C# ve C++ istemcileri; her biri aynı aktarım çekirdeği üzerinde tüm uç noktaları kapsar: Bearer kimlik doğrulama, zarf açma, X-Quota-* yakalama, 429 ve 5xx'te yeniden deneme, tipli hatalar ve sayfalama.
Bazı uç noktalar ve daha uzun gösterge pencereleri artık Starter veya Pro gerektiriyor. Planınızın dışındaki bir çağrı, kilidi açan planı details.required_plan alanında belirten 403 plan_required döndürür ve kota harcamaz.
Lansman: 15 grupta 85 işlem - koinler, fiyatlar, piyasalar, borsalar, cüzdanlar, global, duyarlılık, göstergeler, likidasyonlar, dönüştürme, hesaplayıcılar, editoryal, alarmlar, webhook'lar ve meta. data-api yetkisine sahip Bearer anahtarları, { data, meta } zarfı, ondalık dize hassasiyeti, X-Quota-* başlıkları, imzalı webhook'lar ve her biri kendi aylık kotasına sahip Free, Starter ve Pro planları.
Kullanımdan kaldırmalar, kaldırmadan en az altı ay önce burada ve her anahtar sahibine e-postayla duyurulur - bkz. kullanımdan kaldırma politikası. /apis.json adresindeki makine tarafından okunabilir dizin, en yeni kaydın tarihini modified damgası olarak taşır.