跳到主要内容

公开API参数

术语解释​

  • symbol 指合约交易对名称
  • pair 指合约交易对的标的物交易对
  • base asset 指合约交易对的交易对象,即标的物交易对交易对象
  • quote asset 指合约交易对的定价资产,即标的物交易对的定价资产
  • margin asset 指合约交易对使用的保证金资产

枚举定义​

交易对类型:

  • DELIVERY_CONTRACT 交割合约
  • PERPETUAL_CONTRACT 永续合约

合约类型 (contractType):

  • PERPETUAL 永续合约
  • CURRENT_QUARTER 当季合约
  • NEXT_QUARTER 次季合约
  • CURRENT_QUARTER_DELIVERING 交割中的无效类型
  • NEXT_QUARTER_DELIVERING 交割中的无效类型
  • PERPETUAL DELIVERING 交割結算中合約

合约状态 (contractStatus, status):

  • PENDING_TRADING 待上市
  • TRADING 交易中
  • PRE_DELIVERING 预结算
  • DELIVERING 交割中
  • DELIVERED 已交割

订单状态 (status):

  • NEW 新建订单
  • PARTIALLY_FILLED 部分成交
  • FILLED 全部成交
  • CANCELED 已撤销
  • EXPIRED 订单过期(根据timeInForce参数规则)

订单种类 (type):

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

订单方向 (side):

  • BUY 买入
  • SELL 卖出

持仓方向 (positionSide):

  • BOTH 单一持仓方向
  • LONG 多头(双向持仓下)
  • SHORT 空头(双向持仓下)

有效方式 (timeInForce):

  • GTC - Good Till Cancel 成交为止
  • IOC - Immediate or Cancel 无法立即成交(吃单)的部分就撤销
  • FOK - Fill or Kill 无法全部立即成交就撤销
  • GTX - Good Till Crossing 无法成为挂单方就撤销

条件价格触发类型 (workingType)

  • MARK_PRICE
  • CONTRACT_PRICE

响应类型 (newOrderRespType)

  • ACK
  • RESULT

价格匹配类型 (priceMatch)

  • NONE: 设置价格匹配
  • OPPONENT: 盘口对手价
  • OPPONENT_5: 盘口对手5档价
  • OPPONENT_10: 盘口对手10档价
  • OPPONENT_20: 盘口对手20档价
  • QUEUE: 盘口同向价
  • QUEUE_5: 盘口同向排队5档价
  • QUEUE_10: 盘口同向排队10档价
  • QUEUE_20: 盘口同向排队20档价

自成交保护类型（selfTradePreventionMode）

  • NONE: 不设置自成交保护
  • EXPIRE_TAKER: 自成交过期 taker 订单
  • EXPIRE_MAKER: 自成交过期 maker 订单
  • EXPIRE_BOTH: 自成交过期 taker 和 maker 订单

K线间隔:

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

  • 1m
  • 3m
  • 5m
  • 15m
  • 30m
  • 1h
  • 2h
  • 4h
  • 6h
  • 8h
  • 12h
  • 1d
  • 3d
  • 1w
  • 1M

限制种类 (rateLimitType)

REQUEST_WEIGHT

  {
  	"rateLimitType": "REQUEST_WEIGHT",
  	"interval": "MINUTE",
  	"intervalNum": 1,
  	"limit": 6000
  }

ORDERS

  {
  	"rateLimitType": "ORDERS",
  	"interval": "MINUTE",
  	"intervalNum": 1,
  	"limit": 1200
   }

  • REQUESTS_WEIGHT 单位时间请求权重之和上限

  • ORDERS 单位时间下单(撤单)次数上限

限制间隔

  • MINUTE

过滤器

过滤器,即Filter,定义了一系列交易规则。 共有两类,分别是针对交易对的过滤器symbol filters,和针对整个交易所的过滤器exchange filters(暂不支持)

交易对过滤器​

PRICE_FILTER 价格过滤器​

/exchangeInfo 响应中的格式:

  {
    "filterType": "PRICE_FILTER",
    "minPrice": "0.00000100",
    "maxPrice": "100000.00000000",
    "tickSize": "0.00000100"
  }

价格过滤器用于检测order订单中price参数的合法性

  • minPrice 定义了 price/stopPrice 允许的最小值
  • maxPrice 定义了 price/stopPrice 允许的最大值。
  • tickSize 定义了 price/stopPrice 的步进间隔,即price必须等于minPrice+(tickSize的整数倍) 以上每一项均可为0,为0时代表这一项不再做限制。

逻辑伪代码如下：

  • price >= minPrice
  • price <= maxPrice
  • (price-minPrice) % tickSize == 0

LOT_SIZE 订单尺寸​

/exchangeInfo 响应中的格式:*

  {
    "filterType": "LOT_SIZE",
    "minQty": "0.00100000",
    "maxQty": "100000.00000000",
    "stepSize": "0.00100000"
  }

lots是拍卖术语,这个过滤器对订单中的quantity也就是数量参数进行合法性检查。包含三个部分：

  • minQty 表示 quantity 允许的最小值.
  • maxQty 表示 quantity 允许的最大值
  • stepSize 表示 quantity允许的步进值。

逻辑伪代码如下：

  • quantity >= minQty
  • quantity <= maxQty
  • (quantity-minQty) % stepSize == 0

MARKET_LOT_SIZE 市价订单尺寸​

参考LOT_SIZE,区别仅在于对市价单还是限价单生效

MAX_NUM_ORDERS 最多订单数​

/exchangeInfo 响应中的格式:

  {
    "filterType": "MAX_NUM_ORDERS",
    "limit": 200
  }

定义了某个交易对最多允许的挂单数量(不包括已关闭的订单)

普通订单与条件订单均计算在内

PERCENT_PRICE 价格振幅过滤器​

/exchangeInfo 响应中的格式:

  {
    "filterType": "PERCENT_PRICE",
    "multiplierUp": "1.0500",
    "multiplierDown": "0.9500",
    "multiplierDecimal": 4
  }

PERCENT_PRICE 定义了基于标记价格计算的挂单价格的可接受区间.

挂单价格必须同时满足以下条件：

  • 买单: price <= markPrice * multiplierUp
  • 卖单: price >= markPrice * multiplierDown