Get Asset Transaction History

Returns visible deposit, withdrawal and transfer history, with exact order lookup and pagination.

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

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 typeCan callVisible records
Main User LevelYesOrders under the main user, including those initiated by sub-users and Sub Portfolio keys.
Sub-user LevelYesRecords involving currently assigned DMA sub-accounts or RapidX Sub Portfolios, created after the current assignment took effect.
Dedicated Sub Portfolio LevelYesOrders whose from or to involves that Portfolio.
Exchange-native keyNoUse 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

ModeBehavior
orderId suppliedExact 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 orderIdExact-match lookup across visible orders, with pagination. The identifier is not globally unique across initiators, so multiple records may match.
Neither suppliedPaginated 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

InputBehavior
Omit page / pageSizeUse 1 / 20.
Zero or negative page / pageSizeUse the corresponding default.
Explicitly empty or invalid integer formatReturn 1000, identifying the field.
pageSize > 100Return 100400. Maximum page size is 100.
Page beyond the last resultReturn list=[] and retain the matching totalSize.

Response fields

FieldTypeDescription
codeinteger200 for a successful query. It is not the execution status of an order.
messagestringQuery result message.
data.pageintegerEffective page number.
data.pageSizeintegerEffective page size; 1 for an orderId lookup.
data.totalSizeintegerMatching visible record count across all pages.
data.listarrayRecords with the fields below. No separate detail endpoint is required.

Order records

FieldTypeDescription
orderIdstringSystem order identifier.
clientOrderIdstring or nullCustomer-supplied identifier; null when absent.
typestringDEPOSIT, WITHDRAW or TRANSFER.
statusstringOrder execution status, such as PENDING, SUCCESS or FAIL.
currencystringCurrency symbol.
currencyDetailsobjectCurrency metadata: id, iconUrl, currencyName, slug, referenceAssetId, multiplier. See Get Currency Information.
networkstring or nullNetwork code, or an empty string / null when absent. Do not use this field alone to determine whether a transfer was Rapid.
rapidTransferbooleanWhether the order used Rapid Transfer.
amountstringOrder amount in units of currency, as a decimal string.
feestring or nullFee 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.
feeCurrencystring or nullFee currency, or "" / null when absent.
txHashstring or nullOn-chain transaction hash, an off-chain transfer reference, or null.
txHashStandbystring or nullSecondary transaction reference, when present; otherwise null.
depositDetailobject or nullDeposit address information; null for other record types.
withdrawDetailobject or nullWithdrawal address information; null for other record types.
fromobject or nullSource endpoint; null for deposits.
toobject or nullDestination endpoint; null for withdrawals.
createdAtintegerOrder creation time in Unix milliseconds.
operatorobjectActual initiator and channel, described below.

Source and destination endpoints

The same structure applies to from and to.

FieldTypeDescription
ltpAccountTypestringAccount domain, including FUNDING, TRADING or LENDING in historical records.
primeTypestring or nullDMA or RAPIDX for Trading; otherwise may be null.
idstring or nullDMA account ID, Portfolio ID, or another endpoint identifier as applicable.
accountTypestring or nullWallet/account type or RapidX venue, such as SPOT, MARGIN_CROSS, BINANCE or OKX. See Account Types.
accountNamestring or nullPortfolio name. DMA accounts return null.
accountNotestring or nullDMA account or Portfolio note, when set.
portfolioTypestring or nullMAIN or SUB for Portfolios; null when not applicable.
venuestring or nullVenue, such as RAPIDX, BINANCE, OKX or LTP; may be empty when absent.
venueIconUrlstring or nullVenue icon URL; may be empty when absent.

Operator

FieldTypeDescription
idstringUser UID for MAIN_USER / SUB_USER, or Portfolio ID for SUB_PORTFOLIO. Not an internal user ID.
typestringMAIN_USER, SUB_USER or SUB_PORTFOLIO.
namestring or nullInitiator's display name.
channelstringInitiation 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.

CodeMeaning
1000Invalid parameter format, including empty/non-integer pagination or an invalid timestamp format.
100400Invalid parameter value, such as an unsupported type/status or pageSize greater than 100.
400004startTime must be earlier than endTime.
400005startTime must not be in the future.
403080The specified order does not exist or is outside the key's visible scope.
2000Signature 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.

Query Params
string

Optional exact system order ID. Overrides clientOrderId and pagination; returns one list entry or 403080.

string

Exact customer identifier within visible records. Multiple initiators can use the same value.

string
enum

Optional transaction type. Case-insensitive.

Allowed:
string

Optional execution status filter, such as SUCCESS, FAIL or PENDING. Case-insensitive.

string

Optional exact currency symbol; case-insensitive.

int64

Optional start time in Unix milliseconds; must precede endTime and must not be in the future.

int64

Optional end time in Unix milliseconds.

integer
Defaults to 1

One-based page. Omitted, zero or negative uses 1. Empty or non-integer returns 1000. Ignored for orderId lookup.

integer
≤ 100
Defaults to 20

Omitted, zero or negative uses 20. Maximum 100; larger values return 100400. Empty/non-integer returns 1000. Ignored for orderId lookup.

Headers
string
required

Current Unix timestamp in seconds. Use the same nonce when signing.

string
required

HMAC-SHA256 hex signature. See Authentication.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json