Interface Description:
- Get the list of personal history orders
Request URL:
https://apiv2.bitz.com/Trade/getUserHistoryEntrustSheet
Request Mode:
POST
Parameters:
Parameter | Required | Type | Description |
---|---|---|---|
apiKey | true | string | User application apiKey |
timeStamp | true | string | Current timestamp |
nonce | true | string | Random 6-character string |
sign | true | string | Request signature |
coinFrom | false | string | eos、vtc coin |
coinTo | false | string | btc、eth Trading range |
type | false | integer | 1: Buy, 2: Sell, return all when not passed |
page | false | integer | current page number |
pageSize | false | integer | Number of records per page Maximum 100 |
startTime | false | string | Start timestamp |
endTime | false | string | End timestamp |
How to sign for required parameter:
All parameters submitted by users except sign require signature.
First, sort signature strings in alphabetical order based on parameters (compare the first letter of all parameter, if they differ, then the string whose first letter comes earlier in the alphabet comes before the other string. If the first letters are the same, then the second letters are compared, and so on).
For example:Sign for the following parameter
timeStamp=1552641715&nonce=ue8jAx&apiKey=17919e05dc57d5d44dccdda03bdd6e2e&coin=usdt&address=1AG1gZvQAYu3WBvgg7p4BvvfNQD2gE693k&number=1000&sign=6932efc6aa44f7605e808bfaa98fd630 and add application secretKey (only needs value, parameter and ‘&” is not required.)
For example:secretKey=aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw
Signature string after splicing: timeStamp=1552641715&nonce=ue8jAx&apiKey=17919e05dc57d5d44dccdda03bdd6e2e&coin=usdt&address=1AG1gZvQAYu3WBvJJ7p4BMMfNQD2gE693k&number=1000aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw
Note,"sign" is a required parameter.
Last,use md5 32bit algorithm to apply signature algorithm to the parameter, and then generate final signature string (the string assigns value to parameter ‘sign’).
Example of Return Result:
{
"status":200, //status code success
"msg":"", //message
"data":{
"data":[
{
"id":"693248739", //order id
"uid":"2074056",
"price":"100.00000000", //price
"number":"10.0000", //number
"total":"0.00000000", //total price
"numberOver":"0.0000", //unfilled amount
"numberDeal":"0.0000", //filled amount
"flag":"sale", //Trading type
"status":3, // 0: not filled, 1: part of the transaction, 2: all transactions, 3: has been revoked
"isNew":"N", //New order
"coinFrom":"vtc", //The currency to be exchanged
"coinTo":"dkkt", //Target exchange
"tradeType" :"1", //1 limit price 2 market price
"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",
"tradeType" :"1", //1 limit price 2 market price
"created":"1533523568"
},
],
"pageInfo":{
"limit":"10",
"offest":"0",
"current_page":"1",
"page_size":"10",
"total_count":"17",
"page_count":"2"
}
},
"time":1533279329, //timestamp
"microtime":"0.15305300 1533279329",//milliseconds timestamp
"source":"api" //source
}