ZEzerion
wallets

Get wallet transactions

Changed on

Returns a wallet's decoded transaction history, including transfers, approvals, fees and dapp context.

Solana limitation. NFT transactions are not supported for Solana addresses yet.

See also: Testnets (X-Env: testnet) · Filtering and the 2000-character URL limit · Resource IDs

get/v1/wallets/{address}/transactions/

Request

  • Base URL
    https://api.zerion.io
  • URL
    https://api.zerion.io/v1/wallets/{address}/transactions/
  • Auth
    HTTP basic

Path parameters

addressstring required

Address of the wallet. Must be a valid EVM or Solana address. Returns 400 if the address is not one Zerion tracks, such as a token contract, router or exchange hot wallet. Smart-contract wallets like Safe and ERC-4337 accounts are tracked as normal.

Query parameters

currency'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'

Denominated currency value of returned prices

afterstring nullable

This field is used for result pagination. You SHOULD NOT use this parameter directly. To get the next page of the results you should use links.next field. Omit it to return the first page.

sizeinteger

Set maximum number of items per a page in the pagination.

Pagination parameters

filter[search_query]string
Example:Trade

Full-text search query, 2 to 64 characters.

filter[operation_types]Type[]

Return only transactions of these types (comma-separated list). See the operation type schema for all values.

[
  "trade"
]
filter[asset_types]AssetType[]

Return only transactions that involve these asset types (comma-separated list).

[
  "fungible"
]
filter[chain_ids]string[]

Return only transactions from specified chains (comma-separated list). Only chains reporting supports_transactions in the flags of GET /v1/chains/ are accepted here. Naming a chain that fails that gate returns 400 rather than an empty result, with detail reading chain <id> does not support transactions (for example chain tron does not support transactions). A chain of the wrong network family for the address is rejected the same way, with does not support this wallet address type. When the filter is omitted, chains that fail the gate are left out of data silently, with no error and no meta signal.

[
  "polygon"
]
filter[fungible_ids]string[]

Return only transactions that involve these fungible IDs (comma-separated list).

[
  "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
]
filter[min_mined_at]string
Example:1688842525735

Return only transactions mined since this time, as a Unix timestamp in milliseconds.

filter[max_mined_at]string
Example:1694192535967

Return only transactions mined until this time, as a Unix timestamp in milliseconds.

filter[trash]'only_trash' | 'only_non_trash' | 'no_filter'

Filter transactions by the is_trash spam flag. Defaults to no_filter, which returns both spam and non-spam transactions.

filter[fungible_implementations]string[]

Return only transactions that involve these token implementations, as a comma-separated list of chain_id:address pairs.

For example: ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789

[
  "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
]

Headers

X-Env'testnet'

Set to testnet to return testnet data instead of mainnet.

Response

Response for requested list of transactions

Changes

  • 719a229a555dRevision changes
    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property /////////// became nullable for the status

    • breaking

      the response property /////////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property ///////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property ///////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property /////// to the response with the status