Query Loan Info

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Description

Retrieves real-time borrowing status, LTV risk levels, net margin metrics, and per-currency loan balances for the current portfolio across all connected exchanges.

Permission: Read-only API key required.

Rate Limit: 20 requests per second.

Request

This endpoint does not require any request parameters.

Response

data.accounts[]** :**

FieldTypeDescription
exchangeStringExchange name, e.g., BINANCE, OKX.
netMarginValueStringNet margin value
netValidMarginStringnetMarginValue-openLossMargin
netAvailableMarginStringnetValidMargin-frozenMargin
loanMarginStringΣ loan × indexPrice / loanLeverage
loanMaintenanceMarginStringΣ loan × indexPrice × loanMMR
ltvStringLTV = totalLoanValue / VaildMargin, returns "0" when no loan is outstanding.
accountStatusStringe.g., NORMAL / MARGIN_CALL / CANCEL_OPEN / CANCEL_ALL / LIQUIDATING / TAKEOVER / LTV_WARNING / LTV_CANCEL_OPEN / LTV_RISK_CONTROL / LTV_INSOLVENT
coins[]ArrayBorrowed currency details

coins[]**:**

FieldTypeDescription
coinStringCurrency, e.g., USDT, BTC.
loanStringCurrent borrowed amount for this currency.
loanMmrStringMaintenance margin rate for the borrowed asset.
loanLeverageIntegerBorrowing leverage multiplier.
loanValueStringloan × indexPrice
netEquityStringAsset equity minus loan.
netEquityValueStringnetEquity × indexPrice
netMarginValueStringnetEquityValue × discountRate
portfolioMaxLoanCoinStringMaximum borrowable amount for this currency.

Example Response

{
  "code": 200000,
  "message": "Success",
  "data": {
    "portfolioId": 2010936328078657,
    "userId": 100252,
    "accounts": [
      {
        "exchange": "BINANCE",
        "netMarginValue": "69.73",
        "netValidMargin": "69.73",
        "netAvailableMargin": "69.73",
        "loanMargin": "39.02",
        "loanMaintenanceMargin": "1.95",
        "ltv": "0.362",
        "accountStatus": "NORMAL",
        "coins": [
          {
            "coin": "USDT",
            "loan": "39.02",
            "loanLeverage": 1,
            "loanMmr": "0.05",
            "loanValue": "39.02",
            "netEquity": "-39.02",
            "netEquityValue": "-39.02",
            "netMarginValue": "-39.02",
            "portfolioMaxLoanCoin": "0"
          },
          {
            "coin": "BTC",
            "loan": "0",
            "loanLeverage": 1,
            "loanMmr": "0.05",
            "loanValue": "0",
            "netEquity": "0.001523",
            "netEquityValue": "100.5",
            "netMarginValue": "98.05",
            "portfolioMaxLoanCoin": "100"
          }
        ]
      }
    ]
  }
}
Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json