Returns the valuation overview for Funding, Trading and DeFi.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Use this as the entry point for an account-level asset dashboard or statement summary. It returns the valuation overview for the Funding, Trading and DeFi domains accessible to the API key.
It is an overview only: it does not return currency balances, individual Trading accounts, or wallet/venue allocation. Use the relevant domain endpoint to drill into those details.
Rate limit: 10 requests per minute per API key.
API key access
This is a read-only LTP Open API endpoint. A valid API key with READ permission is sufficient; TRADE, TRANSFER and WITHDRAW are not required.
| API key type | Can call | Returned scope |
|---|---|---|
| Main User Level API key | Yes | The main user's Funding, Trading and DeFi data in the key's scope. |
| Sub-user Level API key | Yes | Only assets owned by or assigned to that Sub-user. Funding is not a Sub-user account and is not returned for the Sub-user. |
| 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, not an exchange's own API key. |
An unsupported API key level is rejected before asset data is read, normally with 2003. A valid call with no assets in scope returns an ordinary successful empty result instead.
Scope and important behaviour
- Earn asset endpoints are coming soon and are not available in this release.
- The category list currently contains
FUNDING,TRADINGandDEFIonly. The absence of a category means that it is not returned by this endpoint; it is not a zero-valued placeholder. - All monetary values are decimal strings. Preserve them as strings or decimal values rather than converting them to binary floating-point numbers.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
quoteCurrency | string | No | Currency used for every valuation returned by this response. Accepts USD, BTC or USDT; defaults to USD. This parameter changes valuation units only, not the underlying balances. |
Response fields
| Field | Type | Description |
|---|---|---|
code | integer | Application result code. 200 means the request succeeded. Always inspect this field even if the HTTP response itself is successful. |
message | string | Result message. It is normally success when code is 200. |
data | object | Overview payload. It is omitted on an application error. |
data.totalValue | string | Total asset valuation in data.quoteCurrency. |
data.quoteCurrency | string | The valuation currency actually used in the response. It equals the supplied quoteCurrency, or USD when the parameter was omitted. |
data.exchangeRate | string | USD value of one unit of data.quoteCurrency. It is "1" for USD. For example, when the quote currency is BTC, it represents the USD value used for one BTC in this snapshot. |
data.updatedAt | integer | Asset valuation snapshot time as a Unix timestamp in milliseconds. It is not the request time and should be used when showing data freshness. |
data.ltpAccountTypes | array | Returned domain-level valuation entries. Each entry identifies one returned account domain. |
data.ltpAccountTypes[].ltpAccountType | string | Domain represented by this entry: FUNDING for the funding wallet, TRADING for DMA and RapidX Trading assets, or DEFI for on-chain/DEX assets. |
data.ltpAccountTypes[].value | string | Valuation for that account domain in data.quoteCurrency. |
How to use this response
Use the overview to populate a high-level summary, then drill down only when the user opens a domain:
| Need | Use |
|---|---|
| Funding wallet balances and chain allocation | Get Funding Account Assets |
| Trading accounts / Portfolios and their values | Get Trading Account List |
| Currency-level Trading total or allocation | Get Trading Asset Summary or Get Trading Asset Distribution |
| On-chain / DEX wallet balances | Get DeFi Account Assets |
Relevant errors
| Code | When it occurs | What to do |
|---|---|---|
404001 | quoteCurrency is not USD, BTC or USDT. | Send one of the supported uppercase currency values. |
2000 | API key, signature or nonce verification fails. | Recreate the signature using the exact query parameters and a seconds-based nonce. |
2003 | The API key type is not permitted for this endpoint. | Use a Main User Level or Sub-user Level LTP API key. |
100429 | The API key exceeds the endpoint rate limit. | Back off and retry after the rate-limit window. |