API 更新日誌與版本控制
追蹤 API 變更、重大更新與遷移路徑。掌握新功能資訊並策略性規劃升級。
API 版本
Smart Money API 採用語意化版本控制。所有端點支援 URL 路徑中的版本參數。
當前穩定版本： v1（推薦所有新整合使用）
版本控制政策
我們維護主要版本內的向後兼容性。次要版本新增欄位與功能而不造成破壞性變更。主要版本升級將提前6個月通知並引入破壞性變更。
當前版本：v1
發佈日期：2025-06-15 | 狀態：穩定 | 終止支援：2028-06-15
v1 功能
- 含15+端點的 REST API
- WebSocket 即時串流
- 巨鯨部位追蹤（600+錢包）
- 資金費率聚合（3家交易所）
- 未平倉合約與清算數據
- AI 確認評分
- 鏈上指標（Bitcoin、Ethereum）
- 批次操作（100請求/批次）
- 事件通知的 Webhook
近期更新日誌
v1.2.4 新增
發佈於 2026-03-18
- 新端點：/v1/on-chain/whale-flows — 追蹤巨鯨錢包存取款
- 強化含情緒分析的確認評分
- WebSocket 壓縮支援（gzip、deflate）
- 附解決步驟的改進錯誤訊息
v1.2.3
發佈於 2026-02-28
- 新增巨鯨部位的 margin_ratio 欄位
- 延長清算歷史至30天（原為7天）
- 提升 Webhook 傳遞可靠性
v1.2.0
發佈於 2026-01-15
- 重大：未平倉合約端點（Pro 等級）
- 重大：鏈上指標端點（Pro 等級）
- 新增分頁限制：500（原為100）
- 批次操作支援
遷移指南
遷移至 v1.2.0
未平倉合約與鏈上指標為新增端點，不影響現有整合。無需遷移。
選擇性升級： 使用新 open_interest 端點獲得更佳市場分析。
廢棄與移除功能
v1 目前無廢棄端點。所有文件記載端點均持續支援。
未來廢棄功能（v2 計劃）
以下端點將於 v2.0（計劃2027年）廢棄。提供遷移路徑。
當前無。v1 穩定且完全向後兼容。
終止支援政策
廢棄端點將提前6個月通知後移除。我們為所有破壞性變更提供明確遷移指南。