Get Margin Coin Info

tip

• When queried without an API key, this endpoint returns public margin data
• If your UID is bound with an OTC loan, then you can get your private margin data by calling with your API key
• If your UID is not bound with an OTC loan but you passed your API key, this endpoint returns public margin data

HTTP Request

GET /v5/ins-loan/ensure-tokens-convert

Request Parameters

Parameter	Required	Type	Comments
productId	false	string	Product ID. If not passed, returns all margin products. For spot, it returns coins with a convertRatio greater than 0.

Response Parameters

Parameter	Type	Comments
marginToken	array	Object
> productId	string	Product Id
> tokenInfo	array	Spot margin coin
>> token	string	Margin coin
>> convertRatioList	array	Margin coin convert ratio List
>>> ladder	string	ladder
>>> convertRatio	string	Margin coin convert ratio

Request Example

HTTP

GET /v5/ins-loan/ensure-tokens-convert HTTP/1.1
Host: api-testnet.bybit.com

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_margin_coin_info())

Node.js

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

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

client
  .getInstitutionalLendingMarginCoinInfoWithConversionRate({
    productId: '81',
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

Response Example

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "marginToken": [
            {
                "productId": "81",
                "tokenInfo": [
                    {
                        "token": "USDT",
                        "convertRatioList": [
                            {
                                "ladder": "0-500",
                                "convertRatio": "0.95"
                            },
                            {
                                "ladder": "500-1000",
                                "convertRatio": "0.9"
                            },
                            {
                                "ladder": "1000-2000",
                                "convertRatio": "0.8"
                            },
                            {
                                "ladder": "2000-4000",
                                "convertRatio": "0.7"
                            },
                            {
                                "ladder": "4000-99999999999",
                                "convertRatio": "0.6"
                            }
                        ]
                    }
                  ...
                ]
            },
            {
                "productId": "82",
                "tokenInfo": [
                    ...
                    {
                        "token": "USDT",
                        "convertRatioList": [
                            {
                                "ladder": "0-1000",
                                "convertRatio": "0.7"
                            },
                            {
                                "ladder": "1000-2000",
                                "convertRatio": "0.65"
                            },
                            {
                                "ladder": "2000-99999999999",
                                "convertRatio": "0.6"
                            }
                        ]
                    }
                ]
            },
            {
                "productId": "84",
                "tokenInfo": [
                    ...
                    {
                        "token": "BTC",
                        "convertRatioList": [
                            {
                                "ladder": "0-1000",
                                "convertRatio": "1"
                            },
                            {
                                "ladder": "1000-5000",
                                "convertRatio": "0.9"
                            },
                            {
                                "ladder": "5000-99999999999",
                                "convertRatio": "0.55"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "retExtInfo": {},
    "time": 1683276016497
}