API 变更日志与版本管理
追踪API变更、重大更新及迁移路径。及时了解新功能并制定升级策略。
API 版本
Smart Money API 采用语义化版本控制。所有端点URL路径均支持版本参数。
当前稳定版本： v1（推荐所有新集成使用）
版本策略
我们保证主版本内的向后兼容性。次版本会新增字段和功能而不引入破坏性变更。主版本升级将提前6个月通知并包含破坏性变更。
当前版本：v1
发布日期：2025-06-15 | 状态：稳定 | 终止支持：2028-06-15
v1 功能
- 含15+端点的REST API
- WebSocket实时流传输
- 巨鲸持仓追踪（600+钱包）
- 资金费率聚合（3家交易所）
- 未平仓合约与强平数据
- AI确认评分
- 链上指标（比特币、以太坊）
- 批量操作（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个月通知。我们会为所有破坏性变更提供清晰迁移指南。