Get LTV

Get your loan-to-value (LTV) ratio.

HTTP Request

GET /v5/ins-loan/ltv-convert

Request Parameters

None

Response Parameters

Parameter	Type	Comments
ltvInfo	array	Object
> ltv	string	Risk rate ltv is calculated in real-time If you have INS loan, it is highly recommended to query this data per second. The liquidation occurs when it reachs at 0.9 (90%)
> rst	string	Remaining liquidation time (UTC time in seconds). When it is not triggered, it is displayed as an empty string.
> parentUid	string	The designated Risk Unit Id that used to bind INS loan product
> subAccountUids	array	Bound user id
> unpaidAmount	string	Total debt(USDT)
> unpaidInfo	array	Debt details
>> token	string	coin
>> unpaidQty	string	Unpaid principle
>> unpaidInterest	string	Useless field, please ignore this for now
> balance	string	Total asset. (margin coins converted to USDT). Please read here to understand the calculation
> balanceInfo	array	Asset details
>> token	string	Margin coin
>> price	string	Margin coin price
>> qty	string	Margin coin quantity
>> convertedAmount	string	Margin conversion amount

Request Example

HTTP

GET /v5/ins-loan/ltv-convert HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1686638165351
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: XXXXX

Python

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'apikey',
  secret: 'apisecret',
});

client
  .getInstitutionalLendingLTVWithLadderConversionRate()
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

Response Example

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "ltvInfo": [
            {
                "ltv": "0.75",
                "rst": "",
                "parentUid": "xxxxx",
                "subAccountUids": [
                    "60568258"
                ],
                "unpaidAmount": "30",
                "unpaidInfo": [
                    {
                        "token": "USDT",
                        "unpaidQty": "30",
                        "unpaidInterest": "0"
                    }
                ],
                "balance": "40",
                "balanceInfo": [
                    {
                        "token": "USDT",
                        "price": "1",
                        "qty": "40",
                        "convertedAmount": "40"
                    }
                ]
            }
        ]
    },
    "retExtInfo": {},
    "time": 1686638166323
}