Skip to content

行情接口

获取服务器时间

  • GET /api/v1/time

获取服务器时间

权重: 1

参数: NONE

响应:

json
{
  "serverTime": 1538323200000
}

获取交易规则和交易对

  • GET /api/v1/exchangeInfo

获取交易规则和交易对

权重:1

参数:NONE

响应:

json
{
  "timezone": "UTC",
  "brokerFilters": [],
  "symbols": [ // 现货交易对
    {
      "filters":[
          {
              "minPrice":"0.01",
              "maxPrice":"100000.00000000",
              "tickSize":"0.01",
              "filterType":"PRICE_FILTER"
          },
          {
              "minQty":"0.0001", // 最小交易数量, 注意这里是币的数量不是张数
              "maxQty":"4000", // 最大交易数量, 注意这里是币的数量不是张数
              "stepSize":"0.0001",
              "filterType":"LOT_SIZE"
          },
          {
              "minNotional":"10",
              "filterType":"MIN_NOTIONAL"
          },
          {
              "minAmount":"10", // 最小交易额
              "maxAmount":"6600000", // 最大交易额
              "minBuyPrice":"0.01", // 最小买入价格
              "filterType":"TRADE_AMOUNT" 
          },
          {
              "maxSellPrice":"99999999", // 限价最大卖出价格
              "buyPriceUpRate":"0.1", // 限价最大卖出价格
              "sellPriceDownRate":"0.1", // 限价最大卖出价格
              "sellPriceDownRate":"0.1", // 限价最大卖出价格
              "maxEntrustNum":"100000",  // 委托单最大比数(合约)
              "maxConditionNum":"100000", // 条件单最大比数(合约
              "filterType":"LIMIT_TRADING"
          },
          {
              "buyPriceUpRate":"0.1", // 买入不能高于标记(合约)/最新(现货)价的 10%
              "sellPriceDownRate":"0.1", // 卖出不能低于标记(合约)/最新(现货)价的 10%
              "filterType":"MARKET_TRADING"
          },
          {
              "noAllowMarketStartTime":"0", // 不允许使用市价单开始时间 
              "noAllowMarketEndTime":"0", // 不允许使用市价单结束时间
              "limitOrderStartTime":"0", // 限时限价单开始时间
              "limitOrderEndTime":"0", // 限时限价单结束时间
              "limitMinPrice":"0", // 限时限价单最低价格
              "limitMaxPrice":"0", // 限时限价单最高价格
              "filterType":"OPEN_QUOTE"
          }
      ],
      "exchangeId": "301",
      "symbol": "ETHUSDT",
      "symbolName": "ETHUSDT",
      "status": "TRADING",
      "baseAsset": "ETH",
      "baseAssetName": "ETH",
      "baseAssetPrecision": "0.0001",
      "quoteAsset": "USDT",
      "quoteAssetName": "USDT",
      "quotePrecision": "0.01",
      "icebergAllowed": false,
      "isAggregate": false,
      "allowMargin": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalUnit": 1,
      "limit": 3000
    },
    {
      "rateLimitType": "ORDERS",
      "interval": "SECOND",
      "intervalUnit": 60,
      "limit": 60
    }
  ],
  "options": [],
  "contracts": [ // 合约交易对
    {
      "filters":[
          {
              "minPrice":"0.01",
              "maxPrice":"100000.00000000",
              "tickSize":"0.01",
              "filterType":"PRICE_FILTER"
          },
          {
              "minQty":"0.0001",
              "maxQty":"4000",
              "stepSize":"0.0001",
              "filterType":"LOT_SIZE"
          },
          {
              "minNotional":"10",
              "filterType":"MIN_NOTIONAL"
          },
          {
              "minAmount":"10", // 最小交易额
              "maxAmount":"6600000", // 最大交易额
              "minBuyPrice":"0.01", // 最小买入价格
              "filterType":"TRADE_AMOUNT" 
          },
          {
              "maxSellPrice":"99999999", // 限价最大卖出价格
              "buyPriceUpRate":"0.1", // 限价最大卖出价格
              "sellPriceDownRate":"0.1", // 限价最大卖出价格
              "sellPriceDownRate":"0.1", // 限价最大卖出价格
              "maxEntrustNum":"100000",  // 委托单最大比数(合约)
              "maxConditionNum":"100000", // 条件单最大比数(合约
              "filterType":"LIMIT_TRADING"
          },
          {
              "buyPriceUpRate":"0.1", // 买入不能高于标记(合约)/最新(现货)价的 10%
              "sellPriceDownRate":"0.1", // 卖出不能低于标记(合约)/最新(现货)价的 10%
              "filterType":"MARKET_TRADING"
          },
          {
              "noAllowMarketStartTime":"0", // 不允许使用市价单开始时间 
              "noAllowMarketEndTime":"0", // 不允许使用市价单结束时间
              "limitOrderStartTime":"0", // 限时限价单开始时间
              "limitOrderEndTime":"0", // 限时限价单结束时间
              "limitMinPrice":"0", // 限时限价单最低价格
              "limitMaxPrice":"0", // 限时限价单最高价格
              "filterType":"OPEN_QUOTE"
          }
      ],
      "exchangeId": "301",
      "symbol": "BTC-SWAP-USDT",
      "symbolName": "BTC-SWAP-USDTUSDT",
      "status": "TRADING",
      "baseAsset": "BTC-SWAP-USDT",
      "baseAssetPrecision": "1",
      "quoteAsset": "USDT",
      "quoteAssetPrecision": "0.1",
      "icebergAllowed": false,
      "inverse": false,
      "index": "BTCUSDT",
      "marginToken": "USDT",
      "marginPrecision": "0.0001",
      "contractMultiplier": "0.0001",
      "underlying": "BTC",
      "riskLimits": [
        {
          "riskLimitId": "200000133",
          "quantity": "1000000.0",
          "initialMargin": "0.01",
          "maintMargin": "0.005"
        },
        {
          "riskLimitId": "200000134",
          "quantity": "2000000.0",
          "initialMargin": "0.02",
          "maintMargin": "0.01"
        },
        {
          "riskLimitId": "200000135",
          "quantity": "3000000.0",
          "initialMargin": "0.03",
          "maintMargin": "0.015"
        },
        {
          "riskLimitId": "200000136",
          "quantity": "4000000.0",
          "initialMargin": "0.04",
          "maintMargin": "0.02"
        }
      ]
    },
    {
      "filters":[
          {
              "minPrice":"0.01",
              "maxPrice":"100000.00000000",
              "tickSize":"0.01",
              "filterType":"PRICE_FILTER"
          },
          {
              "minQty":"0.0001",
              "maxQty":"4000",
              "stepSize":"0.0001",
              "filterType":"LOT_SIZE"
          },
          {
              "minNotional":"10",
              "filterType":"MIN_NOTIONAL"
          },
          {
              "minAmount":"10", // 最小交易额
              "maxAmount":"6600000", // 最大交易额
              "minBuyPrice":"0.01", // 最小买入价格
              "filterType":"TRADE_AMOUNT" 
          },
          {
              "maxSellPrice":"99999999", // 限价最大卖出价格
              "buyPriceUpRate":"0.1", // 限价最大卖出价格
              "sellPriceDownRate":"0.1", // 限价最大卖出价格
              "sellPriceDownRate":"0.1", // 限价最大卖出价格
              "maxEntrustNum":"100000",  // 委托单最大比数(合约)
              "maxConditionNum":"100000", // 条件单最大比数(合约
              "filterType":"LIMIT_TRADING"
          },
          {
              "buyPriceUpRate":"0.1", // 买入不能高于标记(合约)/最新(现货)价的 10%
              "sellPriceDownRate":"0.1", // 卖出不能低于标记(合约)/最新(现货)价的 10%
              "filterType":"MARKET_TRADING"
          },
          {
              "noAllowMarketStartTime":"0", // 不允许使用市价单开始时间 
              "noAllowMarketEndTime":"0", // 不允许使用市价单结束时间
              "limitOrderStartTime":"0", // 限时限价单开始时间
              "limitOrderEndTime":"0", // 限时限价单结束时间
              "limitMinPrice":"0", // 限时限价单最低价格
              "limitMaxPrice":"0", // 限时限价单最高价格
              "filterType":"OPEN_QUOTE"
          }
      ],
      "exchangeId": "301",
      "symbol": "BTC-SWAP",
      "symbolName": "BTC-SWAP",
      "status": "TRADING",
      "baseAsset": "BTC-SWAP",
      "baseAssetPrecision": "1",
      "quoteAsset": "USDT",
      "quoteAssetPrecision": "0.1",
      "icebergAllowed": false,
      "inverse": true,
      "index": "BTCUSDT",
      "marginToken": "BTC",
      "marginPrecision": "0.00000001",
      "contractMultiplier": "1.0",
      "underlying": "BTC",
      "riskLimits": [
        {
          "riskLimitId": "200000137",
          "quantity": "1000000.0",
          "initialMargin": "0.01",
          "maintMargin": "0.005"
        },
        {
          "riskLimitId": "200000138",
          "quantity": "2000000.0",
          "initialMargin": "0.02",
          "maintMargin": "0.01"
        },
        {
          "riskLimitId": "200000139",
          "quantity": "3000000.0",
          "initialMargin": "0.03",
          "maintMargin": "0.015"
        },
        {
          "riskLimitId": "200000140",
          "quantity": "4000000.0",
          "initialMargin": "0.04",
          "maintMargin": "0.02"
        }
      ]
    }
  ],
  "coins": [
    {
      "orgId": "9001",
      "coinId": "ETH",
      "coinName": "ETH",
      "coinFullName (tokenFullName)": "Ethereum",
      "allowWithdraw": true,
      "allowDeposit": true,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "USDT",
      "coinName": "USDT",
      "coinFullName (tokenFullName)": "TetherUS",
      "allowWithdraw": true,
      "allowDeposit": true,
      "chainTypes": [
        {
          "chainType": "ERC20",
          "withdrawFee": "0.1",
          "minWithdrawQuantity": "10",
          "maxWithdrawQuantity": "1000",
          "minDepositQuantity": "1",
          "allowDeposit": true,
          "allowWithdraw": true
        },
        {
          "chainType": "TRC20",
          "withdrawFee": "0.1",
          "minWithdrawQuantity": "10",
          "maxWithdrawQuantity": "1000",
          "allowDeposit": true,
          "allowWithdraw": true
        },
        {
          "chainType": "OMNI",
          "withdrawFee": "0.1",
          "minWithdrawQuantity": "10",
          "maxWithdrawQuantity": "1000",
          "allowDeposit": true,
          "allowWithdraw": true
        }
      ]
    },
    {
      "orgId": "9001",
      "coinId": "BTC",
      "coinName": "BTC",
      "coinFullName": "Bitcoin",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "UNI",
      "coinName": "UNI",
      "coinFullName": "uniswap",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "XRP",
      "coinName": "XRP",
      "coinFullName (tokenFullName)": "XRP",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "EOS",
      "coinName": "EOS1",
      "coinFullName (tokenFullName)": "EOS",
      "allowWithdraw": true,
      "allowDeposit": true,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "JET",
      "coinName": "JET",
      "coinFullName (tokenFullName)": "JET",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    }
  ]
}

status字段说明:

对于现货币对(symbols数组中的币对),status可能的值:

状态值说明
TRADING交易中
ONLINE在线(不可交易)
OFFLINE离线(币对已下线)
API_TRADE_FORBIDDENAPI交易被禁止(禁止通过API进行交易)

对于合约币对(contracts数组中的币对),status可能的值:

状态值说明
TRADING交易中
ONLINE在线(不可交易)
API_TRADE_FORBIDDENAPI交易被禁止(禁止通过API进行交易)
OPEN_FORBIDDEN禁止开仓(禁止开仓,但可以平仓)
CLOSE_FORBIDDEN禁止平仓(禁止平仓,但可以开仓)

深度信息

  • GET /quote/v1/depth

权重:

limit权重
5, 10, 20, 50, 1001
5005
100010

响应:

json
{
  "t": 1768300458706,//撮合时间
  "b": [
    [
      "3.90000000",   // 价格
      "431.00000000"  // 数量
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "a": [
    [
      "4.00000200",  // 价格
      "12.00000000"  // 数量
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ]
}

参数

名称类型是否必须描述
symbolSTRINGYES交易对
limitINTNO默认 100;

注意:如果设置limit=0会返回很多数据。

合并深度

  • GET /quote/v1/depth/merged

合并深度接口。

权重:1

响应

json
{
    "t": 1672035413265,//时间
    "b": [//买入深度高到低
        [
            "16851.95",//价格
            "0.003321"//数量
        ],
        [
            "16851.87",
            "0.005456"
        ],
        [
            "16851.47",
            "0.002219"
        ]
    ],
    "a": [//卖出深度低到高
        [
            "16870.19",
            "0.003838"
        ],
        [
            "16873.05",
            "0.00361"
        ],
        [
            "16873.06",
            "0.002623"
        ]
    ]
}

参数

名称类型是否必须描述
symbolSTRINGYES交易对
scaleINTNO档位: 0,1,2,3,4,5 例如:0表示1档,1表示2档
limitINTNO返回条数

近期成交

  • GET /quote/v1/trades

获取当前最新成交(最多60)

权重:1

响应:

json
[
  {
    "p": "4.00000100",
    "q": "12.00000000",
    "t": 1499865549590,
    "ibm": true  // 成交方向 isBuyerMaker
  }
]

参数

名称类型是否必须描述
symbolSTRINGYES交易对
limitINTNO默认 60; 最大 60

K线数据

  • GET /quote/v1/klines

symbol的k线/烛线图数据,K线会根据开盘时间而辨别。

权重:1

响应:

json
[
  [
    1499040000000,      // 开盘时间
    "0.01634790",       // 开盘价
    "0.80000000",       // 最高价
    "0.01575800",       // 最低价
    "0.01577100",       // 收盘价
    "148976.11427815",  // 交易量
    1499644799999,      // 收盘时间
    "2434.19055334",    // Quote asset数量
    308,                // 交易次数
    "1756.87402397",    // Taker buy base asset数量
    "28.46694368"       // Taker buy quote asset数量
  ]
]

参数

名称类型是否必须描述
symbolSTRINGYES交易对
intervalENUMYES时间间隔
startTimeLONGNO开始时间
endTimeLONGNO结束时间
limitINTNO默认 1000; 最大 1000

注意: 如果startTime和endTime没有发送,只有最新的K线会被返回。

价格指数K线数据

  • GET /quote/v1/index/klines

获取某个交易对的价格指数K线

响应:

json
{
    "code": 200,
    "data": [
        {
            "t": 1669155300000,// 时间戳
            "s": "BTCUSDT",// 币对
            "sn": "BTCUSDT",// 币对名称
            "c": "1127.1",// 收盘价
            "h": "1130.81",// 最高价
            "l": "1126.17",// 最低价
            "o": "1130.8",// 开盘价
            "v": "0",// 成交量
            "st": 1669156800000 // 接口响应时间戳
        },
        {
            "t": 1669156200000,
            "s": "ETH-SWAP-USDT",
            "sn": "ETH-SWAP-USDTUSDT",
            "c": "1129.44",
            "h": "1129.54",
            "l": "1127.1",
            "o": "1127.1",
            "v": "0",
            "st": 1669156800000
        }
  ]
}

参数

名称类型是否必须描述
symbolSTRINGYES交易对
intervalENUMYES时间间隔
fromLONGYES开始时间
toLONGYES结束时间
limitINTNO限制条数,默认值:2000 最大值:2000

价格指数成分

  • GET /quote/v1/indexPriceComponents

获取某个交易对的价格指数成分

响应:

json
{
  "index": "91429.02891304", //最新指数价格
  "edp": "91408.35002101", //10分钟指数价格平均值
  "components": [
    {
      "exchange": "BITGET", //现货交易所
      "spotPair": "BTCUSDT",
      "weight": "1.0" //权重
    },
    {
      "exchange": "KUCOIN",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "COINBASE",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "MEXC",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "BYBIT",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "OKEX",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "BINANCE",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    }
  ],
  "time": 1768277194000 //指数更新时间
}

参数

名称类型是否必须描述
symbolSTRINGYES交易对

标记价格K线数据

  • GET /quote/v1/markPrice/klines

响应:

json
{
    "code": 200,
    "data": [
        {
            "symbol": "BTC-SWAP-USDT",//币对
            "time": 1670157900000,//时间戳
            "low": "16991.14096",//最低价
            "open": "16991.78288",//开盘价
            "high": "16996.30641",//最高价
            "close": "16996.30641",//收盘价
            "volume": "0",//成交量
            "curId": 1670157900000,
            "klineType": "1m", // k线类型,比如 1m,5m....
            "change": "0.0008", // 标记价格偏离百分比(指数价格-标记价格)/标记价格
        }
    ]
}

参数

名称类型是否必须描述
symbolSTRINGYES交易对
intervalENUMYES时间间隔
fromLONGYES开始时间
toLONGYES结束时间
limitINTNO限制条数, 默认值:2000 最大值:2000

最新标记价格

  • GET /quote/v1/markPrice

获取某个交易对的标记价格

响应:

json
{
  "exchangeId": 301,//交易所ID
  "symbolId": "BTC-SWAP-USDT",//币对
  "price": "17042.54471",//标记价格
  "time": 1670897454000//时间戳
}

参数

名称类型是否必须描述
symbolSTRINGYES交易对

最新资金费率

  • GET /api/v1/futures/fundingRate

响应:

json
[
    {
        "symbol": "BTC-SWAP-USDT", // 交易对
        "nextFundingTime": "1668427200000", //下次资金费结算时间
        "rate": "0.0018099173553719" //该次结算资金费率。
    }
]

参数

名称类型是否必须描述
symbolSTRINGNO交易对

查询资金费率历史

  • GET /api/v1/futures/historyFundingRate

响应:

json
[
  { 
    "id": "3434343434343",
    "symbol": "BTC-SWAP-USDT", // 交易对
    "settleTime": "1570708800000", //资金费率结算时间
    "settleRate": "0.00321" //资金费率
  }
]

参数

名称类型是否必须描述
symbolSTRINGYES交易对
fromIdLONGNO起始id
endIdLONGNO结束id
limitINTNO返回条数 默认20 最小1 最大1000

获取平台总持仓量

  • GET /quote/v1/openInterest

获取某交易对在平台的总持仓量

响应:

json
{
  "openInterestList": [
    {
      "size": "88059.96", //平台总持仓量 特指交易币,如ETHUSDT中的ETH
      "symbol": "ETH-SWAP-USDT" //币对名称
    }
  ]
}

参数

名称类型是否必须描述
symbolSTRINGYES交易对

多空持仓人数比

  • GET /quote/v1/globalLongShortAccountRatio

多空持仓人数比

响应:

json
[
  {
    "symbol": "BTC-SWAP-USDT",
    "timeStamp": 1768271400000,
    "longShortRatio": "2.7432", // 多空人数比值
    "longAccount": "0.7329", // 多仓人数比例
    "shortAccount": "0.2671" // 空仓人数比例
  }
]

参数

名称类型是否必须描述
symbolSTRINGYES交易对
periodSTRINGYES"5m","15m","30m","1h","2h","4h","6h","12h","1d"
limitLONGNO默认 30, 最大 500
startTimeLONGNO
endTimeLONGNO

注意:仅支持最近30天的数据, 若无 startime 和 endtime 限制, 则默认返回当前时间往前的limit值

保险基金余额查询

  • GET /api/v1/futures/insuranceBySymbol

保险基金余额查询

响应:

json
{
  "list": [
    {
      "coin": "USDT", //保险池的币种
      "symbol": "BTC-SWAP-USDT", //合约交易对
      "value": "4271010.26212436", //保险基金的币种价值,折合成USD的价值
      "updateTime": "1768262400000" //最近更新时间(ms)
    },
    {
      "coin": "USDT",
      "symbol": "BTC-SWAP-USDT",
      "value": "4271013.74008353",
      "updateTime": "1768176000000"
    }
  ]
}

参数

名称类型是否必须描述
symbolIdSTRINGYES交易对

注意:默认返回14天的数据,每天UTC0点时间更新一次

获取系统所有风险限额配置列表

  • GET /api/v1/futures/riskLimits

获取指定交易对的所有风险限额配置列表(仅返回非白名单的风险限额)。

权重:1

响应:

json
[
  {
    "level": 1, // 风险档位等级,按quantity排序,起始等级为1
    "quantity": "1000000.0", // 数量
    "maintainMargin": "0.005", // 维持保证金率
    "initialMargin": "0.01", // 初始保证金率
    "maxLeverage": 100 // 最大杠杆
  },
  {
    "level": 2,
    "quantity": "2000000.0",
    "maintainMargin": "0.01",
    "initialMargin": "0.02",
    "maxLeverage": 50
  }
]

参数

名称类型是否必须描述
symbolSTRINGYES交易对

24hr价格变动情况

  • GET /quote/v1/contract/ticker/24hr

24小时价格变化数据。注意 如果没有发送symbol,会返回很多数据。

权重: 如果只有一个symbol为1,不带symbol为40。

响应:

json
[
    {
        "t": 1538725500422,   // 时间
        "a": "1.10000000",    // 最高卖价
        "b": "1.00000000",    // 最高买价
        "s": "BTC-SWAP-USDT", // symbol 
        "c": "4.00000200",    // 最新成交价
        "o": "99.00000000",   // 开盘价
        "h": "100.00000000",  // 最高价 
        "l": "0.10000000",    // 最低价
        "v": "8913.30000000", // 成交量
        "qv": "15.30000000",   // 成交额
        "pc": "15.30000000",   // 24小时价格变动
        "pcp": "15.30000000"   // 24小时价格变动百分比
    }
]

参数

名称类型是否必须描述
symbolSTRINGNO交易对
realtimeIntervalENUMNOvalue值如下:24h1d1d+8
  • 如果symbol没有被发送,所有symbol的数据都会被返回。

最新价格

  • GET /quote/v1/contract/ticker/price

返回最近价格

权重:1

响应:

json
[
  {
    "s": "BTC-SWAP-USDT",  // 交易对
    "p": "4.00000200"      // 最新价
  }
]

参数

名称类型是否必须描述
symbolSTRINGNO交易对
  • 如果symbol没有发送,所有symbol的最新价都会被返回。

指数价格

  • GET /quote/v1/index

返回指数价格

权重:1

响应:

json
{
    "index":{
        "BTCUSDT":"42999.21"  // 币对及对应的指数价格
    },
    "edp":{
        "BTCUSDT":"43031.36006" // 10分钟内指数平均值
    }
}

参数

名称类型是否必须描述
symbolSTRINGNO交易对
  • 如果symbol没有发送,所有symbol的指数价都会被返回。

当前最优挂单

  • GET /quote/v1/contract/ticker/bookTicker

单个或者多个symbol的最佳买单卖单价格。

权重:1

响应:

json
[
  {
      "t": 132222222222222,     // 时间
      "s": "BTC-SWAP-USDT",     // 交易对          
      "b": "4.00000000",        // 最高买价
      "bq": "431.00000000",     // 最高买价对应的数量
      "a": "4.00000200",        // 最高卖价
      "aq": "9.00000000"        // 最高卖价对应的数量
  }
]

参数

名称类型是否必须描述
symbolSTRINGNO交易对
  • 如果symbol没有被发送,所有symbol的最佳订单簿价格都会被返回。

基于 MIT 许可发布