Get Portfolio Overview

GET https://api.liquiditytech.com/api/v1/trading/account

Rate Limit: 2 requests per 1s.

Permission: Accessible by Main or Sub Trading Portfolio API keys with read permission.

Returns the margin & risk overview of your trading portfolio on each connected exchange (e.g. BINANCE, OKX, EDX).

Each object in data[] represents the same portfolio on one venue.

Request Parameters

This endpoint does not require any request parameters.

Response Fields

Field	Type	Description
portfolioId	String	trading portfolio ID to which this account view belongs.
exchangeType	String	RapidX Venue / exchange of this trading account, e.g. BINANCE, OKX, EDX.
equity	String	Total account equity on this venue, valued in USDT-equivalent (including cash balance and P&L).
maintainMargin	String	Maintenance margin requirement for all open positions on this venue.
positionValue	String	Notional value of all open positions on this venue.
uniMMR	String	Unified maintenance margin rate / internal risk metric. Higher value means higher margin requirement.
riskRatio	String	Risk ratio of this account (0–1 or 0–100% depending on UI), used for risk display and liquidation checks.
accountStatus	String	Trading account status, e.g. NORMAL.
marginValue	String	Total margin balance on this venue (after conversion to the unified margin currency).
frozenMargin	String	Margin currently locked (e.g. for open orders or positions) and not available for new trades or withdrawal.
perpMargin	String	Margin allocated specifically to perpetual contracts.
debtMargin	String	Borrowed margin or negative balance amount (if any).
openLossMargin	String	Margin portion reserved to cover current open losses.
validMargin	String	Effective margin after deducting open loss, used for risk and liquidation calculations.
availableMargin	String	Margin available for opening new positions or for withdrawal.
upnl	String	Unrealized P&L (profit and loss) on this venue.
positionMode	String	Position mode on this venue, e.g. NET (one-way) or BOTH (dual-side) depending on exchange settings.

Example Response

JSON

{
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "portfolioId": "17xxxxxxxxxxxxxx",
      "exchangeType": "BINANCE",
      "equity": "5685978.07787916",
      "maintainMargin": "164182.02640801",
      "positionValue": "3465349.06217066",
      "uniMMR": "28.4139281239",
      "riskRatio": "0.0352",
      "accountStatus": "NORMAL",
      "marginValue": "4666269.16976568",
      "frozenMargin": "482754.35903806",
      "perpMargin": "482754.35903806",
      "debtMargin": "0",
      "openLossMargin": "1212.87217175",
      "validMargin": "4665056.29759393",
      "availableMargin": "4182301.93855587",
      "upnl": "4654259.07370681",
      "positionMode": "NET"
    }
  ]
}