Get DeFi Account Assets

Returns DeFi balances by currency and network.

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

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 typeCan callReturned scope
Main User Level API keyYesDeFi assets in the main user's API-key scope.
Sub-user Level API keyYesOnly 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)NoThis user-level asset service does not support Portfolio-scoped API keys.
Exchange-native API keyNoThis 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:

  1. data.list[] contains one aggregate row for each currency.
  2. 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

NameTypeRequiredDescription
quoteCurrencystringNoCurrency used to value every returned row. Accepts USD, BTC or USDT; defaults to USD. It does not change the underlying on-chain balance.
currencystringNoOptional 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.

FieldTypeDescription
codeintegerApplication result code. 200 indicates success.
messagestringResult message.
data.totalValuestringTotal DeFi valuation in data.quoteCurrency for this snapshot.
data.quoteCurrencystringValuation currency actually used in this payload.
data.exchangeRatestringUSD value of one unit of data.quoteCurrency; "1" for USD.
data.updatedAtintegerSnapshot time as a Unix timestamp in milliseconds.
data.listarrayCurrency-level DeFi asset rows. An empty list is a successful result.

Each currency entry contains:

FieldTypeDescription
quoteCurrencystringValuation currency for this currency row.
totalValuestringValue of this currency in quoteCurrency.
changePctTodaystringDaily percentage change; empty string when unavailable.
currencystringLTP currency symbol, for example USDT.
balancestringTotal DeFi balance for this currency across the nested network rows.
equitystringDeFi equity for this currency.
availablestringAmount currently available for use in the applicable DeFi account context.
frozenstringAmount temporarily reserved or unavailable.
withdrawablestringAmount currently eligible to enter a withdrawal workflow, subject to subsequent asset/network/operation checks.
currencyDetailsobjectCurrency metadata for display and reference.
networksarrayNetwork allocation for this currency.

Currency metadata

Field in currencyDetailsTypeDescription
idintegerLTP reference identifier for the currency. It can be 0 if no catalogue entry is available.
iconUrlstringCurrency icon URL for display.
currencyNamestringFull display name.
slugstringDisplay-oriented currency slug.
referenceAssetIdintegerIdentifier of the reference asset; 0 if not configured.
multiplierintegerConversion 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:

FieldTypeDescription
networkstringLTP network code, for example ERC20 or SOL.
quoteCurrency, totalValuestringValuation currency and value for this network allocation.
balance, equity, available, frozen, withdrawablestringNetwork-specific versions of the currency-level balance fields.
networkDetailsobjectNetwork metadata, described below.
Field in networkDetailsTypeDescription
networkNamestringHuman-readable network name.
iconUrlstringNetwork icon URL for display.
referenceAssetIdintegerIdentifier of the reference asset; 0 if not configured.
explorerUrlTxstringBlock-explorer transaction URL prefix, when supplied.
explorerUrlAddressstring or nullBlock-explorer address URL prefix; null when unavailable.
memoNeededbooleanWhether a memo/tag is required in a deposit or withdrawal flow on this network.
addressRegexstringSyntactic 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

CodeWhen it occursWhat to do
404001quoteCurrency is not supported.Use USD, BTC or USDT.
404006DeFi asset data is temporarily unavailable.Retry after a short delay.
2000Signature, API key or nonce verification fails.Recreate the signed request with the exact query parameters and a seconds-based nonce.
100429The API key exceeds the rate limit.Back off before retrying.
Query Params
string
enum

Valuation currency. Defaults to USD.

Allowed:
string

Currency symbol filter. Omit to return all currencies.

Response

Language
LoadingLoading…
Response
Choose an example:
application/json