接口描述:
  • 獲取合約賬戶權益(資產)
請求URL:
  • https://apiv2.bitz.com/Contract/getContractAccountInfo
請求方式:
  • POST
參數:
參數名 必選 類型 備註
apiKey string 用戶申請的apiKey
timeStamp string 當前的時間戳
nonce string 隨機6位字符
sign string 請求參數的簽名
如何對請求參數進行簽名:

用戶提交的參數除sign外,都要參與簽名。

首先,將待簽名字符串要求按照參數名進行排序(首先比較所有參數名的第一個字母,按abcd順序排列,若遇到相同首字母,則看第二個字母,以此類推) 。

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

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

例如:secretKey=aQmE8U7bxj16KdJcSd3yX8F8Sakd8aO6LopnHXh27d4kWyb28PxcaTvGrajLDvAw

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

注意,"sign"為簽名必傳參數。

最後,是利用32位md5算法,對最終待簽名字符串進行簽名運算,從而得到簽名結果字符串(該字符串賦值於參數sign)。

返回結果實例:
{
    "status":200,
    "msg":"",
    "data":{
        "time":1557928650,//時間
        "estimate_BTC":"8.00667445",//用戶總權益(BTC)
        "estimate_USDT":"17000.00",//用戶總權益(USDT)
        "estimate_CNY":"0.00"//用戶總權益(CNY)
        "balances":[
            {
                "coin":"BTC",//幣種
                "balance":"8.00000000",//可用餘額
                "positionMargin":"0.00635670",//倉位保證金
                "orderMargin":"0.00000000",//委託保證金
                "unrlzPnl":"0.00031774",//未實現盈虧
                "total":"8.00667445",//該幣種的總估值
                "estimate_BTC":"8.00667445",//該幣種的總估值(BTC)
                "estimate_USDT":"0.00",//該幣種的總估值(USDT)
                "estimate_CNY":"0.00"//該幣種的總估值(CNY)
            },
            ...
        ]
    },
    "time":1533035297,
    "microtime":"0.41892000 1533035297",
    "source":"api"
}

results matching ""

    No results matching ""