Returns visible deposit, withdrawal and transfer history, with exact order lookup and pagination.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns deposit, withdrawal and transfer records in one paginated list, ordered by creation time descending. Query a single order, match a customer order identifier, or combine type, status, currency and time filters.
Rate limit: 10 requests per 10 seconds per API key.
API key access
Requires a signed request with READ permission. See Authentication.
| API key type | Can call | Visible records |
|---|---|---|
| Main User Level | Yes | Orders under the main user, including those initiated by sub-users and Sub Portfolio keys. |
| Sub-user Level | Yes | Records involving currently assigned DMA sub-accounts or RapidX Sub Portfolios, created after the current assignment took effect. |
| Dedicated Sub Portfolio Level | Yes | Orders whose from or to involves that Portfolio. |
| Exchange-native key | No | Use an LTP API key. |
For sub-users, current access and the assignment time both matter. Records from before the current assignment are not visible, and removing the assignment removes access to that resource's records. Reassigning an account to another sub-user does not expose the previous user's history. These rules apply to both DMA and RapidX resources.
Records are not restricted to orders initiated by the calling key. operator identifies the actual initiator, which can differ from the owner of the account shown in from or to.
Query modes
| Mode | Behavior |
|---|---|
orderId supplied | Exact single-order lookup. clientOrderId, page and pageSize are ignored. The response remains data.list, with page=1, pageSize=1, totalSize=1. A missing or inaccessible order returns 403080. |
clientOrderId supplied without orderId | Exact-match lookup across visible orders, with pagination. The identifier is not globally unique across initiators, so multiple records may match. |
| Neither supplied | Paginated list with optional type, status, currency, startTime and endTime filters. |
Use orderId to identify a single system order. A query with no matching filters returns an empty list and totalSize=0; a nonexistent or inaccessible explicit orderId returns an error instead.
Transaction types are DEPOSIT, WITHDRAW and TRANSFER. SUCCESS indicates success and FAIL indicates failure; unfinished records can have statuses such as PENDING. Currency, type and status filters are case-insensitive. Time filters use Unix milliseconds; when both times are supplied, startTime must precede endTime.
Pagination
| Input | Behavior |
|---|---|
Omit page / pageSize | Use 1 / 20. |
Zero or negative page / pageSize | Use the corresponding default. |
| Explicitly empty or invalid integer format | Return 1000, identifying the field. |
pageSize > 100 | Return 100400. Maximum page size is 100. |
| Page beyond the last result | Return list=[] and retain the matching totalSize. |
Response fields
| Field | Type | Description |
|---|---|---|
code | integer | 200 for a successful query. It is not the execution status of an order. |
message | string | Query result message. |
data.page | integer | Effective page number. |
data.pageSize | integer | Effective page size; 1 for an orderId lookup. |
data.totalSize | integer | Matching visible record count across all pages. |
data.list | array | Records with the fields below. No separate detail endpoint is required. |
Order records
| Field | Type | Description |
|---|---|---|
orderId | string | System order identifier. |
clientOrderId | string or null | Customer-supplied identifier; null when absent. |
type | string | DEPOSIT, WITHDRAW or TRANSFER. |
status | string | Order execution status, such as PENDING, SUCCESS or FAIL. |
currency | string | Currency symbol. |
currencyDetails | object | Currency metadata: id, iconUrl, currencyName, slug, referenceAssetId, multiplier. See Get Currency Information. |
network | string or null | Network code, or an empty string / null when absent. Do not use this field alone to determine whether a transfer was Rapid. |
rapidTransfer | boolean | Whether the order used Rapid Transfer. |
amount | string | Order amount in units of currency, as a decimal string. |
fee | string or null | Fee in units of feeCurrency. Zero is a numeric string such as "0"; an unavailable fee can be "" or null. An empty value does not mean zero. |
feeCurrency | string or null | Fee currency, or "" / null when absent. |
txHash | string or null | On-chain transaction hash, an off-chain transfer reference, or null. |
txHashStandby | string or null | Secondary transaction reference, when present; otherwise null. |
depositDetail | object or null | Deposit address information; null for other record types. |
withdrawDetail | object or null | Withdrawal address information; null for other record types. |
from | object or null | Source endpoint; null for deposits. |
to | object or null | Destination endpoint; null for withdrawals. |
createdAt | integer | Order creation time in Unix milliseconds. |
operator | object | Actual initiator and channel, described below. |
Source and destination endpoints
The same structure applies to from and to.
| Field | Type | Description |
|---|---|---|
ltpAccountType | string | Account domain, including FUNDING, TRADING or LENDING in historical records. |
primeType | string or null | DMA or RAPIDX for Trading; otherwise may be null. |
id | string or null | DMA account ID, Portfolio ID, or another endpoint identifier as applicable. |
accountType | string or null | Wallet/account type or RapidX venue, such as SPOT, MARGIN_CROSS, BINANCE or OKX. See Account Types. |
accountName | string or null | Portfolio name. DMA accounts return null. |
accountNote | string or null | DMA account or Portfolio note, when set. |
portfolioType | string or null | MAIN or SUB for Portfolios; null when not applicable. |
venue | string or null | Venue, such as RAPIDX, BINANCE, OKX or LTP; may be empty when absent. |
venueIconUrl | string or null | Venue icon URL; may be empty when absent. |
Operator
| Field | Type | Description |
|---|---|---|
id | string | User UID for MAIN_USER / SUB_USER, or Portfolio ID for SUB_PORTFOLIO. Not an internal user ID. |
type | string | MAIN_USER, SUB_USER or SUB_PORTFOLIO. |
name | string or null | Initiator's display name. |
channel | string | Initiation channel, such as WEB, APP, API or INTERNAL. |
Address details
depositDetail contains address and addressTag. withdrawDetail contains address, addressTag and memo. addressTag is an address label, not the on-chain memo/tag. Withdrawal memo is a string, or empty / null when absent. Internal address-book IDs are not returned.
Error codes
Check JSON code even when HTTP status is 200. Common errors are described in Error Codes.
| Code | Meaning |
|---|---|
1000 | Invalid parameter format, including empty/non-integer pagination or an invalid timestamp format. |
100400 | Invalid parameter value, such as an unsupported type/status or pageSize greater than 100. |
400004 | startTime must be earlier than endTime. |
400005 | startTime must not be in the future. |
403080 | The specified order does not exist or is outside the key's visible scope. |
2000 | Signature verification failed. |
The response panel includes actual record structures for deposits, withdrawals and transfers, a full list page, a single-order lookup, and empty and error results. Example identities and addresses are fictional.
