火币huobipro API接口列表

全球领先的数字货币期货平台BitMEX 100倍杠杆永续合约,注册BitMex请使用日本IP:比特币量化交易官方交流群:154502997

API Reference

请务必在header中设置user agent 'User-Agent': 'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.71 Safari/537.36'

symbol 规则: 基础币种+计价币种。如BTC/USDTsymbolbtcusdtETH/BTC symbolethbtc。以此类推

接口列表

接口列表



接口数据类型请求方法类型描述需要验签
市场行情GET /market/history/klineGETK线N
市场行情GET /market/detail/mergedGET滚动24小时交易和最优报价聚合行情(单个symbol)N
市场行情GET /market/tickersGET全部symbol的交易行情N
市场行情GET /market/depthGET市场深度行情(单个symbolN
市场行情GET /market/tradeGET单个symbol最新成交记录N
市场行情GET /market/history/tradeGET单个symbol批量成交记录N
市场行情GET /market/detailGET滚动24小时交易聚合行情(单个symbol)N
交易品种信息GET /v1/common/symbolsGET交易品种的计价货币和报价精度N
交易品种信息GET /v1/common/currencysGET交易币种列表N
系统信息GET /v1/common/timestampGET查询当前系统时间N
账户信息GET /v1/account/accountsGET查询用户的所有账户状态Y
账户信息GET /v1/account/accounts/{account-id}/balanceGET查询指定账户余额Y
交易POST/v1/order/orders/placePOST下单Y
交易POST/v1/order/orders/{order-id}/submitcancelPOSTorder-id撤销一个订单Y
交易POST /v1/order/orders/batchcancelPOSTorder_id, 批量撤销订单(up to 50)Y
交易POST /v1/order/orders/batchCancelOpenOrdersPOST按订单条件批量撤销订单(up to 100)Y
用户订单信息GET /v1/order/orders/{order-id}GET根据order-id查询订单详情Y
用户订单信息GET /v1/order/orders/{order-id}/matchresultsGET根据order-id查询订单的成交明细Y
用户订单信息GET /v1/order/ordersGET查询用户当前委托、或历史委托订单 (up to 100)Y
用户订单信息GET /v1/order/matchresultsGET查询用户当前成交、历史成交Y
用户订单信息GET /v1/order/openOrdersGET查询用户当前未成交订单 (up to 500)Y
充提币POST /v1/dw/withdraw/api/createPOST申请提币Y
充提币POST /v1/dw/withdraw-virtual/{withdraw-id}/cancelPOST撤销提币申请Y
充提币GET /v1/query/deposit-withdrawGET查询充提记录Y
杠杆交易POST /v1/dw/transfer-in/marginPOST从币币交易账户划转至杠杆账户Y
杠杆交易POST /v1/dw/transfer-out/marginPOST从杠杆账户划转至币币交易账户Y
杠杆交易POST /v1/margin/ordersPOST申请借贷Y
杠杆交易POST /v1/margin/orders/{order-id}/repayPOST归还借贷Y
杠杆交易GET /v1/margin/loan-ordersGET查询借贷记录Y
杠杆交易GET /v1/margin/accounts/balanceGET查询杠杆账户余额Y
ETF换入换出GET /etf/swap/configGETETF换入换出的基本信息,ETF换入换出状态,以及ETF的成分结构。Y
ETF换入换出POST/etf/swap/inPOST用户可以通过该接口换入一定数量的ETF.Y
ETF换入换出POST/etf/swap/outPOST用户可以通过该接口换出一定数量的ETF.Y
ETF换入换出GET/etf/listGETETF换入换出操作的明细记录。最多返回   100 条记录。Y
ETF换入换出GET/quotation/market/history/klineGETETF净值的K线N
母子账号POST /v1/subuser/transferPOST母账号执行母子账户之间的划转Y
母子账号GET /v1/subuser/aggregate-balanceGET母账号查询所有子账号各币种资产累加余额Y
母子账号GET /v1/account/accounts/{sub-uid}GET母账号查询某个子账号的各币种和各账户类型的余额Y
市场行情



在调用行情接口时,请添加get参数,keyAccessKeyId value为网页上申请的apikeyaccesskey  
例:



https://api.huobipro.com/market/history/kline?period=1day&size=200&symbol=btcusdt&AccessKeyId=fff-xxx-ssss-kkk





GET /market/history/kline 获取K线数据
请求参数:



参数名称是否必须类型描述默认值
symbolTRUEstring交易对
periodTRUEstringK线类型
sizeFALSEinteger获取数量150
响应数据:



参数名称是否必须数据类型描述取值范围
statusTRUEstring请求处理结果"ok" , "error"
tsTRUEnumber响应生成时间点,单位:毫秒
tickTRUEobjectKLine 数据
chTRUEstring数据所属的 channel,格式: market.$symbol.kline.$period
data 说明:



  "data": [



{



    "id": K线id,



    "amount": 成交量,


    "count": 成交笔数,


    "open": 开盘价,


    "close": 收盘价,K线为最晚的一根时,是最新成交价
    "low": 最低价,


    "high": 最高价,


    "vol": 成交额, sum(每一笔成交价   * 该笔的成交量)
  }



]



请求响应示例:



/* GET   /market/history/kline?period=1day&size=200&symbol=btcusdt */
{



  "status":   "ok",


  "ch":   "market.btcusdt.kline.1day",

  "ts":   1499223904680,


  "data": [



{



    "id":   1499184000,


    "amount":   37593.0266,


    "count": 0,



    "open":   1935.2000,


    "close":   1879.0000,


    "low":   1856.0000,


    "high":   1940.0000,


    "vol":   71031537.97866500

  },



// more data here


]



}








/* GET   /market/history/kline?period=not-exist&size=200&symbol=ethusdt */
{



  "ts":   1490758171271,


  "status":   "error",


  "err-code":   "invalid-parameter",

  "err-msg":   "invalid period"

}








/* GET   /market/history/kline?period=1day&size=not-exist&symbol=ethusdt */
{



  "ts":   1490758221221,


  "status":   "error",


  "err-code":   "bad-request",

  "err-msg":   "invalid size, valid range: [1,2000]"
}








/* GET   /market/history/kline?period=1day&size=200&symbol=not-exist */
{



  "ts":   1490758171271,


  "status":   "error",


  "err-code":   "invalid-parameter",

  "err-msg":   "invalid symbol"

}



GET /market/detail/merged 获取聚合行情(Ticker)
请求参数:



参数名称是否必须类型描述默认值
symbolTRUEstring交易对
响应数据:



参数名称是否必须数据类型描述取值范围
statusTRUEstring请求处理结果"ok" , "error"
tsTRUEnumber响应生成时间点,单位:毫秒
tickTRUEobjectK线数据
chTRUEstring数据所属的 channel,格式: market.$symbol.detail.merged
tick 说明:



  "tick": {



    "id": K线id,



    "amount": 成交量,


    "count": 成交笔数,


    "open": 开盘价,


    "close": 收盘价,K线为最晚的一根时,是最新成交价
    "low": 最低价,


    "high": 最高价,


    "vol": 成交额, sum(每一笔成交价   * 该笔的成交量)
    "bid": [1,1],


    "ask": [1,1]


  }








请求响应示例:



/* GET /market/detail/merged?symbol=ethusdt */
{



"status":"ok",



"ch":"market.ethusdt.detail.merged",

"ts":1499225276950,


"tick":{



  "id":1499225271,


    "ts":1499225271000,


    "close":1885.0000,


    "open":1960.0000,


    "high":1985.0000,


  "low":1856.0000,


    "amount":81486.2926,


  "count":42122,



    "vol":157052744.85708200,

    "ask":[1885.0000,21.8804],

    "bid":[1884.0000,1.6702]


  }



}








/* GET /market/detail/merged?symbol=not-exist */
{



  "ts":   1490758171271,


  "status":   "error",


  "err-code":   "invalid-parameter",

  "err-msg":   "invalid symbol”

}








GET /market/tickers


{  



      "status":"ok",


      "ts":1510885463001,


    "data":[  



        {  



              "open":0.044297,        // K线 开盘价
              "close":0.042178,       // K线 收盘价
              "low":0.040110,         // K线 最低价
              "high":0.045255,        // K线 最高价
              "amount":12880.8510,    // 24小时成交量
              "count":12838,          // 24小时成交笔数
              "vol":563.0388715740, // 24小时成交额
              "symbol":"ethbtc"     // 交易对
        },



        {  



              "open":0.008545,

              "close":0.008656,

              "low":0.008088,

              "high":0.009388,

              "amount":88056.1860,

              "count":16077,


              "vol":771.7975953754,

              "symbol":"ltcbtc"

        }



    ]



}



注:当交易对尚未产生成交时,返回的数据里面 open close high low amount count vol 的值都为 null
GET /market/depth 获取 Market Depth 数据
请求参数:



参数名称是否必须类型描述默认值
symbolTRUEstring交易对
typeTRUEstringDepth 类型





用户选择合并深度时,一定报价精度内的市场挂单将予以合并显示。合并深度仅改变显示方式,不改变实际成交价格。
响应数据:



参数名称是否必须数据类型描述取值范围
statusTRUEstring
"ok" 或者   "error"
tsTRUEnumber响应生成时间点,单位:毫秒
tickTRUEobjectDepth 数据
chTRUEstring数据所属的 channel,格式: market.$symbol.depth.$type
tick 说明:



  "tick": {



    "id": 消息id,


    "ts": 消息生成时间,单位:毫秒,

    "bids": 买盘,[price(成交价), amount(成交量)], price降序,
    "asks": 卖盘,[price(成交价), amount(成交量)], price升序
  }



请求响应示例:



/* GET /market/depth?symbol=ethusdt&type=step1 */
{



  "status":   "ok",


  "ch":   "market.btcusdt.depth.step1",
  "ts":   1489472598812,


  "tick": {



    "id":   1489464585407,


    "ts":   1489464585407,


    "bids": [



      [7964, 0.0678], //   [price, amount]
      [7963, 0.9162],


      [7961, 0.1],


      [7960, 12.8898],


      [7958, 1.2],


      [7955, 2.1009],


      [7954, 0.4708],


      [7953, 0.0564],


      [7951, 2.8031],


      [7950, 13.7785],


      [7949, 0.125],


      [7948, 4],



      [7942, 0.4337],


      [7940, 6.1612],


      [7936, 0.02],


      [7935, 1.3575],


      [7933, 2.002],


      [7932, 1.3449],


      [7930, 10.2974],


      [7929, 3.2226]


    ],



    "asks": [



      [7979, 0.0736],


      [7980, 1.0292],


      [7981, 5.5652],


      [7986, 0.2416],


      [7990, 1.9970],


      [7995, 0.88],


      [7996, 0.0212],


      [8000, 9.2609],


      [8002, 0.02],


      [8008, 1],



      [8010, 0.8735],


      [8011, 2.36],


      [8012, 0.02],


      [8014, 0.1067],


      [8015, 12.9118],


      [8016, 2.5206],


      [8017, 0.0166],


      [8018, 1.3218],


      [8019, 0.01],


      [8020, 13.6584]


    ]



  }



}








/* GET /market/depth?symbol=ethusdt&type=not-exist */
{



  "ts":   1490759358099,


  "status":   "error",


  "err-code":   "invalid-parameter",

  "err-msg":   "invalid type"

}



GET /market/trade 获取 Trade Detail 数据
请求参数:



参数名称是否必须类型描述默认值
symbolTRUEstring交易对
响应数据:



参数名称是否必须数据类型描述取值范围
statusTRUEstring
"ok" 或者   "error"
tsTRUEnumber响应生成时间点,单位:毫秒
tickTRUEobjectTrade 数据
chTRUEstring
  admin   8/22/2018
Remark:


       

© 2019 - 杰出的区块链AI金融机器人--优秀的比特币数字货币自动量化交易基金平台,实现了 wequant、botvs 、比特币精灵、币速等比特币自动量化交易平台的功能,实盘比特币回测结果优异