Sign in
latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

External Wallet Access Mode

Get transaction history

Returns the user's transaction history with date range, type, currency, direction, and amount filters plus cursor pagination. Timestamps are Unix seconds.

post/api/v2/transactions

Headers

tokenIdstring required

The user's URID (NFT token id).

networkstring required

Network identifier: 5000 for mainnet, 5003 for testnet.

signstring required

Signature generated by the user's wallet key (EIP-191).

hashstring required

SHA3/Keccak256 hash of the original request payload.

deadlinestring required

Signature expiry: server timestamp plus a validity window (max 20 minutes).

Request body

pageSizeinteger

Page size (default 50).

fromTimestampinteger

Start timestamp (Unix seconds).

toTimestampinteger

End timestamp (Unix seconds).

typestring

Single transaction type, e.g. P2P, FRX, CTU, CRD, CDP. Mutually exclusive with transactionTypes.

transactionTypesstring[]

Multiple transaction-type filter. Mutually exclusive with type.

currencysstring[]

Currency filter, e.g. EUR, USD, CHF.

directionstring

IN, OUT, or ALL.

minAmountstring

Minimum amount filter.

maxAmountstring

Maximum amount filter.

statusstring

Transaction status filter.

chainIdstring

CAIP-2 chain ID, e.g. eip155:5000.

tokenSymbolstring

Token symbol, e.g. USDC.

cursorTimestampinteger

Forward-pagination cursor timestamp.

cursorIdinteger

Forward-pagination cursor ID.

idinteger

Query a single transaction by record ID. Mutually exclusive with txHash.

txHashstring

Query a single transaction by hash. Mutually exclusive with id.

Response

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

retCodeinteger required

0 on success; non-zero indicates failure.

retMsgstring required

Human-readable message; error details when retCode is non-zero.

{"stackTrail":"components:schemas:EwaEnvelope:properties:result","oasType":"schema","type":"unknown","description":"Business payload. Shape depends on the endpoint; some endpoints return it as a JSON-encoded string."}
timeNowinteger

Server timestamp in milliseconds.