Release Time(UTC +8)	API	Initialize / Update	Description
2018.6.10	-	Initialize	Initializes the current version of the interface

Parameter	Mandatory	Data Type	Description	Value Range
code	y	int	Status code	success：200
msg	y	string	message
time	y	long	Current millisseconds
data	y	array	symbols list

Field Type	Data Type	description
baseCurrency	string	baseCurrency code
quoteCurrency	string	quoteCurrency code
pricePrecision	integer	price precision
amountPrecision	integer	quantity precision
symbolPartition	string	symbol Partition, example:[main,innovation]
symbol	string	trade pair code
state	string	trade pair status [enable,disable]
minOrderCount	decimal	min order count
maxOrderCount	decimal	max order count
minOrderPrice	decimal	min order price
maxOrderPrice	decimal	max order price

Parameter	Mandatory	Data Type	Description	Value Range
status	y	string	Status code	success：ok，failed：error
timestamp	y	long	Current millisseconds
ticker	y	list	data

Parameter	Mandatory	Data Type	Description	Value Range
symbol	y	string	Trading pair	sellShortName_buyShortName，eg：btc_usdt
last	y	number	latest price
buy	y	number	buy
sell	y	number	sell
high	y	number	high
low	y	number	low
vol	y	number	vol
change	y	number	change

Parameter	Mandatory	Data Type	Description	Default	Value Range
step	y	int	Time：Sec		60（1min）,300（5mins）,900（15mins）,1800（30mins）,3600（1h）,86400（1d）,604800（1w）,2592000（1mon）
symbol	y	string	pairs		btc_gavc

Parameter	Mandatory	Data Type	Description
code	y	int	Status code
msg	n	string	return message
time	y	long	Current millisseconds
data	y	array(array(number))	Kline data

Parameter	Mandatory	Data Type	Description	Default	Value Range
symbol	y	string	Trading pair		Example：btc_gavc
step	n	int	Add the Parameter to check latest Kline data,Data Type is time,unit is sec.		60,360,560,1560,3060,6060（1h）,246060（1d）,7246060（1w）,302460*60（1mon）

Parameter	Mandatory	Data Type	Description
code	y	int	Status code
msg	n	string	return message
time	y	long	Current millisseconds
data	y	object	Trading deep date

Parameter	Mandatory	Data Type	Description
bids	y	array(array(long))	buy,[price(transaction price), amount(transaction vol)]
asks	y	array(array(long))	sell,[price(transaction price), amount(transaction vol)]
date	y	long	Timestamp
lastPrice	y	number	Latest price

Parameter	Mandatory	Data Type	Description
marketFrom	y	string	Input symbol
coinVol	y	string	Input symbol
type	y	long	Input step,time
data	y	array（array）	Last kline data,same with format above by only one

Parameter	Mandatory	Data Type	Description	Value Range
AccessKeyId	y	string	Access key
SignatureVersion	y	string	Version
SignatureMethod	y	string	Signature Method	HmacSHA256
Signature	y	string	ApiSecret
Timestamp	y	string	Timestamp
count	y	int	Trades items	0
symbol	y	string	Trading pair	example：btc_gavc

Parameter	Mandatory	Data Type	Description
code	y	int	Status code
msg	n	string	return message
time	y	long	Current millisseconds
data	y	object	Real-time transactions

Parameter	Mandatory	Data Type	Description
trades	y	array(object)	trades data
sellSymbol	y	string	sellSymbol
buySymbol	y	string	buySymbol

Parameter	Mandatory	Data Type	Description	Value Range
price	y	long	transaction price
amount	y	string	transaction amount
id	y	string	transaction id
time	y	string	transaction time
en_type	y	string	direction	“bid”(buy),”ask”(sell)
type	y	string	transaction Data Type	“buy”,”sell”

Parameter	Mandatory	Data Type	Description	Default	Value Range
AccessKeyId	y	string	Access key

Parameter	Mandatory	Data Type	Description
code	y	int	Status code
msg	n	string	Return message
time	y	long	Current millisseconds
data	y	object	Transaction deep data

Parameter	Mandatory	Data Type	Description
netassets	y	number	net assets，unit: gavc
totalassets	y	number	total assets，unit:gavc
wallet	y	array(object)	wallet list

Parameter	Mandatory	Data Type	Description
coinName	y	long	Currency
uid	y	int	User ID
coinId	y	int	Currency ID
total	y	number	Available
frozen	y	number	On orders
symbol	y	string	Currency symbol
shortName	y	string	Abbreviation

生效时间(UTC +8)	接口	变化	摘要
2018.6.10	-	初始化	初始化当前版本接口

参数名称	是否必须	类型	描述	取值范围
code	y	int	状态码	成功：200
msg	y	string	消息
time	y	long	当前毫秒数
data	y	array	symbols列表

字段类型	数据类型	描述	description（英文）
baseCurrency	string	交易中的基础币种	baseCurrency code
quoteCurrency	string	交易中的报价币种	quoteCurrency code
pricePrecision	integer	交易对报价的精度（小数点后位数）	price precision
amountPrecision	integer	交易对基础币种计数精度（小数点)	quantity precision
symbolPartition	string	交易区，可能值: [main,innovation]	symbol Partition, example:[main,innovation]
symbol	string	交易对	trade pair code
state	string	交易对状态 enable - 正常；disable-禁用	trade pair status [enable,disable]
minOrderCount	decimal	交易对最小下单量 (下单量指当订单类型为限价单时，下单接口传的’tradeAmount’)	min order count
maxOrderCount	decimal	交易对最大下单量 (下单量指当订单类型为限价单时，下单接口传的’tradeAmount’)	max order count
minOrderPrice	decimal	最小下单价格（下单金额指当订单类型为限价单时，下单接口传入的‘price’）	min order price
maxOrderPrice	decimal	最大下单价格（下单金额指当订单类型为限价单时，下单接口传入的‘price’）	max order price

参数名称	是否必须	类型	描述	默认值	取值范围
AccessKeyId	y	string	访问key

参数名称	是否必须	类型	描述
netassets	y	number	净资产，单位为gavc
totalassets	y	number	总资产，单位为gavc
wallet	y	array(object)	钱包列表

参数名称	是否必须	类型	描述
coinName	y	long	币种名称
uid	y	int	用户ID
coinId	y	int	币种ID
total	y	number	可用
frozen	y	number	冻结
symbol	y	string	币种symbol
shortName	y	string	币种简称

行情数据

实时ticker数据

GET /v1/market/ticker

https://hkapi.hotcoin.top/v1/market/ticker

curl "https://hkapi.hotcoin.top/v1/market/ticker"

请求参数:

参数名称	是否必须	类型	描述	取值范围
status	y	string	状态码	成功：ok，失败：error
timestamp	y	long	当前毫秒数
ticker	y	list	数据

响应数据:

{
  "status":"ok",
  "timestamp":1567045034,
  "ticker":[
    {
      "symbol":"btc_usdt",
      "last":"10000.00000000",
      "buy":"9999.00000000",
      "sell":"10001.00000000",
      "high":"11000.00000000",
      "low":"9000.00000000",
      "vol":"10000000.0000",
      "change":"10.10"
    }
  ]
}
  

参数名称	是否必须	类型	描述	取值范围
symbol	y	string	交易对symbol	卖币种简称_买币种简称简称，eg：btc_usdt
last	y	number	最新价
buy	y	number	买一价
sell	y	number	卖一价
high	y	number	24小时最高价
low	y	number	24小时最低价
vol	y	number	24小时成交量
change	y	number	24小时涨跌幅

获取k线数据

GET /v1/ticker

https://hkapi.hotcoin.top/v1/ticker?symbol=btc_usdt&step=60

curl "https://hkapi.hotcoin.top/v1/ticker?symbol=btc_usdt&step=60"

请求参数:

参数名称	是否必须	类型	描述	默认值	取值范围
step	y	int	时间：秒		60（1分钟）,300（5分钟）,900（15分钟）,1800（30分钟）,3600（1小时）,86400（1天）,604800（1周）,2592000（1月）
symbol	y	string	交易对		例：btc_gavc

响应数据:

{
  "code":200,
  "msg":"成功",
  "time":1527838104874,
  "data":[
    [
      1527820200000,
      54598.5,
      54598.5,
      54598.5,
      54598.5,
      0
    ],
    [
      1527820200000,
      54598.5,
      54598.5,
      54598.5,
      54598.5,
      0
    ]
  ]
}
  

参数名称	是否必须	类型	描述
code	y	int	状态码
msg	n	string	返回消息
time	y	long	当前毫秒数
data	y	array(array(number))	K线数据

data:

[[
1527820200000, //int 时间
54598.5, //number 开
54598.5, //number 高
54598.5, //number 低
54598.5, //number 收
0.0000 //number 量
],
……
]

获取深度数据

GET /v1/depth

https://hkapi.hotcoin.top/v1/depth?symbol=btc_usdt&step=60

curl "https://hkapi.hotcoin.top/v1/depth?symbol=btc_usdt&step=60"

请求参数:

参数名称	是否必须	类型	描述	默认值	取值范围
symbol	y	string	交易对		例：btc_gavc
step	n	int	加上此参数可查最新一个k线数据，类型为时间，单位秒		60,360,560,1560,3060,6060（1小时）,246060（1天）,7246060（1周）,302460*60（1月）

响应数据:

{
  "code":200,
  "msg":"成功",
  "time":1527837164605,
  "data":{
    "period":{
      "data":[
        [
          1527837120000,
          54598.5,
          54598.5,
          54598.5,
          54598.5,
          0
        ]
      ],
      "marketFrom":"btc_gavc",
      "type":60,
      "coinVol":"btc_gavc"
    },
    "depth":{
      "date":1527837163,
      "asks":[
        [
          57373.8,
          0.0387
        ],
        [
          57751.26,
          0.0128
        ],
        [
          57751.26,
          0.0128
        ]
      ],
      "bids":[
        [
          57373.8,
          0.0387
        ],
        [
          57751.26,
          0.0128
        ],
        [
          57751.26,
          0.0128
        ]
      ],
      "lastPrice":54598.5
    }
  }
}
  

参数名称	是否必须	类型	描述
code	y	int	状态码
msg	n	string	返回消息
time	y	long	当前毫秒数
data	y	object	交易深度数据

data:

参数名称	是否必须	类型	描述	默认值	取值范围
depth	y	object
period	n	object	传step时才有值

depth:

参数名称	是否必须	类型	描述
bids	y	array(array(long))	买盘,[price(成交价), amount(成交量)]
asks	y	array(array(long))	卖盘,[price(成交价), amount(成交量)]
date	y	long	时间戳
lastPrice	y	number	最新成交价

period:

参数名称	是否必须	类型	描述
marketFrom	y	string	入参symbol
coinVol	y	string	入参symbol
type	y	long	入参step,时间
data	y	array（array）	最后一个k线数据，格式同上，但只有一个

获取实时成交数据

GET /v1/trade

https://hkapi.hotcoin.top/v1/trade?symbol=btc_usdt&count=60

curl "https://hkapi.hotcoin.top/v1/trade?symbol=btc_usdt&count=60"

请求参数:

参数名称	是否必须	类型	描述	默认值	取值范围
count	y	int	Trades条数		0
symbol	y	string	交易对		例：btc_gavc

响应数据:

{
  "code":200,
  "msg":"成功",
  "time":1536315868962,
  "data":{
    "sellSymbol":"BTC",
    "buySymbol":"GAVC",
    "trades":[
      {
        "price":0.007,
        "amount":66491.04,
        "id":1,
        "time":"02:45:08",
        "en_type":"ask",
        "type":"卖出"
      },
      {
        "price":0.007,
        "amount":66491.04,
        "id":1,
        "time":"02:45:08",
        "en_type":"ask",
        "type":"卖出"
      }
    ]
  }
}


  

参数名称	是否必须	类型	描述
code	y	int	状态码
msg	n	string	返回消息
time	y	long	当前毫秒数
data	y	object	实时成交数据

data:

参数名称	是否必须	类型	描述
trades	y	array(object)	trades数据
sellSymbol	y	string	sellSymbol
buySymbol	y	string	buySymbol

trades:

参数名称	是否必须	类型	描述	取值范围
price	y	long	成交价钱
amount	y	string	成交数量
id	y	string	成交id
time	y	string	成交时间
en_type	y	string	成交方向	"bid"(买入),"ask"(卖出)
type	y	string	成交类型	"买入","卖出"

Change Log

Introduction

Access Instructions

Security Authentication

Legal request structure

Signature Algorithm

Reference Data

Get all trade pairs

Market Data

Real-time Ticker data

Obtain kline data

Obtain Deep Data

Obtain real-time data

Account

Obtain User Balance

更新日志

简介

接入准备

安全认证

合法请求结构

签名运算

基础信息

获取所有交易对

行情数据

实时ticker数据

获取k线数据

获取深度数据

获取实时成交数据

账户相关

获取用户余额

行情数据

实时ticker数据

获取k线数据

获取深度数据

获取实时成交数据