--- title: "Get wallet set transactions" method: GET path: "/v1/wallet-sets/transactions/" tags: ["wallet sets"] --- # Get wallet set transactions `GET /v1/wallet-sets/transactions/` This endpoint returns a list of transactions associated with the wallet set. A wallet set is represented by an EVM address, a Solana address, or both. At least one address must be provided. This endpoint supports testnets. To get data for testnets use `X-Env` header. **Temporary limitations for Solana addresses:** - Doesn't support NFT transactions > NOTE: This endpoint supports a lot of filters, sorting, and pagination parameters. Make sure that your request URL length is safe for your platform. Usually, 2000 characters are the safe limit in virtually any combination of client and server software. > NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes. ## Query parameters - `addresses` string[], required - `currency` 'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf' - `page` object - `after` string, 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. - `size` integer — Set maximum number of items per a page in the pagination. - `filter[search_query]` string - `filter[operation_types]` Type[] - `filter[asset_types]` AssetType[] - `filter[chain_ids]` string[] - `filter[fungible_ids]` string[] - `filter[min_mined_at]` string - `filter[max_mined_at]` string - `filter[trash]` 'only_trash' | 'only_non_trash' | 'no_filter' - `filter[fungible_implementations]` string[] ## Headers - `X-Env` 'testnet' ## Response `200` Response for requested list of transactions - Response11 - `links` ResponseLinks11, required - `self` string, url, required - `next` string, url - `data` Container4[], required - `type` 'transactions', required — Resource type - `id` string, required — Unique ID of the transaction. - `attributes` Attributes5, required - `address` string — Wallet address for which this transaction is being retrieved. - `operation_type` 'approve' | 'bid' | 'burn' | 'claim' | 'delegate' | 'deploy' | 'deposit' | 'execute' | 'mint' | 'receive' | 'revoke' | 'revoke_delegation' | 'send' | 'trade' | 'withdraw', required — Type of the transaction operation. This field indicates the primary action performed in the transaction. Possible values and their meanings: - `approve` - Grant permission to a smart contract to access and spend tokens on behalf of the wallet - `bid` - Place a bid in a prediction market - `burn` - Destroy tokens permanently, reducing the total token supply - `claim` - Claim earned rewards, airdrops, or vested tokens from a protocol - `delegate` - Delegate tokens or voting power to another address - `deploy` - Deploy a new smart contract to the blockchain - `deposit` - Deposit assets into a protocol (e.g., lending pool, liquidity pool, vault) - `execute` - Execute a smart contract function or complex interaction that doesn't fit other specific types - `mint` - Create new tokens, increasing the total token supply - `receive` - Receive tokens from another wallet address - `revoke` - Revoke previously granted token spending permissions from a smart contract - `revoke_delegation` - Revoke a previously delegated token or voting power - `send` - Send tokens to another wallet address - `trade` - Exchange or swap assets (e.g., on a DEX) - `withdraw` - Withdraw assets from a protocol (e.g., from lending pools, liquidity pools, or vaults) - `hash` string, required — Hash of the transaction. - `mined_at_block` integer, required — Number of a block where the transaction was mined. - `mined_at` string, required — Timestamp string in ISO 8601 format when the transaction was mined. - `sent_from` string, required — Address of a sender of the transaction. It could be a smart contract address too. - `sent_to` string, required — Address of a recipient of the transaction. It could a be smart contract address too. - `status` 'confirmed' | 'failed' | 'pending', required — Status of the transaction. - `nonce` integer, required — Nonce of the transaction. - `fee` Fee, required — The fee that was paid for the transaction. - `fungible_info` Info, required - `id` string — Unique identifier of the fungible asset. - `name` string, required — Displayable name of the fungible fungible. - `symbol` string, required — Displayable symbol of the fungible fungible. - `description` string, nullable — Brief description of the fungible. Currently available at transaction callback notifications only. - `icon` Icon, required — Icon related to object. - `url` string, url, nullable — URL of the icon. - `flags` Flags, required - `verified` boolean, required — Whether this fungible verified or not - `implementations` Implementation[], required — Implementation details of the fungible on various chains. - `chain_id` string, required — Unique id of the chain. - `address` string — Implementation address on the chain. - `decimals` integer, required — Number of decimals points of the implementation. - `market_data` MarketData - `total_supply` number, double — Total market supply of fungible - `circulating_supply` number, double — Circulating value of fungible - `fully_diluted_valuation` number, double — Total market capitalization of fungible in selected currency - `market_cap` number, double — Circulating market capitalization of fungible in selected currency - `price` number, double, nullable, required — Latest fungible price - `changes` MarketDataChanges - … - `trading_volumes` TradingVolumes - … - `quantity` Quantity, required - `int` string, required — Objective on-chain raw amount in base units. Use this value for building on-chain transactions. - `decimals` integer, required — Decimal number precision of the quantity - digits after the floating point. - `float` number, float, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `numeric` string, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `price` number, float, nullable, required — Price of the asset when the transaction was mined. Can be null if price information is unavailable. - `value` number, float, nullable, required — The fee value in requested currency. Can be null if value cannot be calculated. - `refund` Refund — The refund that was received for the transaction. - `fungible_info` Info, required - `id` string — Unique identifier of the fungible asset. - `name` string, required — Displayable name of the fungible fungible. - `symbol` string, required — Displayable symbol of the fungible fungible. - `description` string, nullable — Brief description of the fungible. Currently available at transaction callback notifications only. - `icon` Icon, required — Icon related to object. - `url` string, url, nullable — URL of the icon. - `flags` Flags, required - `verified` boolean, required — Whether this fungible verified or not - `implementations` Implementation[], required — Implementation details of the fungible on various chains. - `chain_id` string, required — Unique id of the chain. - `address` string — Implementation address on the chain. - `decimals` integer, required — Number of decimals points of the implementation. - `market_data` MarketData - `total_supply` number, double — Total market supply of fungible - `circulating_supply` number, double — Circulating value of fungible - `fully_diluted_valuation` number, double — Total market capitalization of fungible in selected currency - `market_cap` number, double — Circulating market capitalization of fungible in selected currency - `price` number, double, nullable, required — Latest fungible price - `changes` MarketDataChanges - … - `trading_volumes` TradingVolumes - … - `quantity` Quantity, required - `int` string, required — Objective on-chain raw amount in base units. Use this value for building on-chain transactions. - `decimals` integer, required — Decimal number precision of the quantity - digits after the floating point. - `float` number, float, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `numeric` string, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `price` number, float, nullable, required — Price of the asset when the transaction was mined. - `value` number, float, nullable, required — The refund value in requested currency. - `transfers` Transfer[], required — List of transfers. An empty list is returned if the transaction does not have any transfers. - `fungible_info` Info - `id` string — Unique identifier of the fungible asset. - `name` string, required — Displayable name of the fungible fungible. - `symbol` string, required — Displayable symbol of the fungible fungible. - `description` string, nullable — Brief description of the fungible. Currently available at transaction callback notifications only. - `icon` Icon, required — Icon related to object. - `url` string, url, nullable — URL of the icon. - `flags` Flags, required - `verified` boolean, required — Whether this fungible verified or not - `implementations` Implementation[], required — Implementation details of the fungible on various chains. - `chain_id` string, required — Unique id of the chain. - `address` string — Implementation address on the chain. - `decimals` integer, required — Number of decimals points of the implementation. - `market_data` MarketData - `total_supply` number, double — Total market supply of fungible - `circulating_supply` number, double — Circulating value of fungible - `fully_diluted_valuation` number, double — Total market capitalization of fungible in selected currency - `market_cap` number, double — Circulating market capitalization of fungible in selected currency - `price` number, double, nullable, required — Latest fungible price - `changes` MarketDataChanges - … - `trading_volumes` TradingVolumes - … - `nft_info` Info2 - `contract_address` string, required — Address of the contract of the NFT. - `token_id` string, required — Unique identifier of the NFT inside the contract. - `name` string, required — Name of the NFT. - `interface` 'erc721' | 'erc1155', required — The standard that the NFT contract follows, e.g. ERC-721. - `content` Content - `preview` object — The URL of the preview image - … - `detail` object — The URL of the full-size image - … - `audio` object — The URL of the audio file - … - `video` object — The URL of the video file - … - `flags` Flags3, required - `is_spam` boolean — Indicates whether the NFT spam or not. - `direction` 'in' | 'out' | 'self', required — Direction of the transfer. - `quantity` Quantity, required - `int` string, required — Objective on-chain raw amount in base units. Use this value for building on-chain transactions. - `decimals` integer, required — Decimal number precision of the quantity - digits after the floating point. - `float` number, float, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `numeric` string, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `value` number, float, nullable, required — Value of the transfer in requested currency. Can be null if value cannot be calculated. - `price` number, float, nullable, required — Historical price of the asset. Can be null if price information is unavailable. - `sender` string, required — Address of the sender of the transfer. - `recipient` string, required — Address of the recipient of the transfer. - `act_id` string, required — Identifier of the act to which the transfer belongs - `approvals` Approval[], required — List of approvals. An empty list is returned if the transaction does not have any approvals. - `fungible_info` Info - `id` string — Unique identifier of the fungible asset. - `name` string, required — Displayable name of the fungible fungible. - `symbol` string, required — Displayable symbol of the fungible fungible. - `description` string, nullable — Brief description of the fungible. Currently available at transaction callback notifications only. - `icon` Icon, required — Icon related to object. - `url` string, url, nullable — URL of the icon. - `flags` Flags, required - `verified` boolean, required — Whether this fungible verified or not - `implementations` Implementation[], required — Implementation details of the fungible on various chains. - `chain_id` string, required — Unique id of the chain. - `address` string — Implementation address on the chain. - `decimals` integer, required — Number of decimals points of the implementation. - `market_data` MarketData - `total_supply` number, double — Total market supply of fungible - `circulating_supply` number, double — Circulating value of fungible - `fully_diluted_valuation` number, double — Total market capitalization of fungible in selected currency - `market_cap` number, double — Circulating market capitalization of fungible in selected currency - `price` number, double, nullable, required — Latest fungible price - `changes` MarketDataChanges - … - `trading_volumes` TradingVolumes - … - `nft_info` Info2 - `contract_address` string, required — Address of the contract of the NFT. - `token_id` string, required — Unique identifier of the NFT inside the contract. - `name` string, required — Name of the NFT. - `interface` 'erc721' | 'erc1155', required — The standard that the NFT contract follows, e.g. ERC-721. - `content` Content - `preview` object — The URL of the preview image - … - `detail` object — The URL of the full-size image - … - `audio` object — The URL of the audio file - … - `video` object — The URL of the video file - … - `flags` Flags3, required - `is_spam` boolean — Indicates whether the NFT spam or not. - `quantity` Quantity, required - `int` string, required — Objective on-chain raw amount in base units. Use this value for building on-chain transactions. - `decimals` integer, required — Decimal number precision of the quantity - digits after the floating point. - `float` number, float, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `numeric` string, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `sender` string, required — Address of the sender of the approval. - `act_id` string, required — Identifier of the act to which the transfer belongs - `collection_approvals` CollectionApproval[] — List of collection approvals. An empty list is returned if the transaction does not have any collection approvals. - `collection_info` CollectionInfo - `id` string, required — Collection id. - `name` string, required — Collection name. - `icon_url` string, required — Identifier of the act to which the transfer belongs. - `cancelled` boolean, required — Indicates if the approval has been cancelled or granted. - `spender` string, required — Address of the spender of the approval. - `act_id` string, required — Identifier of the act to which the transfer belongs. - `delegations` Delegation[] — List of delegations. - `chain_id` string - `address` string, required - `act_id` string, required - `application_metadata` DAppInfo2 - `name` string — Human readable representation of DApp, that wallet interacted to. That offers more intuitive understanding for users. - `icon` Icon — Icon related to object. - `url` string, url, nullable — URL of the icon. - `contract_address` string, required — The address of the executed contract. - `method` ExecutionMethod - `id` string — Execution method id. First 4 bytes of keccak256 of method signature in hex format. - `name` string — Human readable name of the method. - `flags` Flags4 - `is_trash` boolean — Is the transaction classified by Zerion as trash. - `acts` Act[] — List of acts happened in the transaction for the wallet. Each transfer and approval belongs to one of the acts. - `id` string, required — Unique identifier of the act within the transaction. - `type` 'send' | 'receive' | 'trade' | 'deposit' | 'withdraw' | 'approve' | 'execute' | 'deploy' | 'fee' | 'mint' | 'burn' | 'claim' | 'delegate' | 'revoke_delegation' | 'bid', required — Type of act in the transaction. - `fee_kind` 'ui' | 'jito' — Classification of the fee for acts of type `fee`. Omitted for non-fee acts. Possible values: - ui — Fee charged by the UI / client application (e.g., a wallet or dApp frontend) - jito — Jito tip paid on Solana for priority inclusion - `sent_from` string — Address of the actual sender of this act. Only set when it differs from the transaction-level `sent_from`, e.g. in ERC-4337 bundler transactions. - `application_metadata` DAppInfo2 - `name` string — Human readable representation of DApp, that wallet interacted to. That offers more intuitive understanding for users. - `icon` Icon — Icon related to object. - `url` string, url, nullable — URL of the icon. - `contract_address` string, required — The address of the executed contract. - `method` ExecutionMethod - `id` string — Execution method id. First 4 bytes of keccak256 of method signature in hex format. - `name` string — Human readable name of the method. - `paymaster` string — Address of a transaction fee payer. - `relationships` Relationships2 - `chain` Relationship - `links` RelationshipLinks, required - `related` string, url, required — URL to the current chain. - `data` ContainerShort, required - `type` string, required — Chain resource type. - `id` string, required — Chain unique identifier. - `dapp` Relationship2 - `data` ContainerShort2, required - `type` string, required — Decentralized application resource type. - `id` string, required — Decentralized application ID ## Other responses - `400` — Parameters are malformed - `401` — Unathenticated request - `429` — Too many requests error --- [API](https://skmtc.dev/zerion/apis/rest-api.md) · [All operations](https://skmtc.dev/zerion/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zerion/rest-api/revisions/2ef116ef914f/schema)