支援與意見回饋
如何回報 API 或資料的問題,以及應附上哪些資訊以便追查。
回報問題
請使用本站的聯絡頁面。回報內容若包含下列項目,通常一次就能追查到原因。
- 完整的請求 URL,以及呼叫當下的 UTC 時間。
- 回應標頭 X-Request-Id,或錯誤內容中的 request_id。
- 你預期的結果與實際收到的結果。若是資料方面的疑問,請附上交易所、合約、你用來對照的數字及其擷取時間。
回報之前
- 查看狀態頁面,確認目前是否有事故。 服務狀態 →
- 查看資料品質矩陣中相關的交易所與資料族。大多數缺值都能由 STALE 或 UNAVAILABLE 等級解釋。 資料品質 →
- 查看參考頁面:與其他來源的出入,多半來自單位、時間視窗與覆蓋範圍的差異。 端點目錄 →
- 在 Playground 中重現該呼叫,並從那裡複製請求 ID。 API Playground →
資料差異
CoinBoss 的數字由自行採集的資料計算而得。由於擷取時間、所納入的交易所與合約類型、持倉量採單邊或雙邊、單位以及時間視窗邊界等因素,這些數字與交易所官網或其他資料網站不同是合理的。回報時若能說明這五點,處理速度最快。
申請新增資料或端點
缺少某家交易所、某個欄位或某個端點嗎?請透過聯絡頁面提出需求,並附上可供採集的交易所公開端點。沒有合法公開來源的資料會維持標示為 UNAVAILABLE。
常見問題
- 這個 API 是免費的嗎?
- 是的。目前所有資料端點皆公開且免費,限制為每分鐘 1200 次請求。
- 我需要 API 金鑰嗎?
- 不需要。金鑰為選用,只會改變速率限制計算請求的方式。
- 為什麼數值是 null?
- 因為數值未知:交易所沒有公布、紀錄已過期,或 CoinBoss 未採集。coverage 區塊與資料品質頁面會說明原因。
- 資料可以用於商業用途嗎?
- 使用條件請見本站的服務條款。
- 要怎麼得知有哪些變更?
- 更新日誌會列出每一項變更。目前版本內的變更只增不減。