接口描述:
  • 批量提交限價委託單
請求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順序排列,若遇到相同首字母,則看第二個字母,以此類推) 。

例如:對於如下的參數進行簽名

timeStamp=1552641715&nonce=ue8jAx&apiKey=17919e05dc57d5d44dccdda03bdd6e2e&coin=usdt&address=1AG1gZvQAYu3WBvgg7p4BvvfNQD2gE693k&number=1000&sign=6932efc6aa44f7605e808bfaa98fd630再拼接上申請的secretKey(只寫值,不需要寫變量名,不需要寫'&')

例如:secretKey=aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw

拼接後的簽名串: timeStamp=1552641715&nonce=ue8jAx&apiKey=17919e05dc57d5d44dccdda03bdd6e2e&coin=usdt&address=1AG1gZvQAYu3WBvJJ7p4BMMfNQD2gE693k&number=1000aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw

注意,"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": 1552910869,  //秒級時間戳
       "microtime": "0.50102400 1552910869", //毫秒級時間戳
       "source": "api"  //來源
    }
}

results matching ""

    No results matching ""