Market Data
Real-time Ticker data
Signature Authentication: No
Rate Limit: 10 times/s
- GET /v1/market/ticker
https://api.hotcoinfin.com/v1/market/ticker
curl "https://api.hotcoinfin.com/v1/market/ticker"
Response data:
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
status | y | string | Status code | success:ok,failed:error | |
timestamp | y | long | Current millisseconds | ||
ticker | y | list | data |
Response
{
"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"
}
]
}
Parameter | Mandatory | Data Type | Description | Default | 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 |
Obtain kline data
Signature Authentication: No
Rate Limit: 20 times/s
- GET /v1/ticker
https://api.hotcoinfin.com/v1/ticker?symbol=btc_usdt&step=60
curl "https://api.hotcoinfin.com/v1/ticker?symbol=btc_usdt&step=60"
Request parameters:
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_usdt |
Response data:
Response
{
"code":200,
"msg":"success",
"time":1527838104874,
"data":[
[
1527820200000,
54598.5,
54598.5,
54598.5,
54598.5,
0
],
[
1527820200000,
54598.5,
54598.5,
54598.5,
54598.5,
0
]
]
}
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
code | y | int | Status code | ||
msg | n | string | return message | ||
time | y | long | Current millisseconds | ||
data | y | array(array(number)) | Kline data |
data:
[[
1527820200000, //int time
54598.5, //number O
54598.5, //number H
54598.5, //number L
54598.5, //number C
0.0000 //number Vol
],
……
]
Obtain Deep Data
Signature Authentication: No
Rate Limit: 20 times/s
- GET /v1/depth
https://api.hotcoinfin.com/v1/depth?symbol=btc_usdt&step=60
curl "https://api.hotcoinfin.com/v1/depth?symbol=btc_usdt&step=60"
Request parameters:
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
symbol | y | string | Trading pair | Example:btc_usdt | |
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) |
Response data:
Response
{
"code":200,
"msg":"success",
"time":1527837164605,
"data":{
"period":{
"data":[
[
1527837120000,
54598.5,
54598.5,
54598.5,
54598.5,
0
]
],
"marketFrom":"btc_usdt",
"type":60,
"coinVol":"btc_usdt"
},
"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
}
}
}
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
code | y | int | Status code | ||
msg | n | string | return message | ||
time | y | long | Current millisseconds | ||
data | y | object | Trading deep date |
data:
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
depth | y | object | |||
period | n | object | Vaule only displayed when uploading step |
depth:
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
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 |
period:
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
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 |
Obtain real-time trade data
Signature Authentication: No
Rate Limit: 20 times/s
- GET /v1/trade
https://api.hotcoinfin.com/v1/trade?symbol=btc_usdt&count=60
curl "https://api.hotcoinfin.com/v1/trade?symbol=btc_usdt&count=60"
Request parameters:
Parameter | Mandatory | Data Type | Description | Default | 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_usdt |
Response data:
Response
{
"code":200,
"msg":"success",
"time":1536315868962,
"data":{
"sellSymbol":"BTC",
"buySymbol":"USDT",
"trades":[
{
"price":0.007,
"amount":66491.04,
"id":1,
"time":"02:45:08",
"en_type":"ask",
"type":"sell"
},
{
"price":0.007,
"amount":66491.04,
"id":1,
"time":"02:45:08",
"en_type":"ask",
"type":"sell"
}
]
}
}
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
code | y | int | Status code | ||
msg | n | string | return message | ||
time | y | long | Current millisseconds | ||
data | y | object | Real-time transactions |
data:
Parameter | Mandatory | Data Type | Description | Default | Value Range |
---|---|---|---|---|---|
trades | y | array(object) | trades data | ||
sellSymbol | y | string | sellSymbol | ||
buySymbol | y | string | buySymbol |
trades:
Parameter | Mandatory | Data Type | Description | Default | 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" |