Sign in

v1

latestOpenAPI 3.0.32026-07-1482226.1 KB
Account Data

/account/transactions

Retrieves the user's transaction history (any change in balance).

get/api/v1/account/transactions

Query parameters

typesTransactionType[]

Optional query parameter to filter transactions by type.

assetSymbolstring

Optional query parameter to filter transactions by asset bank address.

startTimeAtMillisinteger

Start time in milliseconds. Defaults to 7 days ago if not specified.

endTimeAtMillisinteger

End time in milliseconds. Defaults to now if not specified. Must be greater than start time and must be less than 7 days apart.

limitinteger

Default 500; max 1000.

pageinteger

The page number to retrieve in a paginated response.

Response

Successful response with transaction history details.

idstring required

Transaction ID.

symbolstring

Market address.

type'TRANSFER' | 'DEPOSIT' | 'WITHDRAW' | 'REALIZED_PNL' | 'FUNDING_FEE' | 'TRADING_FEE' | 'TRADING_GAS_FEE' | 'BONUS' | 'UNSPECIFIED' required

Transaction type (what caused the change in the asset balance).

amountE9string required

Amount in e9 format (positive or negative).

statusstring

Transaction status (SUCCESS, REJECTED).

assetSymbolstring required

Asset bank address.

tradeIdstring

Trade ID

executedAtMillisinteger required

Transaction timestamp in milliseconds since Unix epoch.

Example response

[
  {
    "id": "9689322392",
    "symbol": "0x123456789abcdef",
    "amountE9": "-1000000",
    "status": "SUCCESS",
    "executedAtMillis": 1569514978020
  }
]