get
https://api.connex.trade/api/v1/trading/portfolio/assets
Retrieve the per-asset balance details for the current ConneX main or sub portfolio.
Important
This endpoint returns, for each coin and exchange:
- Wallet-style balances:
balance,available,frozen,debt - Margin-related values:
marginValue,equity,equityValue,upnl,debtMargin,perpMargin,virtualBorrow,overdraw - Risk-related values: maxTransferable, indexPrice
The result is paginated, and each record corresponds to one asset on one exchange under the current portfolio.
Permission
- Primary API Key:
READ, retrieve asset details of current portfolio. - Sub-Portfolio API Key:
READ, retrieve asset details of current portfolio.
Rate Limit
- 20 requests per 1 second
Request
| Field name | Type | Necessary | Remarks |
|---|---|---|---|
| exchangeType | String | N | Exchange type(BINANCE、OKX) |
| page | Integer | N | Current page, default is 1 |
| pageSize | Integer | N | Page size, default 1000 |
Response
| Field | Type | Remark |
|---|---|---|
| portfolioId | String | Portfolio ID |
| coin | String | Coin |
| exchangeType | String | Exchange type(BINANCE、OKX) |
| balance | String | Total quantity of this asset in the portfolio on this exchange (including available + frozen + any debt-related offsets as per venue rules). |
| available | String | Quantity of this asset that is freely available for trading or transfer. |
| frozen | String | Quantity currently locked (e.g. in open orders, pending withdrawals, or other holds). |
| equity | String | The net quantity of a coin；equity = available + frozen + uPNL |
| overdraw | String | Overdrawn amount (if the portfolio supports overdraw / negative balance logic). Usually 0 in normal cases. |
| borrow | String | Currently borrowed quantity of this asset (if supported by the venue/account type). |
| debt | String | Debt amount of this asset (for margin environments). 0 if no borrowing. |
| indexPrice | String | Reference index price for this asset (typically in USDT or quote currency), used for valuation and margin calculations. |
| marginValue | String | Asset margin value；marginValue=equity × indexPrice × discount ratio |
| virtualBorrow | String | Virtual borrow Vitual borrow contains coins borrowing for opening contract positions. |
| debtMargin | String | Margin requirement or value associated specifically with the debt portion of this asset. |
| perpMargin | String | Margin allocated from this asset for perpetual / derivatives positions. |
| createAt | String | Record creation time as Unix timestamp in milliseconds. |
| updateAt | String | Last update time as Unix timestamp in milliseconds. |
| maxTransferable | String | Maximum transfer amount；maxTransferable = max { min{available, avaliableMargin/(indexPrice x discountRatio), (validMargin - 3*maintainMargin)/(indexPrice x discountRatio)), 0} |
| upnl | String | Unrealized Profit and Loss |