Nhật ký thay đổi
Mọi thay đổi của Data API và hợp đồng của nó, mới nhất trước. Số phiên bản tuân theo chính sách phiên bản và ngừng hỗ trợ.
/mcp giờ cũng chấp nhận MCP key dưới dạng header X-API-Key: YOUR_API_KEY, nhằm hỗ trợ các client và gateway như Smithery, vốn dành riêng Authorization cho việc đăng nhập của chính chúng. Authorization: Bearer tiếp tục hoạt động và vẫn là phương thức mặc định được nêu trong tài liệu; khi gửi cả hai header, key được kiểm tra là key trong X-API-Key. Data API tại /api/v1 tiếp tục chỉ chấp nhận Bearer key. Từ nay, các lần xác thực thất bại bị giới hạn tần suất theo từng key chứ không chỉ theo IP, nên key không hợp lệ của một client không còn khiến các client khác dùng chung IP đó bị chặn nữa.
GET /calculators/compound-interest đã làm tròn thời hạn thành số kỳ ghép lãi nguyên, nên thời hạn kết thúc giữa một kỳ bị mô phỏng quá dài hoặc quá ngắn: 6 tháng với ghép lãi annually chạy trọn một năm (12 lần nạp tiền và lãi của cả năm), còn 5 tháng không chạy kỳ nào (không nạp tiền, không có lãi). Giờ đây các kỳ trọn vẹn vẫn được tính như trước, kỳ chưa trọn cuối cùng được tính lãi theo tỷ lệ (lãi đơn cho phần lẻ) và mọi lần nạp tiền trong thời hạn đều được tính. Kết quả không đổi khi thời hạn là số nguyên kỳ ghép lãi; tham số và các trường phản hồi không đổi.
API và tài liệu của nó từng coi rate là lãi suất mỗi kỳ ghép lãi, trong khi công cụ tính trên trang web và hướng dẫn sử dụng dùng lãi suất hằng năm. GET /calculators/compound-interest từng áp dụng toàn bộ rate cho mỗi kỳ ghép lãi, nên 5% ghép lãi hằng tháng tăng như 5% mỗi tháng. Giờ đây rate là lãi suất danh nghĩa hằng năm: mỗi kỳ nhận rate chia cho số kỳ trong năm (5% ghép lãi hằng tháng nghĩa là 5/12% mỗi tháng), như meta.note hiện nêu rõ. Tham số và các trường phản hồi không đổi; kết quả thay đổi với mọi tần suất ghép lãi trừ annually. Ngoài ra, khi contribution_frequency và compound_frequency cùng là daily hoặc cùng là weekly, các khoản nạp không còn bị trễ hay bị bỏ sót do sai số làm tròn số dấu phẩy động, nên total_contributions có thể cao hơn một khoản nạp khi dùng duration_unit=months. Điều này thay đổi ý nghĩa của một tham số hiện có: để tái tạo kết quả trước đây, hãy nhân rate của bạn với số kỳ ghép lãi mỗi năm.
Mỗi giá trị Fear & Greed giờ có thêm index bên cạnh score: chỉ số Fear & Greed 0–100 đúng như Bitculator hiển thị (0–19 cực kỳ sợ hãi, 20–39 sợ hãi, 40–59 trung lập, 60–79 tham lam, 80–100 cực kỳ tham lam) — hãy dùng nó để hiển thị. score không đổi: đây là giá trị tổng hợp thô −100…+100 mà index được suy ra từ đó. Áp dụng cho GET /sentiment/fear-greed (giá trị chính và mọi mục trong intervals), fear_greed trên GET /global và meta.fear_greed trên GET /global/heatmap. Chỉ bổ sung; không trường hiện có nào thay đổi.
GET /coins/{slug} từng trả về fully_diluted_valuation là 0 cho các coin không có nguồn cung tối đa (ví dụ Solana và Ethereum, có nguồn cung không giới hạn). Giờ đây giá trị dùng tổng cung thay thế và là null khi không biết cả hai, như hợp đồng OpenAPI đã ghi nhận.
marketcap và dominance có thể là null với coin không có nguồn cung lưu hành, còn score và breakdown của điểm tin cậy là null với sàn giao dịch chưa được xếp hạng. POST /alarms trả về 422 khi coin không có giá trị hiện tại cho chỉ số đã chọn. /coins/recently-added và /wallets/timeline giờ tuân theo sort. /coins/gainers và /coins/losers được sắp xếp theo chính mức thay đổi (trước đây thực chất theo vốn hóa thị trường), và losers loại trừ các coin ở mức 0.00. Sắp xếp tăng dần trả về giá trị null ở cuối. /prices quy một ký hiệu mơ hồ về coin đang hoạt động có thứ hạng cao nhất. Hợp đồng OpenAPI đánh dấu các trường thị trường có thể là null và định kiểu khối lượng 24h là số.
Hợp đồng đã công bố nay mang theo ví dụ ở cấp media type, một schema lỗi dùng chung được tham chiếu từ mọi phản hồi 4xx/5xx, các phản hồi 401, 429 và 500 mà mọi lệnh gọi có key đều có thể trả về, các header X-RateLimit-* và X-Quota-* trên mọi phản hồi thành công, lần gửi alarm.triggered dưới dạng callback trên POST /webhooks, cùng siêu dữ liệu về liên hệ, giấy phép và điều khoản. Không có request hay phản hồi nào thay đổi - chỉ thay đổi cách mô tả chúng.
Mới: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), một gói JSON Schema của các cấu trúc phản hồi dùng chung, một trang trạng thái công khai kèm bản JSON song song, nhật ký thay đổi này, và chính sách phiên bản và ngừng hỗ trợ.
Máy chủ MCP đã chuyển sang key và gói riêng, được tạo trong bảng điều khiển MCP. /mcp không còn chấp nhận Data API key; mỗi lệnh gọi công cụ vẫn tốn một request.
Máy chủ Bitculator MCP đã hoạt động tại /mcp: 19 công cụ chỉ đọc qua Streamable HTTP cho Claude, Cursor, VS Code và bất kỳ MCP client nào, trả về cùng dữ liệu chuỗi thập phân như REST API.
Các client TypeScript, Python, PHP, Go, Rust, Java, C# và C++, mỗi client bao phủ mọi endpoint trên cùng một lõi truyền tải: xác thực Bearer, bóc tách envelope, ghi nhận X-Quota-*, thử lại khi gặp 429 và 5xx, lỗi có kiểu và phân trang.
Một số endpoint và các cửa sổ chỉ báo dài hơn nay yêu cầu gói Starter hoặc Pro. Lệnh gọi ngoài phạm vi gói của bạn trả về 403 plan_required với details.required_plan nêu tên gói mở khóa nó, và không tiêu tốn hạn ngạch.
Ra mắt: 85 thao tác trên 15 nhóm - coin, giá, thị trường, sàn giao dịch, ví, toàn cầu, tâm lý thị trường, chỉ báo, thanh lý, chuyển đổi, công cụ tính toán, nội dung biên tập, báo động, webhook và meta. Bearer key với quyền data-api, envelope { data, meta }, độ chính xác chuỗi thập phân, các header X-Quota-*, webhook có chữ ký, và các gói Free, Starter và Pro với hạn ngạch hàng tháng riêng.
Việc ngừng hỗ trợ được công bố tại đây và qua email tới mọi chủ sở hữu key ít nhất sáu tháng trước khi gỡ bỏ - xem chính sách ngừng hỗ trợ. Chỉ mục máy đọc được tại /apis.json mang ngày của mục mới nhất làm dấu modified của nó.