Skip to main content
GET
/
v1
/
wallet-sets
/
transactions
Get wallet set transactions
curl --request GET \
  --url https://api.zerion.io/v1/wallet-sets/transactions/ \
  --header 'Authorization: Basic <encoded-value>'
{
  "links": {
    "self": "http://api.zerion.io/v1/wallet-sets/transactions/?addresses=0x42b9df65b219b3dd36ff330a4dd8f327a6ada990%2C8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K&currency=eth&filter%5Bchain_ids%5D=arbitrum%2Csolana&filter%5Bmax_mined_at%5D=1764246600000&filter%5Btrash%5D=no_filter&page%5Bafter%5D=WyIiLCIiXQ%3D%3D&page%5Bsize%5D=5",
    "next": "http://api.zerion.io/v1/wallet-sets/transactions/?addresses=0x42b9df65b219b3dd36ff330a4dd8f327a6ada990%2C8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K&currency=eth&filter%5Bchain_ids%5D=arbitrum%2Csolana&filter%5Bmax_mined_at%5D=1764246600000&filter%5Btrash%5D=no_filter&page%5Bafter%5D=WyIyMDI1LTExLTI3VDA4OjQwOjU3WiIsImYxNWMwOTEzYTBlMzVhMjk4NDZhODY1ZmVjYjQyZDUwIl0%3D&page%5Bsize%5D=5"
  },
  "data": [
    {
      "type": "transactions",
      "id": "52d994a173d755e99845e861d534a419",
      "attributes": {
        "operation_type": "trade",
        "hash": "0x109d8622084d562263230ba5de412b5cd7c372019131e2c9d0a8aa4925eb6034",
        "mined_at_block": 15345739,
        "mined_at": "2022-08-15T11:26:31+00:00",
        "sent_from": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
        "sent_to": "0x794a61358d6845594f94dc1db02a252b5b4814ad",
        "status": "confirmed",
        "nonce": 3757,
        "fee": {
          "fungible_info": {
            "name": "Bankless BED Index",
            "symbol": "BED",
            "icon": {
              "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
            },
            "flags": {
              "verified": true
            },
            "implementations": [
              {
                "chain_id": "ethereum",
                "decimals": 18,
                "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
              }
            ],
            "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
            "description": "The BED index is meant to track crypto’s top 3 investab.",
            "market_data": {
              "price": 106.87952669793131,
              "total_supply": 29905.762448515918,
              "circulating_supply": 29905.762448515918,
              "fully_diluted_valuation": 3196313.736038149,
              "market_cap": 3196313.736038149,
              "changes": {
                "percent_1d": -0.7379066649086338,
                "percent_30d": -2.499465618806962,
                "percent_90d": 11.316340269371775,
                "percent_365d": null
              },
              "trading_volumes": {
                "volume_1d": 40096375.69294812
              }
            }
          },
          "quantity": {
            "int": "12345678",
            "decimals": 5,
            "float": 123.45678,
            "numeric": "123.45678"
          },
          "price": 2542.23,
          "value": 39.965672931101786
        },
        "transfers": [
          {
            "direction": "in",
            "quantity": {
              "int": "12345678",
              "decimals": 5,
              "float": 123.45678,
              "numeric": "123.45678"
            },
            "value": 0,
            "price": 0,
            "sender": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "recipient": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "act_id": "2",
            "fungible_info": {
              "name": "Bankless BED Index",
              "symbol": "BED",
              "icon": {
                "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
              },
              "flags": {
                "verified": true
              },
              "implementations": [
                {
                  "chain_id": "ethereum",
                  "decimals": 18,
                  "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
                }
              ],
              "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
              "description": "The BED index is meant to track crypto’s top 3 investab.",
              "market_data": {
                "price": 106.87952669793131,
                "total_supply": 29905.762448515918,
                "circulating_supply": 29905.762448515918,
                "fully_diluted_valuation": 3196313.736038149,
                "market_cap": 3196313.736038149,
                "changes": {
                  "percent_1d": -0.7379066649086338,
                  "percent_30d": -2.499465618806962,
                  "percent_90d": 11.316340269371775,
                  "percent_365d": null
                },
                "trading_volumes": {
                  "volume_1d": 40096375.69294812
                }
              }
            },
            "nft_info": {
              "contract_address": "0x74ee68a33f6c9f113e22b3b77418b75f85d07d22",
              "token_id": "10",
              "name": "#10 De·genesis",
              "interface": "erc1155",
              "flags": {
                "is_spam": true
              },
              "content": {
                "preview": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "detail": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "audio": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "video": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                }
              }
            }
          }
        ],
        "approvals": [
          {
            "quantity": {
              "int": "12345678",
              "decimals": 5,
              "float": 123.45678,
              "numeric": "123.45678"
            },
            "sender": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "act_id": "1",
            "fungible_info": {
              "name": "Bankless BED Index",
              "symbol": "BED",
              "icon": {
                "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
              },
              "flags": {
                "verified": true
              },
              "implementations": [
                {
                  "chain_id": "ethereum",
                  "decimals": 18,
                  "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
                }
              ],
              "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
              "description": "The BED index is meant to track crypto’s top 3 investab.",
              "market_data": {
                "price": 106.87952669793131,
                "total_supply": 29905.762448515918,
                "circulating_supply": 29905.762448515918,
                "fully_diluted_valuation": 3196313.736038149,
                "market_cap": 3196313.736038149,
                "changes": {
                  "percent_1d": -0.7379066649086338,
                  "percent_30d": -2.499465618806962,
                  "percent_90d": 11.316340269371775,
                  "percent_365d": null
                },
                "trading_volumes": {
                  "volume_1d": 40096375.69294812
                }
              }
            },
            "nft_info": {
              "contract_address": "0x74ee68a33f6c9f113e22b3b77418b75f85d07d22",
              "token_id": "10",
              "name": "#10 De·genesis",
              "interface": "erc1155",
              "flags": {
                "is_spam": true
              },
              "content": {
                "preview": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "detail": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "audio": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "video": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                }
              }
            }
          }
        ],
        "address": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
        "refund": {
          "fungible_info": {
            "name": "Bankless BED Index",
            "symbol": "BED",
            "icon": {
              "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
            },
            "flags": {
              "verified": true
            },
            "implementations": [
              {
                "chain_id": "ethereum",
                "decimals": 18,
                "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
              }
            ],
            "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
            "description": "The BED index is meant to track crypto’s top 3 investab.",
            "market_data": {
              "price": 106.87952669793131,
              "total_supply": 29905.762448515918,
              "circulating_supply": 29905.762448515918,
              "fully_diluted_valuation": 3196313.736038149,
              "market_cap": 3196313.736038149,
              "changes": {
                "percent_1d": -0.7379066649086338,
                "percent_30d": -2.499465618806962,
                "percent_90d": 11.316340269371775,
                "percent_365d": null
              },
              "trading_volumes": {
                "volume_1d": 40096375.69294812
              }
            }
          },
          "quantity": {
            "int": "12345678",
            "decimals": 5,
            "float": 123.45678,
            "numeric": "123.45678"
          },
          "price": 2542.23,
          "value": 5.123456789
        },
        "collection_approvals": [
          {
            "cancelled": true,
            "spender": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "act_id": "1",
            "collection_info": {
              "id": "<string>",
              "name": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
              "icon_url": "1"
            }
          }
        ],
        "delegations": [
          {
            "address": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
            "act_id": "1",
            "chain_id": "ethereum"
          }
        ],
        "application_metadata": {
          "contract_address": "0x794a61358d6845594f94dc1db02a252b5b4814ad",
          "name": "AAVE",
          "icon": {
            "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
          },
          "method": {
            "id": "0x095ea7b3",
            "name": "Approve"
          }
        },
        "flags": {
          "is_trash": true
        },
        "acts": [
          {
            "id": "1",
            "type": "trade",
            "application_metadata": {
              "contract_address": "0x794a61358d6845594f94dc1db02a252b5b4814ad",
              "name": "AAVE",
              "icon": {
                "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
              },
              "method": {
                "id": "0x095ea7b3",
                "name": "Approve"
              }
            }
          }
        ],
        "paymaster": "0x794a61358d6845594f94dc1db02a252b5b4814ad"
      },
      "relationships": {
        "chain": {
          "links": {
            "related": "https://api.zerion.io/v1/chains/polygon"
          },
          "data": {
            "type": "chains",
            "id": "polygon"
          }
        },
        "dapp": {
          "data": {
            "type": "dapps",
            "id": "aave-v3"
          }
        }
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
X-Env
enum<string>

Custom header that allows you to get data for testnets.

Available options:
testnet

Query Parameters

​
addresses
string[]
required

A list of wallet addresses forming a wallet set. example: 0x42b9df65b219b3dd36ff330a4dd8f327a6ada990,8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K

The set must contain at least one address and may include at most one address per supported chain type (currently EVM and Solana). The order of addresses does not matter.

Required array length: 1 - 2 elements
​
currency
enum<string>
default:usd

Denominated currency value of returned prices

Available options:
eth,
btc,
usd,
eur,
krw,
rub,
gbp,
aud,
cad,
inr,
jpy,
nzd,
try,
zar,
cny,
chf
​
page
object

Pagination parameters

​
filter[search_query]
string

Query for a full-text search.

Required string length: 2 - 64
Example:

"Trade"

​
filter[operation_types]
enum<string>[]

Return only transactions with specified types (comma-separated list).

Possible values:

  • approve - Grant permission to a smart contract to access and spend tokens on behalf of the wallet
  • 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)

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)
Available options:
approve,
burn,
claim,
delegate,
deploy,
deposit,
execute,
mint,
receive,
revoke,
revoke_delegation,
send,
trade,
withdraw
​
filter[asset_types]
enum<string>[]

Return only transactions that contain specified asset types (comma-separated list).

Type of concrete asset.

Available options:
fungible,
nft
​
filter[chain_ids]
string[]

Return only transactions from specified chains (comma-separated list). You can find available chain ids in chain endpoints.

​
filter[fungible_ids]
string[]

Return only transactions with fungibles with specified ids (comma-separated list).

​
filter[min_mined_at]
string

Return only transactions since specific date. Timestamp in milliseconds.

Required string length: 13
Example:

"1688842525735"

​
filter[max_mined_at]
string

Return only transactions until specific date. Timestamp in milliseconds.

Required string length: 13
Example:

"1694192535967"

​
filter[trash]
enum<string>
default:no_filter

Filter transactions based on the is_trash flag. If no flag is specified, then no_filter is applied.

Available options:
only_trash,
only_non_trash,
no_filter
​
filter[fungible_implementations]
string[]

Specify implementations of fungible tokens as a comma-separated list of chain:address pairs.

Example format: ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789

Each item consists of a blockchain chain_id and an address, separated by a colon (:). Multiple pairs can be provided using commas (,).

Response

Response for requested list of transactions

​
links
object
required
​
data
object[]
required