跳到主要内容

通用枚举定义

公开API参数​

术语解释​

base asset 指一个交易对的交易对象，即写在靠前部分的资产名。 quote asset 指一个交易对的定价资产，即写在靠后部分的资产名。

枚举定义​

交易对类型:​

FUTURE 期货

合约类型 (contractType):​

  • PERPETUAL 永续合约

这是唯一的合约类型，不提供交割合约。

合约状态 (contractStatus, status):​

  • TRADING 交易中
  • HALT 暂停交易
  • CLOSE 已下架 / 仅可平仓

订单状态 (status):​

  • NEW 新建订单（已接受，挂单中或待处理）
  • PARTIALLY_FILLED 部分成交
  • FILLED 全部成交
  • CANCELED 已撤销
  • REJECTED 订单被拒绝

条件（算法）订单还可能报告:

  • EXPIRED 触发单在触发前已过期（例如其 goodTillDate 已过）

算法订单接口上的 algoStatus 字段取值为: NEW、TRIGGERED、FINISHED、CANCELED、EXPIRED、FAILED。

订单种类 (orderTypes, type):​

  • LIMIT 限价单
  • MARKET 市价单
  • STOP 止损限价单
  • STOP_MARKET 止损市价单
  • TAKE_PROFIT 止盈限价单
  • TAKE_PROFIT_MARKET 止盈市价单
  • TRAILING_STOP_MARKET 跟踪止损单

订单方向 (side):​

  • BUY 买入
  • SELL 卖出

持仓方向 (positionSide):​

  • BOTH 单向持仓模式（下单时唯一接受的值）

不提供双向持仓（Hedge）模式: 通过 POST /fapi/v1/positionSide/dual 开启会返回错误 -4059；算法订单传入非 BOTH 的 positionSide 会返回 -1130。LONG / SHORT 仅作为只读字段值出现在持仓查询响应中（如 GET /fapi/v1/positionRisk）。

有效方式 (timeInForce):​

  • GTC - Good Till Cancel: 订单在被撤销前一直有效
  • IOC - Immediate or Cancel: 无法立即成交(吃单)的部分就撤销
  • FOK - Fill or Kill: 无法全部立即成交就整单撤销
  • GTX - Good Till Crossing (Post Only): 无法成为挂单方就拒绝
  • GTD - Good Till Date: 仅条件（算法）订单支持，且要求 goodTillDate 时间戳至少在 600 秒之后。普通订单传 GTD 会返回错误 -1102。

条件价格触发类型 (workingType)​

  • MARK_PRICE
  • CONTRACT_PRICE

注意: 该字段当前会被接受但被忽略 — 触发条件始终按标记价格判定。该值不会被持久化，因此查询响应始终报告 CONTRACT_PRICE。

K线间隔:​

m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月

原生支持的间隔（REST GET /fapi/v1/klines 与 WebSocket kline 频道）:

  • 1m, 5m, 15m, 1h, 4h, 1d, 1w, 1M

REST 上，以下 Binance 风格间隔会被接受但静默映射到最接近的受支持间隔:

请求值实际按
3m5m
30m15m
2h1h
6h4h
8h4h
12h4h
3d1d

其他任何间隔返回错误 -1120。WebSocket 上只有 8 个原生间隔会产生数据 — 用其他间隔订阅会收到确认但不会推送任何数据。

未实现 (Not Implemented)​

以下 Binance 参数在本 API 上未实现:

  • selfTradePreventionMode（STP 模式 EXPIRE_TAKER / EXPIRE_MAKER / EXPIRE_BOTH）— 见 FAQ
  • priceMatch（OPPONENT / QUEUE 盘口价下单模式）
  • newOrderRespType（ACK / RESULT）— 部分接口接受但忽略