Interface Description:
- Submit the limit order
Request URL:
https://apiv2.bitz.com/Trade/addEntrustSheet
Request Method:
POST
Parameters:
Parameter | Required | Type | Description |
---|---|---|---|
apiKey | true | string | apiKey requested by the user |
timeStamp | true | string | current timeStamp |
nonce | true | string | random 6-character string |
sign | true | string | signature of the requested parameter |
type | true | string | 1:buy, 2:sell |
price | true | float | price |
number | true | float | quantity |
symbol | true | string | trading pair eth_btc、ltc_btc |
tradePwd | true | string | trade password |
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
apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&type=in&price=0.04751351&number=10&symbol=eth_btc&tradePwd=asdf and then add the requested secretKey(only needs value, parameter and ‘&” is not required.)
example:secretKey=aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw
Signature string after splicing: apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&type=in&price=0.04751351&number=10&symbol=eth_btc&tradePwd=asdfaQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw
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":{
"id":"693248739", //order id
"uId":"2074056", //UID
"price":"100", //price
"number":"10", //number
"numberOver":"10", //unfilled amount
"flag":"sale", //type
"status":0, //not filled
"coinFrom":"vtc", //The currency to be exchanged
"coinTo":"dkkt", //Target exchange
"numberDeal":"0" //filled amount
},
"time":1533035297, //Second timestamp
"microtime":"0.41892000 1533035297", //Millisecond timestamp
"source":"api" //Source
}