接口描述:
  • 合约交易下单
请求URL:
  • https://apiv2.bitz.com/Contract/addContractTrade
请求方式:
  • POST
参数:
参数名 必选 类型 备注
apiKey string 用户申请的apiKey
timeStamp string 当前的时间戳
nonce string 随机6位字符
sign string 请求参数的签名
contractId int 合约ID
price float 价格,如果传入类型为market,则无需传递price
amount int 合约张数
leverage float 杠杆倍数
direction int 委托方向 1: 做多;-1: 做空
type string 委托类型 limit: 限价单; market: 市价单,要求字符串小写
isCross int 是否全仓 1: 全仓,-1:非全仓
如何对请求参数进行签名:

用户提交的参数除sign外,都要参与签名。

首先,将待签名字符串要求按照参数名进行排序(首先比较所有参数名的第一个字母,按abcd顺序排列,若遇到相同首字母,则看第二个字母,以此类推)。

例如:对于如下的参数进行签名

apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&contractId=101&price=1&amount=1&leverage=10&direction=1&type=limit&isCross=1再拼接上申请的secretKey(只写值,不需要写变量名,不需要写'&')

例如:secretKey=aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw

拼接后的签名串: apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&contractId=101&price=1&amount=1&leverage=10&direction=1&type=limit&isCross=1aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw

注意,"sign"为签名必传参数。

最后,是利用32位md5算法,对最终待签名字符串进行签名运算,从而得到签名结果字符串(该字符串赋值于参数sign)。

返回结果实例:
{
    "status":200,
    "msg":"",
    "data":{
         "orderId":710370//委托单ID
    },
    "time":1533035297,
    "microtime":"0.41892000 1533035297",
    "source":"api"
}

results matching ""

    No results matching ""