Log perubahan
Setiap perubahan pada Data API dan kontraknya, yang terbaru di urutan teratas. Nomor versi mengikuti kebijakan pemversian dan penghentian.
/mcp kini juga menerima MCP key sebagai header X-API-Key: YOUR_API_KEY, bagi client dan gateway seperti Smithery yang memakai Authorization khusus untuk proses masuk mereka sendiri. Authorization: Bearer terus berfungsi dan tetap menjadi metode default yang didokumentasikan; jika kedua header dikirim, yang diperiksa adalah key di X-API-Key. Data API di /api/v1 masih hanya menerima key Bearer. Autentikasi yang gagal sekarang dibatasi per key, tidak hanya per IP, sehingga key yang tidak valid dari satu client tidak lagi memblokir client lain yang berbagi IP yang sama.
GET /calculators/compound-interest membulatkan durasi ke periode pemajemukan penuh, sehingga durasi yang berakhir di tengah periode disimulasikan terlalu panjang atau terlalu pendek: 6 bulan dengan pemajemukan annually berjalan setahun penuh (12 setoran dan bunga setahun penuh), sedangkan 5 bulan tidak menjalankan satu periode pun (tanpa setoran, tanpa bunga). Periode penuh kini berjalan seperti sebelumnya, periode parsial terakhir menghasilkan bunga secara pro rata (bunga sederhana untuk pecahannya), dan setiap setoran dalam durasi dihitung. Hasil tidak berubah bila durasi merupakan bilangan bulat periode pemajemukan; parameter dan field respons tidak berubah.
API dan dokumentasinya memperlakukan rate sebagai suku bunga per periode pemajemukan, sedangkan kalkulator di situs web dan panduannya memakai suku bunga tahunan. GET /calculators/compound-interest menerapkan rate secara penuh pada setiap periode pemajemukan, sehingga 5% dengan pemajemukan bulanan tumbuh seperti 5% per bulan. rate kini adalah suku bunga nominal tahunan: setiap periode menghasilkan rate dibagi jumlah periode per tahun (5% dengan pemajemukan bulanan menghasilkan 5/12% per bulan), seperti yang kini dinyatakan meta.note. Parameter dan field respons tidak berubah; hasilnya berubah untuk setiap frekuensi pemajemukan kecuali annually. Selain itu, ketika contribution_frequency dan compound_frequency sama-sama daily atau sama-sama weekly, setoran tidak lagi tertunda atau hilang akibat pembulatan floating-point, sehingga total_contributions bisa lebih tinggi satu setoran dengan duration_unit=months. Ini mengubah makna parameter yang sudah ada: untuk mereproduksi hasil sebelumnya, kalikan rate Anda dengan jumlah periode pemajemukan per tahun.
Setiap pembacaan Fear & Greed kini memuat index di samping score: indeks Fear & Greed 0–100 persis seperti yang ditampilkan Bitculator (0–19 ketakutan ekstrem, 20–39 ketakutan, 40–59 netral, 60–79 keserakahan, 80–100 keserakahan ekstrem) — gunakan ini untuk tampilan. score tidak berubah: nilai komposit mentah −100…+100 yang menjadi dasar index. Berlaku untuk GET /sentiment/fear-greed (pembacaan utama dan setiap entri di intervals), fear_greed pada GET /global, dan meta.fear_greed pada GET /global/heatmap. Hanya penambahan; tidak ada field yang diubah.
GET /coins/{slug} mengembalikan fully_diluted_valuation sebagai 0 untuk koin tanpa pasokan maksimum (misalnya Solana dan Ethereum, yang pasokannya tidak dibatasi). Kini nilainya beralih ke pasokan total dan bernilai null jika keduanya tidak diketahui, sebagaimana sudah didokumentasikan kontrak OpenAPI.
marketcap dan dominance dapat bernilai null untuk koin tanpa suplai beredar, serta score dan breakdown trust score bernilai null untuk bursa yang belum berperingkat. POST /alarms mengembalikan 422 jika koin tidak memiliki nilai saat ini untuk metrik yang dipilih. /coins/recently-added dan /wallets/timeline kini mematuhi sort. /coins/gainers dan /coins/losers diurutkan berdasarkan perubahannya sendiri (sebelumnya secara efektif berdasarkan kapitalisasi pasar), dan losers mengecualikan koin di 0.00. Pengurutan menaik menempatkan nilai null di akhir. /prices memetakan simbol ambigu ke koin aktif dengan peringkat tertinggi. Kontrak OpenAPI menandai field pasar yang dapat bernilai null dan menetapkan tipe volume 24 jam sebagai angka.
Kontrak yang diterbitkan kini memuat contoh di level media type, satu skema error bersama yang dirujuk dari setiap respons 4xx/5xx, respons 401, 429, dan 500 yang bisa dikembalikan setiap panggilan ber-key, header X-RateLimit-* dan X-Quota-* pada setiap respons sukses, pengiriman alarm.triggered sebagai callback pada POST /webhooks, serta metadata kontak, lisensi, dan ketentuan. Tidak ada permintaan atau respons yang berubah - hanya cara mendeskripsikannya.
Baru: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), bundel JSON Schema untuk bentuk respons bersama, halaman status publik dengan kembaran JSON-nya, log perubahan ini, serta kebijakan pemversian dan penghentian.
Server MCP beralih ke key dan paketnya sendiri, yang dibuat di konsol MCP. Key Data API tidak lagi diterima di /mcp; setiap panggilan alat tetap dihitung satu permintaan.
Server MCP Bitculator mulai beroperasi di /mcp: 19 alat hanya-baca lewat Streamable HTTP untuk Claude, Cursor, VS Code, dan MCP client mana pun, mengembalikan data string desimal yang sama dengan REST API.
Client TypeScript, Python, PHP, Go, Rust, Java, C#, dan C++, masing-masing mencakup setiap endpoint di atas inti transport yang sama: autentikasi Bearer, pembongkaran envelope, penangkapan X-Quota-*, retry pada 429 dan 5xx, error bertipe, dan paging.
Sebagian endpoint dan jendela indikator yang lebih panjang kini memerlukan Starter atau Pro. Panggilan di luar paket Anda mengembalikan 403 plan_required dengan details.required_plan yang menyebutkan paket yang membukanya, dan tidak memakai kuota.
Peluncuran: 85 operasi dalam 15 grup - koin, harga, pasar, exchange, wallet, global, sentimen, indikator, likuidasi, konversi, kalkulator, editorial, alarm, webhook, dan meta. Key Bearer dengan kemampuan data-api, envelope { data, meta }, presisi string desimal, header X-Quota-*, webhook yang ditandatangani, serta paket Free, Starter, dan Pro dengan kuota bulanannya masing-masing.
Penghentian diumumkan di sini dan lewat email ke setiap pemilik key setidaknya enam bulan sebelum penghapusan - lihat kebijakan penghentian. Indeks yang dapat dibaca mesin di /apis.json memuat tanggal entri terbaru sebagai stempel modified-nya.