บันทึกการเปลี่ยนแปลง
ทุกการเปลี่ยนแปลงของ Data API และสัญญาของมัน เรียงจากใหม่สุดก่อน หมายเลขเวอร์ชันเป็นไปตามนโยบายการกำหนดเวอร์ชันและการเลิกใช้
ตอนนี้ /mcp รับคีย์ MCP เป็นเฮดเดอร์ X-API-Key: YOUR_API_KEY ได้ด้วย เพื่อรองรับไคลเอนต์และเกตเวย์อย่าง Smithery ที่สงวน Authorization ไว้ใช้กับการเข้าสู่ระบบของตัวเอง Authorization: Bearer ใช้งานได้ต่อไปและยังคงเป็นวิธีเริ่มต้นที่ระบุในเอกสาร เมื่อส่งเฮดเดอร์ทั้งสองมาพร้อมกัน คีย์ที่ระบบตรวจสอบคือคีย์ใน X-API-Key ส่วน Data API ที่ /api/v1 ยังรับเฉพาะคีย์แบบ Bearer เท่านั้น ขณะนี้การยืนยันตัวตนที่ล้มเหลวจะถูกจำกัดอัตราทั้งต่อคีย์และต่อ IP คีย์ที่ไม่ถูกต้องของไคลเอนต์รายหนึ่งจึงไม่ทำให้ไคลเอนต์อื่นที่ใช้ IP เดียวกันถูกล็อกไม่ให้เข้าใช้งานอีกต่อไป
GET /calculators/compound-interest เคยปัดระยะเวลาเป็นจำนวนงวดทบต้นเต็ม ระยะเวลาที่สิ้นสุดกลางงวดจึงถูกจำลองยาวหรือสั้นเกินไป: 6 เดือนที่ทบต้นแบบ annually ถูกคำนวณเต็มหนึ่งปี (ฝากเงิน 12 ครั้งและดอกเบี้ยเต็มปี) ส่วน 5 เดือนไม่ถูกคำนวณเลยแม้แต่งวดเดียว (ไม่มีการฝากเงินและไม่มีดอกเบี้ย) ตอนนี้งวดเต็มยังคำนวณเหมือนเดิม งวดสุดท้ายที่ไม่ครบงวดได้รับดอกเบี้ยตามสัดส่วน (ดอกเบี้ยแบบธรรมดาสำหรับส่วนนั้น) และนับการฝากเงินทุกครั้งที่อยู่ในระยะเวลา ผลลัพธ์จะไม่เปลี่ยนเมื่อระยะเวลาเป็นจำนวนงวดทบต้นเต็ม พารามิเตอร์และฟิลด์ในการตอบกลับไม่เปลี่ยนแปลง
API และเอกสารประกอบเคยถือว่า rate เป็นอัตราต่อรอบการทบต้น ขณะที่เครื่องคำนวณบนเว็บไซต์และคู่มือการใช้งานใช้อัตราต่อปี GET /calculators/compound-interest เคยใช้ rate เต็มจำนวนกับทุกรอบการทบต้น ทำให้ 5% ที่ทบต้นรายเดือนเติบโตเหมือน 5% ต่อเดือน ตอนนี้ rate คืออัตราดอกเบี้ยตามสัญญาต่อปี: แต่ละรอบจะได้รับ rate หารด้วยจำนวนรอบต่อปี (5% ทบต้นรายเดือนจะได้ 5/12% ต่อเดือน) ตามที่ meta.note ระบุไว้แล้ว พารามิเตอร์และฟิลด์ของการตอบกลับไม่เปลี่ยนแปลง ผลลัพธ์จะเปลี่ยนไปในทุกความถี่การทบต้น ยกเว้น annually นอกจากนี้ เมื่อ contribution_frequency และ compound_frequency เป็น daily ทั้งคู่หรือเป็น weekly ทั้งคู่ เงินฝากจะไม่ล่าช้าหรือตกหล่นเพราะการปัดเศษของเลขทศนิยมลอยตัวอีกต่อไป จึงทำให้ total_contributions อาจสูงขึ้นเท่ากับเงินฝากหนึ่งงวดเมื่อใช้ duration_unit=months การเปลี่ยนแปลงนี้เปลี่ยนความหมายของพารามิเตอร์ที่มีอยู่: หากต้องการได้ผลลัพธ์แบบเดิม ให้คูณ rate ของคุณด้วยจำนวนงวดทบต้นต่อปี
ค่า Fear & Greed ทุกค่าตอนนี้มี index คู่กับ score ซึ่งคือดัชนี Fear & Greed 0–100 ตรงตามที่ Bitculator แสดง (0–19 กลัวสุดขีด, 20–39 กลัว, 40–59 เป็นกลาง, 60–79 โลภ, 80–100 โลภสุดขีด) — ใช้ค่านี้สำหรับการแสดงผล score ไม่เปลี่ยนแปลง: เป็นค่าผสมดิบ −100…+100 ที่ใช้คำนวณ index มีผลกับ GET /sentiment/fear-greed (ค่าหลักและทุกรายการใน intervals), fear_greed ใน GET /global และ meta.fear_greed ใน GET /global/heatmap เป็นการเพิ่มเท่านั้น ไม่มีฟิลด์เดิมใดเปลี่ยนแปลง
GET /coins/{slug} เคยส่งคืน fully_diluted_valuation เป็น 0 สำหรับเหรียญที่ไม่มีอุปทานสูงสุด (เช่น Solana และ Ethereum ซึ่งอุปทานไม่มีเพดาน) ตอนนี้จะใช้อุปทานทั้งหมดแทน และเป็น null เมื่อไม่ทราบทั้งสองค่า ตามที่สัญญา OpenAPI ระบุไว้อยู่แล้ว
marketcap และ dominance อาจเป็น null สำหรับเหรียญที่ไม่มีอุปทานหมุนเวียน และ score กับ breakdown ของคะแนนความน่าเชื่อถือจะเป็น null สำหรับกระดานเทรดที่ยังไม่ถูกจัดอันดับ POST /alarms จะคืนค่า 422 เมื่อเหรียญไม่มีค่าปัจจุบันสำหรับตัวชี้วัดที่เลือก /coins/recently-added และ /wallets/timeline รองรับ sort แล้ว /coins/gainers และ /coins/losers เรียงตามค่าการเปลี่ยนแปลงโดยตรง (เดิมเรียงตามมูลค่าตลาดโดยพฤตินัย) และ losers จะไม่รวมเหรียญที่อยู่ที่ 0.00 การเรียงจากน้อยไปมากจะวางค่า null ไว้ท้ายสุด /prices จะแปลงสัญลักษณ์ที่กำกวมไปเป็นเหรียญที่ใช้งานอยู่ซึ่งมีอันดับสูงสุด ส่วนสัญญา OpenAPI ได้กำกับฟิลด์ตลาดที่เป็น null ได้ และกำหนดให้ปริมาณการซื้อขาย 24 ชม. เป็นตัวเลข
สัญญาที่เผยแพร่ตอนนี้มีตัวอย่างในระดับ media-type, สคีมาข้อผิดพลาดกลางหนึ่งชุดที่ถูกอ้างอิงจากทุกการตอบกลับ 4xx/5xx, การตอบกลับ 401, 429 และ 500 ที่ทุกการเรียกด้วยคีย์อาจได้รับ, เฮดเดอร์ X-RateLimit-* และ X-Quota-* ในทุกการตอบกลับที่สำเร็จ, การส่ง alarm.triggered ในรูปแบบ callback บน POST /webhooks รวมถึงข้อมูลเมตาด้านการติดต่อ สัญญาอนุญาต และเงื่อนไขการใช้งาน ไม่มีคำขอหรือการตอบกลับใดเปลี่ยนแปลง - เปลี่ยนเพียงวิธีอธิบายเท่านั้น
ใหม่: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), ชุด JSON Schema ของรูปแบบการตอบกลับที่ใช้ร่วมกัน, หน้าสถานะสาธารณะพร้อมเวอร์ชัน JSON คู่กัน, บันทึกการเปลี่ยนแปลงฉบับนี้ และนโยบายการกำหนดเวอร์ชันและการเลิกใช้
เซิร์ฟเวอร์ MCP ย้ายไปใช้คีย์และแพ็กเกจของตัวเอง ซึ่งสร้างได้ในคอนโซล MCP คีย์ Data API ใช้กับ /mcp ไม่ได้อีกต่อไป การเรียกเครื่องมือแต่ละครั้งยังคงนับเป็นหนึ่งคำขอเช่นเดิม
เซิร์ฟเวอร์ MCP ของ Bitculator เปิดใช้งานแล้วที่ /mcp: เครื่องมือแบบอ่านอย่างเดียว 19 รายการผ่าน Streamable HTTP สำหรับ Claude, Cursor, VS Code และไคลเอนต์ MCP ใดก็ได้ โดยคืนข้อมูลสตริงทศนิยมชุดเดียวกับ REST API
ไคลเอนต์ TypeScript, Python, PHP, Go, Rust, Java, C# และ C++ แต่ละตัวครอบคลุมทุก endpoint บนแกนการรับส่งข้อมูลเดียวกัน ได้แก่ การยืนยันตัวตนแบบ Bearer, การแกะ envelope, การเก็บค่า X-Quota-*, การลองใหม่เมื่อเจอ 429 และ 5xx, ข้อผิดพลาดแบบมีชนิดข้อมูล และการแบ่งหน้า
บาง endpoint และช่วงเวลาของอินดิเคเตอร์ที่ยาวขึ้นต้องใช้แพ็กเกจ Starter หรือ Pro การเรียกที่อยู่นอกแพ็กเกจของคุณจะคืนค่า 403 plan_required พร้อม details.required_plan ที่ระบุแพ็กเกจซึ่งปลดล็อกการเรียกนั้น และจะไม่นับรวมในโควตา
เปิดตัว: 85 การทำงานใน 15 กลุ่ม - coins, prices, markets, exchanges, wallets, global, sentiment, indicators, liquidations, conversion, calculators, editorial, alarms, webhooks และ meta พร้อมคีย์แบบ Bearer ที่มีสิทธิ์ data-api, envelope { data, meta }, ความแม่นยำแบบสตริงทศนิยม, เฮดเดอร์ X-Quota-*, webhook ที่ลงลายเซ็น และแพ็กเกจ Free, Starter และ Pro ที่มีโควตารายเดือนของตัวเอง
การเลิกใช้จะประกาศที่นี่และส่งอีเมลถึงเจ้าของคีย์ทุกคน อย่างน้อยหกเดือนก่อนการนำออก - ดูนโยบายการเลิกใช้ ดัชนีที่เครื่องอ่านได้ที่ /apis.json ใช้วันที่ของรายการใหม่ล่าสุดเป็นค่า modified