跳到主要内容

查询风险率

描述​

查询风险率

  1. 若未传入 riskUnitId 参数，则调用接口的账号须为机构借贷专属单元账号。
  2. 若已传入该参数，则参数中所携带的 UID 必须属于机构借贷专属单元账号，且调用接口的账号须为主账户。

HTTP请求​

  • GET /api/v3/ins-loan/ltv-convert
  • 限频规则: 3次/秒/UID
  • 需要统一账户管理只读/读写权限
请求示例
curl "https://api.bitget.com/api/v3/ins-loan/ltv-convert?riskUnitId=xxxxxxxx" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json"

请求参数​

参数名参数类型是否必须描述
riskUnitIdString否风险单元内，借贷专属子账户UID
返回示例
{
  "code": "00000",
  "msg": "success",
  "requestTime": 1711697588556,
  "data": {
    "ltv": "0.6667",
    "subAccountUids": [
      "xxxxxxxxxx",
      "xxxxxxxxxx"
    ],
    "unpaidUsdtAmount": "1.12",
    "usdtBalance": "1223",
    "unpaidInfo": [
      {
        "coin": "USDT",
        "unpaidQty": "12",
        "unpaidInterest": "1.2"
      }
    ],
    "balanceInfo": [
      {
        "coin": "USDT",
        "price": "12",
        "amount": "1.2",
        "convertedUsdtAmount": "12"
      }
    ]
  }
}

返回参数​

返回字段参数类型字段说明
ltvString风险率, 0.6667
subAccountUidsArray绑定机构借贷产品的风险单元的子账号UID，包括借贷专属子账户
unpaidUsdtAmountString总负债 (USDT)
unpaidInfoArray负债明细
> coinString币种
> unpaidQtyString未还本金，小数点后8位，截位取值
> unpaidInterestString未还利息，小数点后8位，截位取值
usdtBalanceString总资产(保证金币种资产折算为USDT资产)，小数点后8位，截位取值
balanceInfoArray资产明细
> coinString保证金币种
> priceString保证金币种价格
> amountString保证金权益，小数点后8位，截位取值
> convertedUsdtAmountString保证金折算金额(USDT)小数点后8位，截位取值