查詢抵押品信息

獲取當前統一保證金賬戶的抵押品信息，包括借貸利率，可藉貸金額以及抵押品折算率，是否可抵押作為保證金等信息

HTTP 請求

GET /v5/account/collateral-info

請求參數

參數	是否必需	類型	說明
currency	false	string	目前所有抵押品的資產幣種

響應參數

參數	類型	說明
list	array	Object
> currency	string	目前所有抵押品的資產幣種
> hourlyBorrowRate	string	每小時藉款利率
> maxBorrowingAmount	string	最大可藉貸額度. 該值由母子帳號共享
> freeBorrowingLimit	string	免息借款額上限 僅合約浮虧時產生的借款擁有免息額度 槓桿交易的借貸總是產生利息
> freeBorrowAmount	string	借款總額中免息部分的借款金額
> borrowAmount	string	已用借貸額度
> otherBorrowAmount	string	其他帳戶的已借貸總額(同一個母帳戶下)
> availableToBorrow	string	用戶剩餘可藉額度. 該值由母子帳號共享
> borrowable	boolean	是否是可藉貸的幣種, true: 是. false: 否
> freeBorrowingAmount	string	廢棄字段, 總是返回空字符串, 請參考freeBorrowingLimit
> borrowUsageRate	string	借貸資金使用率: 母子帳戶加起來的borrowAmount/maxBorrowingAmount. 這是一個真實值, 0.5则表示50%
> marginCollateral	boolean	是否可作為保證金抵押幣種(平台維度), true: 是. false: 否 當marginCollateral=false時, 則collateralSwitch無意義
> collateralSwitch	boolean	用戶是否開啟保證金幣種抵押(用戶維度), true: 是. false: 否 僅當marginCollateral=true時, 才能主動選擇開關抵押
> collateralRatio	string	由於新的階梯價值率邏輯, 該字段從2025年2月19日開始不再準確。請使用查詢階梯價值率

---

請求示例

HTTP

GET /v5/account/collateral-info?currency=BTC HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672127952719
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.get_collateral_info(
    currency="BTC",
))

Node.js

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

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

client
    .getCollateralInfo('BTC')
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "availableToBorrow": "3",
                "freeBorrowingAmount": "",
                "freeBorrowAmount": "0",
                "maxBorrowingAmount": "3",
                "hourlyBorrowRate": "0.00000147",
                "borrowUsageRate": "0",
                "collateralSwitch": true,
                "borrowAmount": "0",
                "borrowable": true,
                "currency": "BTC",
                "otherBorrowAmount": "0",
                "marginCollateral": true,
                "freeBorrowingLimit": "0",
                "collateralRatio": "0.95"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1691565901952
}