Path: /demo/java
Method: GET
接口描述:
################################### Java版本-生成签名-start ################################
@Test
void test01() {
String secret = "***密钥***";
HashMap<String,String> dataMap = new HashMap<String,String>();
//接口所需参数
dataMap.put("api_key", "api_key");
dataMap.put("type", "1");
dataMap.put("side", "BUY");
dataMap.put("volume", "10");
dataMap.put("price", "0.0001");
dataMap.put("symbol", "btcusdt");
dataMap.put("time", "1593601408000");
String sign = "";
try {
sign = this.getSign(dataMap, secret);
} catch (UnsupportedEncodingException e1) {
e1.printStackTrace();
}
System.out.println("签名sign:"+sign);
}
//字典顺序排序map中的key,拼接字符串,securt拼接到最后,MD5 = sign
private String getSign(HashMap<String,String> resultMap, String secret) throws UnsupportedEncodingException {
Set<String> keys = resultMap.keySet();
String[] paramArr = keys.toArray(new String[keys.size()]);
Arrays.sort(paramArr);
StringBuilder sb = new StringBuilder();
for(String key : paramArr) {
String value = resultMap.get(key);
sb.append(key).append(value);
}
String lastStr = sb.toString() + secret;
String digest = DigestUtils.md5Hex(lastStr.getBytes("UTF-8"));
return digest;
}
################################### Java版本-生成签名-end ##################################
######################################### curl版本 #########################################
curl -X POST \
https://openapi.bitwind.com/open/api/create_order \
-H 'Postman-Token: 957fef75-23a3-b30b-06b1-189676efc5ca' \
-d 'api_key=api_key&price=5&side=BUY&sign=sign&symbol=btcusdt&time=1566445997732&type=1&volume=1'
######################################### java版本 #########################################
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "api_key=api_key&price=5&side=BUY&sign=sign&symbol=btcusdt&time=1566445997732&type=1&volume=1");
Request request = new Request.Builder()
.url("https://openapi.bitwind.com/open/api/create_order")
.post(body)
.addHeader("Content-Type", "application/x-www-form-urlencoded")
.build();
Response response = client.newCall(request).execute();
######################################### php版本 #########################################
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://openapi.bitwind.com/open/api/create_order",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "api_key=api_key&price=5&side=BUY&sign=sign&symbol=btcusdt&time=1566445997732&type=1&volume=1",
CURLOPT_HTTPHEADER => array(
"Content-Type: application/x-www-form-urlencoded"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
######################################### python版本 #########################################
import http.client
conn = http.client.HTTPConnection("openapi,bitwind,com")
payload = "api_key=api_key&price=5&side=BUY&sign=sign&symbol=btcusdt&time=1566445997732&type=1&volume=1"
headers = {
'Content-Type': "application/x-www-form-urlencoded"
}
conn.request("POST", "open,api,create_order", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
######################################### go版本 #########################################
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://openapi.bitwind.com/open/api/create_order"
payload := strings.NewReader("api_key=api_key&price=5&side=BUY&sign=sign&symbol=btcusdt&time=1566445997732&type=1&volume=1")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
Path: /open/api/margin/mass_replace
Method: POST
接口描述:
mass_place:下单参数。side:方向(买卖方向BUY、SELL)
-------------------------type:类型(1:限价委托、2:市价委托)
-------------------------volume:购买数量(多义,复用字段) type=1:表示买卖数量type=2:买则表示总价格,卖表示总数量
-------------------------price:委托单价,type=2不需要此参数
-------------------------fee_is_user_exchange_coin:(冗余字段)当交易所有平台币时,此参数表示是否使用用平台币
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
mass_place | text | 否 | [{"side":"SELL","type":"1","volume":"1","price":"10","fee_is_user_exchange_coin":"0"}] | mass_place:下单参数 |
symbol | text | 是 | btcusdt | 币种 ,例 btcusdt |
time | text | 是 | 1567415490190 | 时间戳 |
sign | text | 是 | sign | 签名 |
api_key | text | 是 | api_key | api_key |
mass_cancel | text | 否 | [78321,78322,78323] | 撤单参数,订单id,多个订单id使用英文逗号分隔 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 必须 | mock: 0 | ||
msg | string | 必须 | mock: success | ||
data | object | 非必须 | |||
├─ mass_cancel | object [] | 非必须 | 批量撤单信息 | item 类型: object | |
├─ msg | string | 必须 | |||
├─ code | string | 必须 | |||
├─ order_id | number | 必须 | 撤销订单id | ||
├─ mass_place | object [] | 非必须 | 批量下单信息 | item 类型: object | |
├─ msg | string | 必须 | |||
├─ code | string | 必须 | |||
├─ order_id | number | 必须 | 订单id |
Path: /open/api/create_order
Method: POST
接口描述:
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
side | text | 是 | SELL | 买卖方向BUY、SELL |
type | text | 是 | 1 | 挂单类型,1:限价委托、2:市价委托 |
volume | text | 是 | 0.001 | 购买数量(多义,复用字段) type=1:表示买卖数量 type=2:买则表示总价格,卖表示总数量 |
symbol | text | 是 | bchusdt | 市场标记,bchusdt |
time | text | 是 | 1567415490190 | 时间戳 |
api_key | text | 是 | 1174082eaf4002419a0628d77439090c | api_key |
sign | text | 是 | 74da381312ba855f5b03b867ef6d44b4 | 签名 |
price | text | 是 | 1 | 委托单价,type=2不需要此参数 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: 成功 | ||
data | object | 非必须 | |||
├─ order_id | number | 非必须 | 订单id |
Path: /open/api/cancel_order
Method: POST
接口描述:
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
order_id | text | 是 | 10001 | 订单id |
symbol | text | 是 | bchusdt | 市场标记,bchusdt |
api_key | text | 是 | 1174082eaf4002419a0628d77439090c | api_key |
time | text | 是 | 1567415490190 | 时间戳 |
sign | text | 是 | sign | 签名 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: 成功 | ||
data | string | 非必须 | mock: "" |
Path: /open/api/mass_replaceV2
Method: POST
接口描述:
mass_place 是需要发送到系统的一批订单,每次最多10条
mass_cancel 是需要撤回的一批订单,每次最多10条
mass_place:下单参数。side:方向(买卖方向BUY、SELL)
-------------------------type:类型(1:限价委托、2:市价委托)
-------------------------volume:购买数量(多义,复用字段) type=1:表示买卖数量type=2:买则表示总价格,卖表示总数量
-------------------------price:委托单价,type=2不需要此参数
-------------------------fee_is_user_exchange_coin:(冗余字段)当交易所有平台币时,此参数表示是否使用用平台币支付手续费,0否,1是
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
mass_place | text | 否 | [{"side":"SELL","type":"1","volume":"1","price":"10","fee_is_user_exchange_coin":"0"}] | mass_place:下单参数 |
symbol | text | 是 | btcusdt | 币种 ,例 btcusdt |
time | text | 是 | 1567415490190 | 时间戳 |
sign | text | 是 | sign | 签名 |
api_key | text | 是 | api_key | api_key |
mass_cancel | text | 否 | [78321,78322,78323] | 撤单参数,订单id,多个订单id使用英文逗号分隔 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 必须 | mock: 0 | ||
msg | string | 必须 | mock: success | ||
data | object | 非必须 | |||
├─ mass_cancel | object [] | 非必须 | 批量撤单信息 | item 类型: object | |
├─ msg | string | 必须 | |||
├─ code | string | 必须 | |||
├─ order_id | number | 必须 | 撤销订单id | ||
├─ mass_place | object [] | 非必须 | 批量下单信息 | item 类型: object | |
├─ msg | string | 必须 | |||
├─ code | string | 必须 | |||
├─ order_id | number | 必须 | 订单id |
Path: /open/pub/trades
Method: GET
接口描述:
{
"code": "0",
"msg": "suc",
"message": null,
"data": {
"date": 1574735405297,
"trades": [
{
"tradeID": 3523643,
"price": "0.01",
"base_volume": "569000",
"quote_volume": "0.01000000",
"trade_timestamp": "1566360780",
"type": "sell"
},
{
"tradeID": 3523642,
"price": "0.01",
"base_volume": "569000",
"quote_volume": "0.01000000",
"trade_timestamp": "1566360780",
"type": "sell"
}
]
}
}
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
base | 是 | btc | |
quote | 是 | usdt | |
trades | 否 | 100 | 默认返回100条记录 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | |||
msg | string | 非必须 | |||
message | null | 非必须 | |||
data | object | 非必须 | |||
├─ date | number | 非必须 | |||
├─ trades | object [] | 非必须 | item 类型: object | ||
├─ tradeID | number | 必须 | 交易记录ID | ||
├─ price | string | 必须 | 价格 | ||
├─ base_volume | string | 必须 | 基础货币交易量 | ||
├─ quote_volume | string | 必须 | 计价货币交易量 | ||
├─ trade_timestamp | string | 必须 | 交易时间 时间戳 | ||
├─ type | string | 必须 | 交易方向(sell/buy) |
Path: /open/pub/ticker
Method: GET
接口描述:
{
"code": "0",
"msg": "suc",
"message": null,
"data": {
"date": 1574735405297,
"ticker": {
"BTC_USDT": {
"base_id": "1",
"quote_id": "825",
"last_price": "10000",
"quote_volume": "20000",
"base_volume": "2"
},
"LTC_BTC": {
"base_id": "2",
"quote_id": "1",
"last_price": "0.00699900",
"base_volume": "20028,526",
"quote_volume": "279594"
}
}
}
}
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | |||
msg | string | 非必须 | |||
message | null | 非必须 | |||
data | object | 非必须 | |||
├─ date | number | 非必须 | |||
├─ ticker | object | 非必须 | |||
├─ BTC_USDT | object | 非必须 | |||
├─ base_id | string | 非必须 | base货币ID | ||
├─ quote_id | string | 非必须 | 计价货币ID | ||
├─ last_price | string | 非必须 | 最新交易价格 | ||
├─ quote_volume | string | 非必须 | 计价货币交易量 | ||
├─ base_volume | string | 非必须 | 基础货币交易量 | ||
├─ LTC_BTC | object | 非必须 | |||
├─ base_id | string | 非必须 | base货币ID | ||
├─ quote_id | string | 非必须 | 计价货币ID | ||
├─ last_price | string | 非必须 | |||
├─ base_volume | string | 非必须 | |||
├─ quote_volume | string | 非必须 |
Path: /open/pub/asset
Method: GET
接口描述:
{
"code": "0",
"msg": "suc",
"message": null,
"data": {
"date": 1574735405297,
"asset": {
"BTC": {
"name": "bitcoin",
"unified_cryptoasset_id": "1",
"can_withdraw": "true",
"can_deposit": "true",
"min_withdraw": "0.01",
"max_withdraw ": "100"
},
"ETH": {
"name": "bitcoin",
"unified_cryptoasset_id": "1027",
"can_withdraw": "true",
"can_deposit": "true",
"min_withdraw": "0.01",
"max_withdraw ": "100"
}
}
}
}
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | |||
msg | string | 非必须 | |||
message | null | 非必须 | |||
data | object | 非必须 | |||
├─ date | number | 非必须 | |||
├─ asset | object | 非必须 | |||
├─ BTC | object | 非必须 | |||
├─ name | string | 非必须 | 币种全称 | ||
├─ unified_cryptoasset_id | string | 非必须 | 币种ID | ||
├─ can_withdraw | string | 非必须 | 是否开启提现 | ||
├─ can_deposit | string | 非必须 | 是否开启充值 | ||
├─ min_withdraw | string | 非必须 | 最小提现数额 | ||
├─ max_withdraw | string | 非必须 | 最大提现数额 | ||
├─ ETH | object | 非必须 | |||
├─ name | string | 非必须 | |||
├─ unified_cryptoasset_id | string | 非必须 | 币种ID | ||
├─ can_withdraw | string | 非必须 | |||
├─ can_deposit | string | 非必须 | |||
├─ min_withdraw | string | 非必须 | |||
├─ max_withdraw | string | 非必须 |
Path: /open/pub/orderbook
Method: GET
接口描述:
{
"code": "0",
"msg": "suc",
"message": null,
"data": {
"date": 1574735405297,
"orderbook": {
"bids": [
["12462000", "0.04548320"],
["12457000", "3.00000000"]
],
"asks": [
["12506000", "2.73042000"],
["12508000", "0.33660000"]
]
}
}
}
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
base | 是 | btc | btc |
quote | 是 | usdt | usdt |
depth | 否 | 0,1,2 | 不填默认为0 |
bids | 否 | 150 | |
asks | 否 | 150 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | |||
msg | string | 非必须 | |||
message | null | 非必须 | |||
data | object | 非必须 | |||
├─ date | number | 非必须 | |||
├─ orderbook | object | 非必须 | |||
├─ bids | array [] | 非必须 | item 类型: array | ||
├─ | 非必须 | ||||
├─ | 非必须 | ||||
├─ asks | array [] | 非必须 | item 类型: array | ||
├─ | 非必须 | ||||
├─ | 非必须 |
Path: wss://wspool.hiotc.pro/kline-api/ws
Method: GET
接口描述:
订阅-K线行情
{"event":"sub","params":{"channel":"market_$base$quote_kline_[1min/5min/15min/30min/60min/1day/1week/1month]","cb_id":"自定义"}}
{"event_rep":"subed","channel":"market_$base$quote_kline_[1min/5min/15min/30min/60min/1day/1week/1month]","cb_id":"原路返回","ts":1506584998239,"status":"ok"}
{
"channel":"market_$base$quote_kline_[1min/5min/15min/30min/60min/1day/1week/1month]",//订阅的交易对行情$base$quote表示btckrw等
"ts":1506584998239,//请求时间
"tick":{
"id":1506602880,//时间刻度起始值
"amount":123.1221,//交易额
"vol":1212.12211,//交易量
"open":2233.22,//开盘价
"close":1221.11,//收盘价
"high":22322.22,//最高价
"low":2321.22//最低价
}
}
{"event":"sub","params":{"channel":"market_$base$quote_ticker","cb_id":"自定义"}}
{"event_rep":"subed","channel":"market_$base$quote_ticker","cb_id":"原路返回","ts":1506584998239,"status":"ok","lower_frame":"0"} // lower_frame: 0 币对没下架、 1 币对下架
{
"channel":"market_$base$quote_ticker",//订阅的交易对行情$base$quote表示btckrw等
"ts":1506584998239,//请求时间
"tick":{
"id":1506584998,//冗余,无实际意义,时间戳
"amount":123.1221,//交易额
"vol":1212.12211,//交易量
"open":2233.22,//开盘价
"close":1221.11,//收盘价
"high":22322.22,//最高价
"low":2321.22,//最低价
"rose":-0.2922,//涨幅
"ts":1506584998239,//数据产生时间
"lower_frame":"0"
}
}
{"event":"sub","params":{"channel":"market_$base$quote_depth_step[0-2]","cb_id":"自定义","asks":150,"bids":150}}
{"event_rep":"subed","channel":"market_$base$quote_depth_step[0-2]","cb_id":"原路返回","asks":150,"bids":150,"ts":1506584998239,"status":"ok"}
{
"channel":"market_$base$quote_depth_step[0-2]",//$base$quote表示btckrw等,深度有3个维度,0、1、2
"ts":1506584998239,//请求时间
"tick":{
"asks":[//卖盘
[22112.22,0.9332],
[22112.21,0.2],
],
"buys":[//买盘
[22111.22,0.9332],
[22111.21,0.2],
]
}
}
{
"channel":"market_$base$quote_depth_step[0-2]",//$base$quote表示btckrw等,深度有3个维度,0、1、2
"ts":1506584998239,//请求时间
"tick":{
"side": "asks", 买卖盘方向 asks: 卖盘 buys: 买盘
"price" : 133.55, 盘口对应的某个价格段
"volume" : 44.22 价格段对应的数量
}
}
{"event":"sub","params":{"channel":"market_$base$quote_depth_step[0-2]","cb_id":"自定义","asks":150,"bids":150}}
{"event_rep":"subed","channel":"market_$base$quote_depth_step[0-2]","cb_id":"原路返回","asks":150,"bids":150,"ts":1506584998239,"status":"ok"}
{
"channel":"market_$base$quote_depth_step[0-2]",//$base$quote表示btckrw等,深度有3个维度,0、1、2
"ts":1506584998239,//请求时间
"tick":{
"asks":[//卖盘
[22112.22,0.9332],
[22112.21,0.2]
],
"buys":[//买盘
[22111.22,0.9332],
[22111.21,0.2]
]
}
}
{"event":"sub","params":{"channel":"market_$base$quote_trade_ticker","cb_id":"自定义"}}
{"event_rep":"subed","channel":"market_$base$quote_trade_ticker","cb_id":"原路返回","ts":1506584998239,"status":"ok"}
{
"channel":"market_$base$quote_trade_ticker",//订阅的交易对行情$base$quote表示btckrw等
"ts":1506584998239,//请求时间
"tick":{
"id":12121,//data中最大交易ID
"ts":1506584998239,//data中最大时间
"data":[
{
"id":12121,//交易ID
"side":"buy",//买卖方向buy,sell
"price":32.233,//单价
"vol":232,//数量
"amount":323,//总额
"ts":1506584998239,//数据产生时间
"ds":'2017-09-10 23:12:21'
},
{
"id":12120,//交易ID
"side":"buy",//买卖方向buy,sell
"price":32.233,//单价
"vol":232,//数量
"amount":323,//总额
"ts":1506584998239,//数据产生时间
"ds":'2017-09-10 23:12:21'
}
]
}
}
{"event":"req","params":{"channel":"market_$base$quote_kline_[1min/5min/15min/30min/60min/1day/1week/1month]","cb_id":"自定义","since":"1506602880"}}//since缺省时返回最新300条,有值时返回大于since的最多1小时数据,since有强校验,不能早于当前1小时 since取到59
{
"event_rep":"rep","channel":"market_$base$quote_kline_[1min/5min/15min/30min/60min/1day/1week/1month]","cb_id":"原路返回",
"since":"1506602880",//since缺省时返回最新300条,有值时返回大于since的最多1小时数据,since有强校验,不能早于当前1小时
"ts":1506584998239,//请求时间
"data":[//300条
{
"id":1506602880,//时间刻度起始值
"amount":123.1221,//交易额
"vol":1212.12211,//交易量
"open":2233.22,//开盘价
"close":1221.11,//收盘价
"high":22322.22,//最高价
"low":2321.22//最低价
},
{
"id":1506602880,//时间刻度起始值
"amount":123.1221,//交易额
"vol":1212.12211,//交易量
"open":2233.22,//开盘价
"close":1221.11,//收盘价
"high":22322.22,//最高价
"low":2321.22//最低价
}
]
}
{"event":"req","params":{"channel":"market_$base$quote_trade_ticker","cb_id":"自定义","top":200}}
{
"event_rep":"rep","channel":"market_$base$quote_trade_ticker","cb_id":"原路返回","ts":1506584998239,"status":"ok",
"top":200,//最大支持200
"data":[
{
"id":12121,//交易ID
"side":"buy",//买卖方向buy,sell
"price":32.233,//单价
"vol":232,//数量
"amount":323,//总额
"ts":1506584998239//数据产生时间
},
{
"id":12120,//交易ID
"side":"buy",//买卖方向buy,sell
"price":32.233,//单价
"vol":232,//数量
"amount":323,//总额
"ts":1506584998239,//数据产生时间
"ds":'2017-09-10 23:12:21'
}
]
}
{"event":"req","params":{"channel":"review"}}
{
event_rep: "rep",
channel: "review",
data: {
bchbtc: {amount: "115.968833484"close: "0.07956"high: "0.086323"low: "0.079251"open: "0.086323"rose: "-0.07834528"vol: "1393.247"}
bchusdt: {amount: "416316.164145661", close: "513.56", high: "556.42", low: "510.85", open: "555.71", …}
btcusdt: {amount: "999341.34124", close: "6450.18", high: "6486.39", low: "6359.63", open: "6435.79", …}
}
}
Path: /open/api/market_dept
Method: GET
接口描述:
{
"code": "0",
"msg": "suc",
"data": {
"tick": {
"asks": [//卖盘(BTCUSDT)
[
7230.1782,//价格(USDT)
6.133//数量(BTC)
],
[
7230.3757,
0.007
]
],
"bids": [//买盘(BTCUSDT)
[
7225.5867,//价格(USDT)
0.001//数量(BTC)
],
[
7225.4409,
1.425
]
],
}
}
}
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 市场标记,btcusdt |
type | 是 | step0 | 深度类型,step0, step1, step2(合并深度0-2);step0时,精度最高 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 必须 | mock: 0 | ||
msg | string | 必须 | code>0失败 | mock: suc | |
data | object | 必须 | |||
├─ tick | object | 必须 | |||
├─ asks | array [] | 必须 | 卖盘 | item 类型: array | |
├─ | 非必须 | ||||
├─ | 非必须 | ||||
├─ bids | array [] | 必须 | 买盘 | item 类型: array | |
├─ | 非必须 | ||||
├─ | 非必须 |
Path: /open/api/common/symbols
Method: GET
接口描述:
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 必须 | mock: 0 | ||
msg | string | 必须 | code>0失败 | mock: suc | |
data | object | 必须 | |||
├─ symbol | string | 必须 | 交易对 | ||
├─ base_coin | string | 必须 | 基础币种 | ||
├─ count_coin | string | 必须 | 计价货币 | ||
├─ price_precision | integer | 必须 | 价格精度位数(0为个位) | ||
├─ amount_precision | integer | 必须 | 数量精度位数(0为个位) |
Path: /open/api/get_records
Method: GET
接口描述:
{
"code": "0", //code>0 失败
"msg": "suc",
"message": null,
"data": [
[
1575862380, //时间戳
7488.0048, //开盘价
7494.3289, //最高
7487.8441, //最低
7491.4864, //收盘价
61.85934342, //交易量
463413.3915064308 //交易额
],
[
1575862440,
7491.2481,
7492.7238,
7490.505,
7491.0626,
47.8,
358101.3027824
]
]
}
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 市场标记,例如btcusdt、ethbtc |
period | 是 | 1 | 单位为分钟,例如1分钟则为1,一天则为1440 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | array [] | 非必须 | item 类型: array | ||
├─ | 非必须 | ||||
├─ | 非必须 |
Path: /open/api/market
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
api_key | 是 | api_key | api_key |
time | 是 | 1576131763759 | 时间戳 |
sign | 是 | sign | 签名 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ btcusdt | number | 非必须 | 币对名称 | ||
├─ eoseth | number | 非必须 | 币对名称 | ||
├─ ethusdt | number | 非必须 | 币对名称 | ||
├─ xxx-xxx | number | 非必须 | 币对名称(其他开放交易的币对) |
Path: /open/api/get_ticker
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 市场标记,例如btcusdt、ethbtc |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ high | string | 非必须 | 最高价 | ||
├─ vol | string | 非必须 | 交易量 | ||
├─ last | number | 非必须 | 最新成交价 | ||
├─ low | string | 非必须 | 最低价 | ||
├─ buy | number | 非必须 | 买一价 | ||
├─ sell | number | 非必须 | 卖一价 | ||
├─ rose | string | 非必须 | 涨跌幅 | ||
├─ time | number | 非必须 | 时间戳 |
Path: /open/api/get_allticker
Method: GET
接口描述:
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ date | number | 非必须 | 返回数据时服务器时间 | ||
├─ ticker | object [] | 非必须 | item 类型: object | ||
├─ symbol | string | 必须 | 交易对(交易对1(base)简称_交易对2(quote)简称) | ||
├─ high | string | 必须 | 最高价 | ||
├─ low | string | 必须 | 最低价 | ||
├─ buy | number | 必须 | 买一价 | ||
├─ sell | number | 必须 | 卖一价 | ||
├─ vol | string | 必须 | 成交量(最近的24小时) | ||
├─ last | number | 必须 | 最新成交价 | ||
├─ rose | string | 必须 | 涨跌幅 |
Path: /open/api/get_trades
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 市场标记,btcusdt |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object [] | 非必须 | item 类型: object | ||
├─ id | number | 必须 | 成交id | ||
├─ amount | number | 必须 | 成交数量 | ||
├─ price | number | 必须 | 成交价格 | ||
├─ type | string | 必须 | 主动单方向 | ||
├─ ts | number | 必须 | 成交时间(时间戳) | ||
├─ ds | string | 必须 | 成交时间(日期格式) |
Path: /open/api/v2/all_order
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 市场标记,btcusdt |
startDate | 否 | 2019-12-10 12:00:01 | 开始时间,精确到秒"yyyy-MM-dd mm:hh:ss" |
endDate | 否 | 2019-12-10 18:00:01 | 结束时间,精确到秒"yyyy-MM-dd mm:hh:ss" |
pageSize | 否 | 20 | 页面大小 |
page | 否 | 1 | 页码 |
api_key | 是 | api_key | api_key |
time | 是 | 1575887255534 | 时间戳 |
sign | 是 | sign | 签名 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | |||
msg | string | 非必须 | |||
data | object | 非必须 | |||
├─ count | number | 非必须 | |||
├─ orderList | object [] | 非必须 | item 类型: object | ||
├─ id | number | 必须 | 订单id | ||
├─ side | string | 必须 | 买卖方向 | ||
├─ side_msg | string | 必须 | 买卖方向信息 | ||
├─ status | number | 必须 | 订单状态 | ||
├─ status_msg | string | 必须 | 订单状态信息 | ||
├─ created_at | number | 必须 | 创建时间 | ||
├─ price | string | 必须 | 限价单挂单价格 | ||
├─ volume | string | 必须 | 挂单总数量 | ||
├─ type | number | 必须 | 委托订单类型 | ||
├─ source | number | 必须 | 订单来源 | ||
├─ source_msg | string | 必须 | 订单来源信息 | ||
├─ total_price | string | 必须 | 订单总金额 | ||
├─ remain_volume | string | 必须 | 未成交数量 | ||
├─ deal_volume | string | 必须 | 成交数量 | ||
├─ avg_price | string | 必须 | 成交均价 | ||
├─ baseCoin | string | 必须 | 基础货币 | ||
├─ countCoin | string | 必须 | 计价货币 |
Path: /open/api/all_trade
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 市场标记,btcusdt |
startDate | 否 | 2019-12-10 12:00:01 | 开始时间,精确到秒“yyyy-MM-dd HH:mm:ss” |
endDate | 否 | 2019-12-10 18:00:01 | 结束时间,精确到秒“yyyy-MM-dd HH:mm:ss” |
pageSize | 否 | 20 | 页面大小 |
page | 否 | 1 | 页码 |
api_key | 是 | api_key | api_key |
time | 是 | 1575887255534 | 时间戳 |
sign | 是 | sign | 签名 |
sort | 否 | 1 | 1表示id倒序(需要id倒序可以使用) |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ count | number | 非必须 | |||
├─ resultList | object [] | 非必须 | item 类型: object | ||
├─ id | number | 非必须 | 成交id | ||
├─ side | string | 非必须 | 买卖方向 | ||
├─ ask_user_id | number | 非必须 | 卖方用户id | ||
├─ bid_user_id | number | 非必须 | 买方用户id | ||
├─ type | string | 非必须 | 买卖方向信息 | ||
├─ bid_id | number | 非必须 | 买单id | ||
├─ ask_id | number | 非必须 | 卖单id | ||
├─ price | string | 非必须 | 成交价格 | ||
├─ volume | string | 非必须 | 成交数量 | ||
├─ deal_price | string | 非必须 | 成交金额(price*volume) | ||
├─ fee | string | 非必须 | 买或卖单手续费 | ||
├─ feeCoin | string | 非必须 | 买或卖单支付手续费的币种 | ||
├─ ctime | number | 非必须 | 成交时间 |
Path: /open/api/v3/new_order
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 市场标记,btcusdt |
pageSize | 否 | 20 | 页面大小 |
page | 否 | 1 | 页码 |
api_key | 是 | api_key | api_key |
time | 是 | 1575887255534 | 时间戳 |
sign | 是 | sign | 签名 |
pendingCancel | 是 | 0 | 0表示排除待撤单状态订单 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ count | number | 非必须 | |||
├─ resultList | object [] | 非必须 | item 类型: object | ||
├─ id | number | 必须 | 订单id | ||
├─ side | string | 必须 | 买卖方向 | ||
├─ side_msg | string | 必须 | 买卖方向信息 | ||
├─ status | number | 必须 | 订单状态 | ||
├─ status_msg | string | 必须 | 订单状态信息 | ||
├─ created_at | number | 必须 | 订单创建时间 | ||
├─ price | string | 必须 | 限价单挂单价格 | ||
├─ volume | string | 必须 | 挂单总数量 | ||
├─ type | number | 必须 | 委托订单类型 | ||
├─ source | number | 必须 | 订单来源 | ||
├─ source_msg | string | 必须 | 订单来源信息 | ||
├─ total_price | string | 必须 | 订单总金额 | ||
├─ remain_volume | string | 必须 | 未成交数量 | ||
├─ deal_volume | string | 必须 | 成交数量 | ||
├─ avg_price | string | 必须 | 成交均价 | ||
├─ baseCoin | string | 必须 | 基础货币 | ||
├─ countCoin | string | 必须 | 计价货币 |
Path: /open/api/order_info
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
order_id | 是 | orderId | 订单Id |
symbol | 是 | btcusdt | 市场标记,btcusdt |
api_key | 是 | api_key | api_key |
time | 是 | 1575887255534 | 时间戳 |
sign | 是 | sign | 签名 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ trade_list | object [] | 非必须 | 成交信息 | item 类型: object | |
├─ volume | string | 非必须 | 成交数量 | ||
├─ feeCoin | string | 非必须 | 买或卖单支付手续费的币种 | ||
├─ price | string | 非必须 | 成交价格 | ||
├─ fee | string | 非必须 | 买或卖单手续费 | ||
├─ ctime | number | 非必须 | 成交时间 | ||
├─ deal_price | string | 非必须 | 成交金额(volume*price) | ||
├─ id | number | 非必须 | 成交id | ||
├─ type | string | 非必须 | 买入或卖出信息 | ||
├─ order_info | object | 非必须 | 订单信息 | ||
├─ id | number | 非必须 | 订单id | ||
├─ side | string | 非必须 | 买卖方向 | ||
├─ side_msg | string | 非必须 | 买卖方向信息 | ||
├─ status | number | 非必须 | 订单状态 | ||
├─ status_msg | string | 非必须 | 订单状态信息 | ||
├─ created_at | number | 非必须 | 订单创建时间 | ||
├─ price | string | 非必须 | 限价单挂单价格 | ||
├─ volume | string | 非必须 | 挂单总数量 | ||
├─ type | number | 非必须 | 委托订单类型 | ||
├─ source | number | 非必须 | 订单来源 | ||
├─ source_msg | string | 非必须 | 订单来源信息 | ||
├─ total_price | string | 非必须 | 订单总金额 | ||
├─ remain_volume | string | 非必须 | 未成交数量 | ||
├─ deal_volume | string | 非必须 | 成交数量 | ||
├─ avg_price | string | 非必须 | 成交均价 | ||
├─ baseCoin | string | 非必须 | 基础货币 | ||
├─ countCoin | string | 非必须 | 计价货币 | ||
├─ tradeList | object [] | 非必须 | 成交信息(冗余) | item 类型: object | |
├─ volume | string | 非必须 | |||
├─ feeCoin | string | 非必须 | |||
├─ price | string | 非必须 | |||
├─ fee | string | 非必须 | |||
├─ ctime | number | 非必须 | |||
├─ deal_price | string | 非必须 | |||
├─ id | number | 非必须 | |||
├─ type | string | 非必须 |
Path: /open/api/margin/all_trade
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
type | 是 | 2 | 2杠杆订单,1币币订单 |
symbol | 是 | btcusdt | 市场标记,btcusdt |
startDate | 否 | 2019-12-10 12:00:01 | 开始时间,精确到秒“yyyy-MM-dd HH:mm:ss” |
endDate | 否 | 2019-12-10 18:00:01 | 结束时间,精确到秒“yyyy-MM-dd HH:mm:ss” |
pageSize | 否 | 20 | 页面大小 |
page | 否 | 1 | 页码 |
api_key | 是 | api_key | api_key |
time | 是 | 1575887255534 | 时间戳 |
sign | 是 | sign | 签名 |
sort | 否 | 1 | 1表示id倒序(需要id倒序可以使用) |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ count | number | 非必须 | |||
├─ resultList | object [] | 非必须 | item 类型: object | ||
├─ id | number | 非必须 | 成交id | ||
├─ side | string | 非必须 | 买卖方向 | ||
├─ ask_user_id | number | 非必须 | 卖方用户id | ||
├─ bid_user_id | number | 非必须 | 买方用户id | ||
├─ type | string | 非必须 | 买卖方向信息 | ||
├─ bid_id | number | 非必须 | 买单id | ||
├─ ask_id | number | 非必须 | 卖单id | ||
├─ price | string | 非必须 | 成交价格 | ||
├─ volume | string | 非必须 | 成交数量 | ||
├─ deal_price | string | 非必须 | 成交金额(price*volume) | ||
├─ fee | string | 非必须 | 买或卖单手续费 | ||
├─ feeCoin | string | 非必须 | 买或卖单支付手续费的币种 | ||
├─ ctime | number | 非必须 | 成交时间 |
Path: /open/api/margin/new_order
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
type | 是 | 2 | 2杠杆订单,1币币订单 |
symbol | 是 | btcusdt | 市场标记,btcusdt |
startDate | 否 | 2019-12-12 12 | 开始时间,精确到秒“yyyy-MM-dd mm:hh:ss” |
endDate | 否 | 2019-12-12 18 | 结束时间,精确到秒“yyyy-MM-dd mm:hh:ss” |
pageSize | 否 | 20 | 页面大小 |
page | 否 | 1 | 页码 |
api_key | 是 | api_key | api_key |
time | 是 | 1576131763759 | 时间戳 |
sign | 是 | sign | 签名 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ count | number | 非必须 | |||
├─ resultList | object [] | 非必须 | item 类型: object | ||
├─ id | number | 非必须 | 订单id | ||
├─ side | string | 非必须 | 买卖方向 | ||
├─ side_msg | string | 非必须 | 买卖方向信息 | ||
├─ status | number | 非必须 | 订单状态 | ||
├─ status_msg | string | 非必须 | 订单状态信息 | ||
├─ created_at | number | 非必须 | 订单创建时间 | ||
├─ price | string | 非必须 | 限价单挂单价格 | ||
├─ volume | string | 非必须 | 挂单总数量 | ||
├─ type | number | 非必须 | 委托订单类型 | ||
├─ source | number | 非必须 | 订单来源 | ||
├─ source_msg | string | 非必须 | 订单来源信息 | ||
├─ total_price | string | 非必须 | 订单总金额 | ||
├─ remain_volume | string | 非必须 | 未成交数量 | ||
├─ deal_volume | string | 非必须 | 成交数量 | ||
├─ avg_price | string | 非必须 | 成交均价 | ||
├─ baseCoin | string | 非必须 | 基础货币 | ||
├─ countCoin | string | 非必须 | 计价货币 |
Path: /open/api/user/info
Method: POST
接口描述:
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
api_key | string | 必须 | |||
time | string | 必须 | |||
sign | string | 必须 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | 0成功 | ||
msg | string | 非必须 | |||
data | object | 非必须 | |||
├─ uid | number | 非必须 | uid | ||
├─ mobileNumber | string | 非必须 | 手机 | ||
string | 非必须 | 邮箱 | |||
├─ inviteCode | string | 非必须 | 邀请码 |
Path: /open/api/margin/symbol/balance
Method: POST
接口描述:
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
symbol | 是 | btcusdt | 币对名称 |
api_key | 是 | api_key | api_key |
time | 是 | 1576131763759 | 时间戳 |
sign | 是 | sign | 签名 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ symbol | string | 非必须 | 币对名称 | ||
├─ riskRate | number | 非必须 | 风险率 | ||
├─ quoteTotalBalance | number | 非必须 | quote杠杆总资产(正常+冻结) | ||
├─ quoteNormalBalance | number | 非必须 | quote杠杆正常余额 | ||
├─ quoteLockBalance | number | 非必须 | quote杠杆冻结余额 | ||
├─ burstPrice | number | 非必须 | 爆仓价 | ||
├─ baseLockBalance | number | 非必须 | base杠杆冻结余额 | ||
├─ baseNormalBalance | number | 非必须 | base杠杆正常余额 | ||
├─ quoteCoin | string | 非必须 | 计价货币(quote资产) | ||
├─ baseCoin | string | 非必须 | 基础货币(base资产) | ||
├─ baseTotalBalance | number | 非必须 | base杠杆总资产(正常+冻结) |
Path: /open/api/user/account
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
api_key | 是 | api_key | api_key |
time | 是 | 1576131763759 | 时间戳 |
sign | 是 | sign | 签名 |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | mock: 0 | ||
msg | string | 非必须 | mock: suc | ||
data | object | 非必须 | |||
├─ total_asset | string | 非必须 | 总资产 | ||
├─ coin_list | object [] | 非必须 | item 类型: object | ||
├─ normal | string | 必须 | 可用余额账户 | ||
├─ btcValuatin | string | 必须 | BTC估值 | ||
├─ locked | string | 必须 | 冻结账户 | ||
├─ coin | string | 必须 | 数字货币名称 |