Get Portfolio Asset Details

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

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.

API key access

Requires a signed LTP Open API request with READ permission.

API key typeCan callScope
Main User Level API key (also the main Portfolio key)YesThe Main Portfolio only.
Sub-user Level API keyNoNot supported by this endpoint.
Dedicated Sub Portfolio API keyYesThe Portfolio associated with this key only.

The API key determines the Portfolio. This endpoint has no parameter for selecting another Portfolio; use Get All Portfolio Assets with a Main User Level key for a cross-Portfolio view.

Rate Limit: 20 requests per 1 second.

Request Parameters

All parameters are optional. If omitted, the system will return all supported exchanges for the current portfolio, paginated.

FieldTypeNecessaryDescription
exchangeTypeStringNFilter by exchange / venue, e.g. BINANCE, OKX, EDX. If omitted, return assets across all exchanges bound to this portfolio.
pageIntegerNPage number, starting from 1. Default is 1.
pageSizeIntegerNNumber of records per page. Default is 1000.

Response Fields

Top-level:

FieldTypeDescription
codeIntegerBusiness status code. 200000 indicates success.
messageStringText message for the response.
dataObjectPagination information and asset list.

Data object:

FieldTypeDescription
pageIntegerCurrent page index, starting from 1.
pageSizeIntegerPage size used for this query.
pageNumIntegerTotal number of pages.
totalSizeIntegerTotal number of records matching the filters.
listArrayList of asset records. Each element represents one coin on one exchange.

When no asset records match, the request succeeds with data.list=[], data.totalSize=0 and data.pageNum=0.

Asset record (data.list[]):

FieldTypeDescription
portfolioIdStringID of the RapidX portfolio (main or sub) to which this asset belongs.
coinStringAsset symbol, e.g. USDT, BTC.
exchangeTypeStringExchange / venue where the asset is held, e.g. BINANCE, OKX, EDX.
balanceStringTotal quantity of this asset in the portfolio on this exchange (including available + frozen + any debt-related offsets as per venue rules).
availableStringQuantity of this asset that is freely available for trading or transfer.
frozenStringQuantity currently locked (e.g. in open orders, pending withdrawals, or other holds).
debtStringDebt amount of this asset (for margin environments). 0 if no borrowing.
equityStringAsset equity in units of the asset itself.
createAtStringRecord creation time as Unix timestamp in milliseconds.
updateAtStringLast update time as Unix timestamp in milliseconds.
borrowStringCurrently borrowed quantity of this asset (if supported by the venue/account type).
overdrawStringOverdrawn amount (if the portfolio supports overdraw / negative balance logic). Usually 0 in normal cases.
indexPriceStringReference index price for this asset (typically in USDT or quote currency), used for valuation and margin calculations.
marginValueStringMargin value contributed by this asset, usually equity * indexPrice adjusted for margin haircuts, expressed in the risk base currency (e.g. USDT).
virtualBorrowStringSynthetic / virtual borrow amount used by the risk engine, if any. Normally 0 when not applicable.
upnlStringUnrealized P&L associated with this asset (if the venue / account type maps it at asset level). 0 when not applicable.
debtMarginStringMargin requirement or value associated specifically with the debt portion of this asset.
perpMarginStringMargin allocated from this asset for perpetual / derivatives positions.
maxTransferableStringMaximum quantity of this asset that can be safely withdrawn / transferred out, considering margin requirements and risk limits.
equityValueStringAsset equity value converted into the risk base currency (e.g. USDT), typically equity * indexPrice.

Example Response

{
  "code": 200000,
  "message": "Success",
  "data": {
    "page": 1,
    "pageSize": 1000,
    "pageNum": 1,
    "totalSize": 1,
    "list": [
      {
        "portfolioId": "17xxxxxxxxxxxxxx",
        "coin": "USDT",
        "exchangeType": "BINANCE",
        "balance": "33.970877268901446313",
        "available": "33.970877268901446313",
        "frozen": "0",
        "debt": "0",
        "equity": "33.970877268901446313",
        "createAt": "1776008971034",
        "updateAt": "1776008971034",
        "borrow": "0",
        "overdraw": "0",
        "indexPrice": "1",
        "marginValue": "33.9674801811745561683687",
        "virtualBorrow": "0",
        "upnl": "0",
        "debtMargin": "0",
        "perpMargin": "0",
        "maxTransferable": "33.970877268901446313",
        "equityValue": "33.970877268901446313"
      }
    ]
  }
}

All asset-record fields, including portfolioId, decimal amounts and millisecond timestamps, are returned as strings. A Sub-user Level key returns application code 100003 (invalid user type). Check the application code even when HTTP status is 200. See Error codes.

Query Params
string
string
Defaults to 1
string
Defaults to 1000
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json