接口描述:
  • 批量提交限价委托单
请求URL:
  • https://apiv2.bitz.com/Trade/addEntrustSheetBatch
请求方式:
  • POST
参数:
参数名 必选 类型 备注
apiKey string 用户申请的apiKey
timeStamp string 当前的时间戳
nonce string 随机6位字符
sign string 请求参数的签名
tradeData string 请求json串,最大30组数据
tradeData请求数据格式示例:

提交的交易密码tradepwd为md5加密之后的密文

严格注意tradeData json串内的数据,30组数据需均符合交易规则,严格注意书写json串内的数据参数名规范

type类型1买2卖

number、price参数值不可小于0

[
    {
        "coins":"btc_usdt",
        "number":10,
        "price":3942,
        "tradepwd":"1847d944c2ae00f555fd5eeeabaf0f3d",
        "type":2
    },
    {
        "coins":"btc_usdt",
        "number":0.1,
        "price":3942,
        "tradepwd":"1847d944c2ae00f555fd5eeeabaf0f3d",
        "type":2
    },
    ...
]
如何对请求参数进行签名:

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

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

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

apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&tradeData=5B7B22coins223A22btc_usdt222C22number22A102C22price223A39422C22tradepwd223A221847d944c2ae00f555fd5eeeabaf0f3d222C22type223A27D2C7B22再拼接上申请的secretKey(只写值,不需要写变量名,不需要写'&')

例如:secretKey=aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw

拼接后的签名串: apiKey=376892265asdad5d12726d8bbfbd8912b3&timeStamp=1510235730&nonce=309127&radeData=5B7B22coins223A22btc_usdt222C22number22A102C22price223A39422C22tradepwd223A221847d944c2ae00f555fd5eeeabaf0f3d222C22type223A27D2C7B22aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw

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

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

返回结果实例:
{
    {
        "status": 200,  //状态码 成功
        "msg": "",      //信息
        "data": [
            {
                "id": 1854694831,         //订单号
                "uId": 1483815,
                "price": "0.0000000600",  //委托价格
                "number": "2000.0000",    //委托数量
                "numberOver": "2000.0000", //剩余数量
                "flag": "buy",             //买卖类型
                "status": 0,               //0未成交 1部分成交 2全部成交
                "coinFrom": "uc",          //要兑换的币
                "coinTo": "btc",           //目标兑换
                "numberDeal": 0          //成交数量
            },
            {
                "id": 1854694836,
                "uId": 1483815,
                "price": "1.0000000000",
                "number": "1000.0000",
                "numberOver": "1000.0000",
                "flag": "sale",
                "status": 0,
                "coinFrom": "uc",
                "coinTo": "btc",
                "numberDeal": 0
            },
            ...
        ],
        "time": 1553745062,  //秒级时间戳
        "microtime": "0.05590700 1553745062",  //毫秒级时间戳
        "source": "api"  //来源
    }
}

results matching ""

    No results matching ""