接口描述:
- 获取个人历史委托单列表
请求URL:
https://apiv2.bitz.com/Trade/getUserHistoryEntrustSheet
请求方式:
POST
参数:
参数名 | 必选 | 类型 | 备注 |
---|---|---|---|
apiKey | 是 | string | 用户申请的apiKey |
timeStamp | 是 | string | 当前的时间戳 |
nonce | 是 | string | 随机6位字符 |
sign | 是 | string | 请求参数的签名 |
coinFrom | 否 | string | eos、vtc 币种 |
coinTo | 否 | string | btc、eth交易区间 |
type | 否 | integer | 1:买,2:卖 不传时返回所有 |
page | 否 | integer | 当前页数 |
pageSize | 否 | integer | 每页展示数量 最大值 100 |
startTime | 否 | string | 开始时间戳 |
endTime | 否 | string | 结束时间戳 |
如何对请求参数进行签名
用户提交的参数除sign外,都要参与签名。
首先,将待签名字符串要求按照参数名进行排序(首先比较所有参数名的第一个字母,按abcd顺序排列,若遇到相同首字母,则看第二个字母,以此类推)。
例如:对于如下的参数进行签名
apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&coinFrom=eos&coinTo=btc &type=1&page=1&pageSize=10&startTime=1510235730&endTime=1510237730再拼接上申请的secretKey(只写值,不需要写变量名,不需要写'&')
例如:secretKey=aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw
拼接后的签名串: apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&coinFrom=eos&coinTo=btc&type=1&page=1&pageSize=10&startTime=1510235730&endTime=1510237730aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw
注意,"sign"为签名必传参数。
最后,是利用32位md5算法,对最终待签名字符串进行签名运算,从而得到签名结果字符串(该字符串赋值于参数sign)。
返回结果实例:
{
"status":200,
"msg":"",
"data":{
"data":[
{
"id":"693248739",
"uid":"2074056",
"price":"100.00000000",
"number":"10.0000",
"total":"0.00000000",
"numberOver":"0.0000",
"numberDeal":"0.0000",
"flag":"sale",
"status":3, // 0:未成交, 1:部分成交, 2:全部成交, 3:已经撤销
"isNew":"N",
"coinFrom":"vtc",
"coinTo":"dkkt",
"created":"1533035300"
},
{
"id":"723086996",
"uid":"2074056",
"price":"100.00000000",
"number":"10.0000",
"total":"0.00000000",
"numberOver":"0.0000",
"numberDeal":"0.0000",
"flag":"sale",
"status":3,
"isNew":"N",
"coinFrom":"bz",
"coinTo":"usdt",
"created":"1533523568"
},
],
"pageInfo":{
"limit":"10",
"offest":"0",
"current_page":"1",
"page_size":"10",
"total_count":"17",
"page_count":"2"
}
},
"time":1533279329,
"microtime":"0.15305300 1533279329",
"source":"api"
}