get
https://api.liquiditytech.com/api/v1/trading/portfolio/assets
Description
Retrieve the per-asset balance details for the current RapidX main or sub portfolio.
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
RapidX API key with read-only permission is sufficient. No trading / write permission is required.
The API key determines which portfolio (main or sub) the assets are returned for. You cannot use this endpoint to query other portfolios.
Rate Limit
20 requests per 1 second
Request
All parameters are optional. If omitted, the system will return all supported exchanges for the current portfolio, paginated.
| Field | Type | Necessary | Description |
|---|---|---|---|
| exchangeType | String | N | Filter by exchange / venue, e.g. BINANCE, OKX, EDX. If omitted, return assets across all exchanges bound to this portfolio. |
| page | Integer | N | Page number, starting from 1. Default is 1. |
| pageSize | Integer | N | Number of records per page. Default is 1000. |
Response
Top-level
| Field | Type | Description |
|---|---|---|
| code | Integer | Business status code. 200000 indicates success. |
| message | String | Text message for the response. |
| data | Object | Pagination information and asset list. |
Data Object
| Field | Type | Description |
|---|---|---|
| page | Integer | Current page index (same as pageNum), starting from 1. |
| pageSize | Integer | Page size used for this query. |
| pageNum | Integer | Alias for current page index. |
| totalSize | Integer | Total number of records matching the filters. |
| list | Array | List of asset records. Each element represents one coin on one exchange. |
Asset Record (list[])
| Field | Type | Description |
|---|---|---|
| portfolioId | String | ID of the RapidX portfolio (main or sub) to which this asset belongs. |
| coin | String | Asset symbol, e.g. USDT, BTC. |
| exchangeType | String | Exchange / venue where the asset is held, e.g. BINANCE, OKX, EDX. |
| 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). |
| debt | String | Debt amount of this asset (for margin environments). 0 if no borrowing. |
| equity | String | Asset equity in units of the asset itself. |
| createAt | String | Record creation time as Unix timestamp in milliseconds. |
| updateAt | String | Last update time as Unix timestamp in milliseconds. |
| borrow | String | Currently borrowed quantity of this asset (if supported by the venue/account type). |
| overdraw | String | Overdrawn amount (if the portfolio supports overdraw / negative balance logic). Usually 0 in normal cases. |
| indexPrice | String | Reference index price for this asset (typically in USDT or quote currency), used for valuation and margin calculations. |
| marginValue | String | Margin value contributed by this asset, usually equity * indexPrice adjusted for margin haircuts, expressed in the risk base currency (e.g. USDT). |
| virtualBorrow | String | Synthetic / virtual borrow amount used by the risk engine, if any. Normally 0 when not applicable. |
| upnl | String | Unrealized P&L associated with this asset (if the venue / account type maps it at asset level). 0 when not applicable. |
| 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. |
| maxTransferable | String | Maximum quantity of this asset that can be safely withdrawn / transferred out, considering margin requirements and risk limits. |
| equityValue | String | Asset equity value converted into the risk base currency (e.g. USDT), typically equity * indexPrice. |