BitMEX API更新:GET /api/v1/user/csa 将返回全部有效CSA借款
BitMEX 正在更新其 API 端点 GET /api/v1/user/csa。自 2026 年 6 月 11 日 06:00 UTC 起,该端点的返回格式将改变:用于让交易者与集成方能够稳定读取账户下“全部有效的 CSA 借款”。
此前,GET /api/v1/user/csa 可能返回单个 CSA 对象,或在没有有效贷款时返回 204 No Content。更新后,GET /api/v1/user/csa 将始终返回 200 OK,并以包含数组的封装对象形式返回:response.csas。
空数据行为也同步调整:若账户没有任何有效 CSA,将返回 200 OK 且 csas: [],而不是 204。
同时支持同一账户下多笔 CSAs:如果存在多笔有效 CSA 借款(通常按抵押币种分别持有),API 会将全部记录作为数组返回。
csaStatus 字段会覆盖完整借款生命周期。被取消(Cancelled)与被拒绝(Rejected)的贷款不会出现在响应中。可能的状态包括 New、PendingNew、MarginCall、Liquidated、Replaced、PendingCancellation 等。其他字段(如 csaID、account、currency、amount、mmRatioMarginCall、maintMarginRatio 等)保持不变。
需要采取的操作:使用 GET /api/v1/user/csa 的客户端应将 response.csas 解析为数组,处理 200 OK 下的 csas: [],并在存在多笔 CSA 时进行遍历。
中性
这次属于 API 合约层面的变更,而不是交易规则或风险参数的调整。因此对市场的直接影响有限。对交易者而言,影响主要体现在:自动化的保证金管理、强平/风控告警、敞口统计与监控系统,若仍依赖“204 No Content”或假设只会返回单一 CSA 对象,可能会出现数据缺失或解析错误。
短期内,未及时更新接口解析逻辑的集成方可能导致面板展示异常或策略/告警中断。长期来看,API 通过返回全部有效 CSA 借款,并将响应统一为“200 OK + 数组”,会提升数据完整性与一致性。
类似交易所往期的 API 更新通常不会直接改变流动性与订单簿,因此市场情绪多为中性;但对机器人与分析平台的“运维/数据可用性”会产生阶段性摩擦。