Returns DeFi balances by currency and network.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns the DeFi asset view for on-chain and DEX wallets that are in the API key's scope. The response groups holdings by currency, then provides an allocation by network for every returned currency.
This is the appropriate endpoint for showing DeFi wallet balances. It is not an instruction to move funds on-chain, and it does not by itself establish that a network or address is currently operational for a transfer.
Rate limit: 10 requests per minute per API key. This endpoint is not paginated.
API key access
This is a read-only LTP Open API endpoint. READ permission is sufficient; TRADE, TRANSFER and WITHDRAW are not required.
| API key type | Can call | Returned scope |
|---|---|---|
| Main User Level API key | Yes | DeFi assets in the main user's API-key scope. |
| Sub-user Level API key | Yes | Only DeFi assets owned by or assigned to that Sub-user. An empty result is valid. |
| Portfolio Level API key (a dedicated RapidX Sub Portfolio key) | No | This user-level asset service does not support Portfolio-scoped API keys. |
| Exchange-native API key | No | This endpoint accepts signed LTP Open API keys only. |
An unsupported API key level is rejected before asset data is read, normally with 2003.
Response shape and scope
The response is a two-level currency → network hierarchy:
data.list[]contains one aggregate row for each currency.data.list[].networks[]divides that same currency balance by chain/network.
The currency row and its nested rows must not be added together. Use the currency row for a currency-total view and a nested row for a chain-specific view.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
quoteCurrency | string | No | Currency used to value every returned row. Accepts USD, BTC or USDT; defaults to USD. It does not change the underlying on-chain balance. |
currency | string | No | Optional currency-symbol filter, such as USDT. Omit it to return every currency in scope. A symbol without a matching holding returns a successful empty list. |
Response fields
data contains totalValue, quoteCurrency, exchangeRate, updatedAt and list. All quantity and valuation fields are decimal strings; preserve precision by using a decimal type or the original string.
| Field | Type | Description |
|---|---|---|
code | integer | Application result code. 200 indicates success. |
message | string | Result message. |
data.totalValue | string | Total DeFi valuation in data.quoteCurrency for this snapshot. |
data.quoteCurrency | string | Valuation currency actually used in this payload. |
data.exchangeRate | string | USD value of one unit of data.quoteCurrency; "1" for USD. |
data.updatedAt | integer | Snapshot time as a Unix timestamp in milliseconds. |
data.list | array | Currency-level DeFi asset rows. An empty list is a successful result. |
Each currency entry contains:
| Field | Type | Description |
|---|---|---|
quoteCurrency | string | Valuation currency for this currency row. |
totalValue | string | Value of this currency in quoteCurrency. |
changePctToday | string | Daily percentage change; empty string when unavailable. |
currency | string | LTP currency symbol, for example USDT. |
balance | string | Total DeFi balance for this currency across the nested network rows. |
equity | string | DeFi equity for this currency. |
available | string | Amount currently available for use in the applicable DeFi account context. |
frozen | string | Amount temporarily reserved or unavailable. |
withdrawable | string | Amount currently eligible to enter a withdrawal workflow, subject to subsequent asset/network/operation checks. |
currencyDetails | object | Currency metadata for display and reference. |
networks | array | Network allocation for this currency. |
Currency metadata
Field in currencyDetails | Type | Description |
|---|---|---|
id | integer | LTP reference identifier for the currency. It can be 0 if no catalogue entry is available. |
iconUrl | string | Currency icon URL for display. |
currencyName | string | Full display name. |
slug | string | Display-oriented currency slug. |
referenceAssetId | integer | Identifier of the reference asset; 0 if not configured. |
multiplier | integer | Conversion multiplier between this currency and its reference asset; 0 if not configured. |
Each networks[] row contains the same valuation and balance concepts for one network:
| Field | Type | Description |
|---|---|---|
network | string | LTP network code, for example ERC20 or SOL. |
quoteCurrency, totalValue | string | Valuation currency and value for this network allocation. |
balance, equity, available, frozen, withdrawable | string | Network-specific versions of the currency-level balance fields. |
networkDetails | object | Network metadata, described below. |
Field in networkDetails | Type | Description |
|---|---|---|
networkName | string | Human-readable network name. |
iconUrl | string | Network icon URL for display. |
referenceAssetId | integer | Identifier of the reference asset; 0 if not configured. |
explorerUrlTx | string | Block-explorer transaction URL prefix, when supplied. |
explorerUrlAddress | string or null | Block-explorer address URL prefix; null when unavailable. |
memoNeeded | boolean | Whether a memo/tag is required in a deposit or withdrawal flow on this network. |
addressRegex | string | Syntactic address-validation expression. It cannot prove address ownership or transfer eligibility. |
Interpretation notes
- A zero-balance network may still be listed. This allows a client to display the asset's network metadata without treating zero as an error.
- Use the returned network codes when matching balances with a transfer workflow. Do not infer a chain from a currency symbol alone.
- Asset visibility does not guarantee that every DeFi balance can be immediately transferred. Operational support is checked separately by transfer-related APIs.
Relevant errors
| Code | When it occurs | What to do |
|---|---|---|
404001 | quoteCurrency is not supported. | Use USD, BTC or USDT. |
404006 | DeFi asset data is temporarily unavailable. | Retry after a short delay. |
2000 | Signature, API key or nonce verification fails. | Recreate the signed request with the exact query parameters and a seconds-based nonce. |
100429 | The API key exceeds the rate limit. | Back off before retrying. |
