跳到主要内容

常见问题

U本位合约 API 常见问题解答。

是否支持自我交易预防 (Self Trade Prevention, STP)?​

不支持。本 API 不提供自我交易预防功能。任何接口上都不存在 selfTradePreventionMode 和 tradeGroupId 参数，也没有 EXPIRED_IN_MATCH 订单状态。同一账户的订单可以互相撮合并正常成交。如需避免自成交，请在客户端侧自行实现检查。

下单接口如何传参?​

POST、PUT、DELETE 接口仅接受 JSON 请求体传参（Content-Type: application/json）。不支持表单编码请求体（application/x-www-form-urlencoded），也不能把 body 参数和查询字符串参数混用。GET 接口通过查询字符串传参。所有情况下，timestamp 和 signature 都放在查询字符串中用于 HMAC 鉴权。

orderId 是什么格式?​

订单 ID 是 UUID 字符串（例如 "3c9074dc-8fd5-4dfd-8f62-a2f95b9d20e2"），不是自增整数。请把 orderId 当作不透明字符串处理: 原样存储，查询或撤单时原样传回。clientOrderId 仍是用户自选的字符串，最长 36 字符。

WebSocket 连着的时候 listenKey 会一直有效吗?​

不会。listenKey 在创建或最后一次刷新后 60 分钟过期，与是否有打开的 WebSocket 连接无关。请定期调用 PUT /fapi/v1/listenKey（例如每 30 分钟一次）保持其存活。如已过期，通过 POST /fapi/v1/listenKey 重新申请。

是否支持双向持仓模式 (Hedge Mode)?​

不支持。交易所仅运行在单向持仓模式。POST /fapi/v1/positionSide/dual 传 dualSidePosition=true 会返回错误 -4059，下单必须使用 positionSide=BOTH（或省略）。LONG / SHORT 仅作为描述性字段值出现在持仓查询响应中。

是否支持逐仓 (Isolated Margin)?​

不支持。交易所仅运行在全仓模式。POST /fapi/v1/marginType 传 marginType=ISOLATED 会返回错误 -4046。

是否支持批量下单?​

不支持。POST /fapi/v1/batchOrders 不可用 — 请通过 POST /fapi/v1/order 逐笔下单。批量撤单可用: DELETE /fapi/v1/batchOrders。

支持哪些 K 线间隔?​

原生支持的间隔为 1m、5m、15m、1h、4h、1d、1w、1M。在 GET /fapi/v1/klines 上，部分其他 Binance 风格间隔会被接受但静默映射到最接近的受支持间隔；WebSocket 上只有 8 个原生间隔会产生数据。完整映射表见 枚举定义。