跳到主要内容

更新日志

2026-10-23​

  • 新增 — 合约 WebSocket protocolbuffers 接入方案文档：Protobuf 连接地址（wss://contract.mexc.com/edge?Trans-Protocol=Protobuf）、PB 定义文件、代码生成、反序列化示例，以及订阅 / 取消订阅 / PING 示例。合约 WebSocket 同时支持 JSON 与 Protobuf。
  • 更新 — 原生 ws 连接地址：补充 JSON 与 Protobuf 两种连接地址说明。

2026-10-19​

  • 更新 — WebSocket 深度频道（push.depth）：新增返回字段 symbol（合约）、begin（起始版本号）、end（结束版本号）、ts（系统时间戳）；更新示例返回值。
  • 新增 — 补充 GET /api/v1/private/position/leverage/subaccount（获取子账户持仓杠杆倍数）接口文档：请求参数 subAccount、symbol；返回含 subAccount、symbol、positionType、openType、leverage、maxLeverageView、currentMmr。权限：读取订单信息（仅母账户 API Key）；限速：20次/2秒。
  • 新增 — 补充 GET /api/v1/private/position/position_mode/subaccount（获取子账户仓位模式）接口文档：请求参数 subAccount；返回含 subAccount、positionMode。权限：读取订单信息（仅母账户 API Key）；限速：20次/2秒。

2026-09-11​

  • 新增 — 补充 POST /api/v1/private/multiAssets/changeMultiAssetMode/{isMultiAssetMode}（联保保证金模式切换）接口文档：路径参数 isMultiAssetMode（true 开通，false 关闭）；返回字段 success、code、msg、data。权限：交易下单；限速：20次/2秒。

2026-09-01​

  • 文档 — GET /api/v1/private/order/open_order_total_count（查询在途订单数量）：修正请求参数，删除错误的 orderId、price、vol；该接口无业务请求参数。
  • 文档 — GET /api/v1/private/order/open_order_total_count（查询在途订单数量）：更新返回参数说明，补充 sumCount、limitOrderCount、stopOrderCount、planOrderCount、trackOrderCount 字段定义。

2026-06-18​

  • 更新 — GET /api/v1/private/account/tiered_fee_rate/v2（获取手续费详情）：响应新增 minLeverage、maxLeverage、isMaxLeverage（当前账户 UID 在指定合约下的可用杠杆范围及最大杠杆标签）；更新示例返回值。
  • 更新 — GET /api/v1/private/position/open_positions（获取用户当前持仓）：响应新增 positionDrop、lowSaveTotalFee、feeRates（含 min、max）、unRealizedPnl；更新示例返回值。
  • 更新 — WebSocket 成交频道（push.deal）：成交数据新增 cts（撮合引擎时间戳）；更新示例数据。
  • 更新 — WebSocket 深度频道（push.depth）：深度数据新增 cts；更新示例返回值。

2026-05-22​

  • 文档 — 下线接口文档「0费率交易对」（GET /api/v1/private/account/contract/zero_fee_rate）。

2026-05-19​

  • 文档 — 合约文档导航重构：原 账户和交易接口 拆分为 账户、交易 模块；各模块补充 index 说明页（含鉴权提示）。
  • 文档 — error-code：错误码独立成篇（侧栏 错误码）；国际化说明归入 接入说明。

2026-05-12​

  • 文档 — 下线独立文档页《指定合约手续费明细说明》；合约维度手续费相关字段仍可在 获取合约信息 及其他手续费类接口文档中查阅。

2026-05-08​

  • 文档 — 合约文档：将原先聚合的账户与交易等板块说明拆分为各接口独立页面，并归入对应模块目录，便于侧栏导航与按接口查阅。

2026-05-03​

  • 文档 — GET /api/v1/contract/detail/country：补全 data 下合约对象的响应字段说明，并更新示例返回值（手续费模式、风险档位、apiAllowed / feeRateMode 等字段与示例数据）。

2026-04-25​

  • 文档 — POST /api/v1/private/order/create：明确成功时 success 为 true 且 data 为对象，包含字符串 orderId 与 Unix 毫秒时间戳 ts；失败时 success 为 false 且 data 为 null。

2026-04-18​

  • 文档 — GET /api/v1/contract/funding_rate/{symbol}：更新请求参数表（含 symbol 是否必填的文档说明），并在响应字段与示例中补充 idxPrice、fairPrice。

2026-03-31​

  • 更新 — 合约交易 API 维护结束，交易访问已重新开放。

2026-01-19​

  • 新增 — STP 与批量下单相关能力；合约 REST 域名更新为 https://api.mexc.com。

2025-12-08​

  • 新增 — WebSocket 频道推送频率说明。

2025-12-05​

  • 新增 — WebSocket 增量深度订单簿维护机制。

2025-12-02​

  • 新增 — 新增接口 api/v1/private/order/list/open_orders，移除接口 api/v1/private/order/open_orders、api/v1/private/order/close_orders。

2025-11-25​

  • 新增 — 合约 WebSocket 整体更新，包含 Web/APP 登录相关能力。

2025-11-03​

  • 新增 — 合约 API 整体更新，包含国际化支持与错误码优化。

2025-08-21​

  • 更新 — 订阅 WebSocket 成交数据：默认启用合并推送（compress 为 true）。

2025-04-09​

  • 更新 — 订阅 WebSocket 增量深度数据：默认启用合并推送（compress 为 true）。

2024-01-31​

  • 更新 — WebSocket 链接地址修改为 wss://contract.mexc.com/edge。

2022-07-25​

  • 维护 — 合约 API 长期维护期间，下单与撤单类交易接口暂不开放；查询类接口仍可使用。

2022-07-07​

  • 新增 — 获取合约详细信息接口新增返回字段 apiAllowed（true | false），表示是否支持 API 交易。

2021-03-30​

  • 更新 — 调整如下接口访问路径及数据返回格式（原路径仍支持，但将逐步废弃）：获取用户所有历史订单、获取用户当前未结束订单、获取用户历史持仓信息、获取止盈止损订单列表、获取计划委托订单列表、获取用户所有订单成交明细。

2021-01-15​

  • 新增 — 合约 API 发布。