跳到主要内容

交易所信息

交易对元信息：交易状态、基础/计价资产、精度，以及订单过滤器。

接口​

GET /v1/market/exchange-info

权重： 10。

鉴权： 公开（可选签名）。

查询参数​

名称类型必填说明
symbolstring否若提供，响应中的 symbols 数组仅包含该交易对；若省略，则返回所有上线的交易对。

响应​

{
  "serverTime": 1745923200123,
  "symbols": [
    {
      "symbol": "BTCUSDT",
      "status": "trading",
      "baseAsset": "BTC",
      "quoteAsset": "USDT",
      "pricePrecision": 2,
      "quantityPrecision": 6,
      "filters": [
        {
          "filterType": "PRICE_FILTER",
          "minPrice": "0.01",
          "maxPrice": "1000000.00",
          "tickSize": "0.01"
        },
        {
          "filterType": "LOT_SIZE",
          "minQty": "0.000001",
          "maxQty": "9000.000000",
          "stepSize": "0.000001"
        },
        {
          "filterType": "MARKET_LOT_SIZE",
          "minQty": "0.000001",
          "maxQty": "120.000000",
          "stepSize": "0.000001"
        },
        {
          "filterType": "MIN_NOTIONAL",
          "minNotional": "5.00"
        },
        {
          "filterType": "MAX_NUM_ORDERS",
          "maxNumOrders": 200
        }
      ]
    }
  ]
}

响应字段​

字段类型说明
serverTimeinteger服务器时间，Unix 毫秒（ms）。可用于签名前的时钟偏差检查。
symbolsarray交易对元信息对象的数组（见下方）。

Symbol 对象​

字段类型说明
symbolstring交易对，大写。
statusenum取值之一：trading、halt、post_only、break。
baseAssetstring基础资产代码，例如 BTC。
quoteAssetstring计价资产代码，例如 USDT。
pricePrecisionintegerprice 允许的最大小数位数。
quantityPrecisionintegerqty 允许的最大小数位数。
filtersarray订单校验过滤器。详见下文。

状态取值​

状态含义
trading交易对开放，可同时进行挂单与吃单。
halt交易暂停；不接受新订单，已有订单冻结。
post_only仅接受 post-only（不可主动成交）订单。吃单将被拒绝。
break计划内交易中断（例如维护窗口）。无任何订单活动。

过滤器类型​

每个过滤器对象都有 filterType 字段。客户端在提交订单前应针对每个过滤器进行校验。

filterType字段说明
PRICE_FILTERminPrice、maxPrice、tickSize（均为字符串）price 必须满足 minPrice ≤ price ≤ maxPrice 且 (price - minPrice) % tickSize == 0。
LOT_SIZEminQty、maxQty、stepSize（均为字符串）适用于限价单。qty 必须满足 minQty ≤ qty ≤ maxQty 且 (qty - minQty) % stepSize == 0。
MARKET_LOT_SIZEminQty、maxQty、stepSize（均为字符串）规则同 LOT_SIZE，作用于市价单。
MIN_NOTIONALminNotional（字符串）price * qty 必须不小于 minNotional（以计价资产计）。
MAX_NUM_ORDERSmaxNumOrders（整数）单个账户在该交易对上可持有的最大未成交订单数。

错误​

HTTP错误码含义
400UNKNOWN_SYMBOL请求的 symbol 不存在。
429RATE_LIMITED单个 Key 的请求权重已超限。

示例​

curl -s "https://api.pipai.io/v1/market/exchange-info"
curl -s "https://api.pipai.io/v1/market/exchange-info?symbol=BTCUSDT"