Transaction History

Access comprehensive onchain activity with rich transaction details, structured asset deltas, and support for both EOA and smart contract wallets.

Human-readable descriptions

Account abstraction support

Detailed balance changes

Enhanced filtering options

Read Documentation

01{
02  "data": {
03    "transactionHistoryV2": {
04      "edges": [
05        {
06          "node": {
07            "methodSignature": "swapAndTransferUniswapV3Native((uint256,uint256,address,address,address,uint256,bytes16,address,bytes,bytes),uint24)",
08            "methodSighash": "0x8bf122da",
09            "transaction": {
10              "blockNumber": 27161406,
11              "gas": 306461,
12              "gasPrice": "2426453",
13              "hash": "0x98455ae7e6b236d71467f2f175ba5b876a764d4bd2eecac6f205e7178ded1831",
14              "network": "BASE_MAINNET",
15              "timestamp": 1741112159000,
16              "nonce": 1958,
17              "fromUser": {
18                "address": "0x52c8ff44260056f896e20d8a43610dd88f05701b",
19                "displayName": {
20                  "value": "0xjasper.eth",
21                  "source": "ENS"
22                },
23                "farcasterProfile": {
24                  "fid": 177,
25                  "username": "jasper"
26                }
27              },
28              "toUser": {
29                "address": "0x03059433bcdb6144624cc2443159d9445c32b7a8",
30                "displayName": {
31                  "value": "0x0305...b7a8",
32                  "source": "ADDRESS"
33                },
34                "farcasterProfile": null
35              }
36            },
37            "interpretation": {
38              "processedDescription": "Swapped 0.0021 ETH for 4.455 USDC and transferred to 0x9b3a...4b30",
39              "description": "Swapped $1 for $2 and transferred to $3",
40              "descriptionDisplayItems": [
41                {
42                  "type": "token",
43                  "tokenAddress": "0x0000000000000000000000000000000000000000",
44                  "amountRaw": "2108250382006340",
45                  "network": "BASE_MAINNET",
46                  "tokenV2": {
47                    "decimals": 18,
48                    "symbol": "ETH",
49                    "name": "Ether",
50                    "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png"
51                  }
52                },
53                {
54                  "type": "token",
55                  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
56                  "amountRaw": "4455000",
57                  "network": "BASE_MAINNET",
58                  "tokenV2": {
59                    "decimals": 6,
60                    "symbol": "USDC",
61                    "name": "USD Coin",
62                    "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913.png"
63                  }
64                }
65              ]
66            },
67            "perspectiveDelta": {
68              "tokenDeltasV2": {
69                "edges": [
70                  {
71                    "node": {
72                      "address": "0x0000000000000000000000000000000000000000",
73                      "amount": -0.00210825038200634,
74                      "amountRaw": "-2108250382006340",
75                      "token": {
76                        "symbol": "ETH",
77                        "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png"
78                      }
79                    }
80                  }
81                ]
82              }
83            }
84          }
85        }
86      ]
87    }
88  }
89}

Human-readable descriptions

Get clear text descriptions of complex onchain transactions that you can display directly to users with no additional processing.

Account abstraction support

Correctly identify transactions from smart contract wallets, showing the actual signer and providing proper attribution.

Dynamic Transaction Descriptions

Present transactions with both simple text descriptions and dynamic, interactive elements for a rich user experience.

Plain text descriptions for any transaction

Templated descriptions with reference tokens

Structured data for referenced elements

Identity resolution for addresses

Read Documentation Try in Sandbox

{
  "interpretation": {
    "processedDescription": "Swapped 0.0021 ETH for 4.455 USDC and transferred to 0x9b3a...4b30",
    "description": "Swapped $1 for $2 and transferred to $3",
    "descriptionDisplayItems": [
      {
        "type": "token",
        "tokenAddress": "0x0000000000000000000000000000000000000000",
        "amountRaw": "2108250382006340",
        "network": "BASE_MAINNET",
        "tokenV2": {
          "decimals": 18,
          "symbol": "ETH",
          "name": "Ether",
          "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png",
          "onchainMarketData": {
            "price": 2193.02
          }
        }
      },
      {
        "type": "token",
        "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "amountRaw": "4455000",
        "network": "BASE_MAINNET",
        "tokenV2": {
          "decimals": 6,
          "symbol": "USDC",
          "name": "USD Coin",
          "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913.png"
        }
      },
      {
        "type": "actor",
        "address": "0x9b3a20176d2c5d0a22dae382496416a1a8934b30",
        "account": {
          "displayName": {
            "value": "0x9b3a...4b30",
            "source": "ADDRESS"
          }
        }
      }
    ]
  }
}

Detailed Asset Deltas

Track exactly what changed in a user's portfolio with explicit delta information for each transaction.

Token balance changes with amounts

NFT acquisitions and transfers

Positive (received) and negative (sent) amounts

Associated token metadata and prices

Read Documentation Try in Sandbox

{
  "perspectiveDelta": {
    "account": {
      "address": "0x52c8ff44260056f896e20d8a43610dd88f05701b",
      "displayName": {
        "value": "0xjasper.eth",
        "source": "ENS"
      },
    },
    "nftDeltasCount": 0,
    "tokenDeltasCount": 1,
    "nftDeltasV2": {
      "edges": []
    },
    "tokenDeltasV2": {
      "edges": [
        {
          "node": {
            "address": "0x0000000000000000000000000000000000000000",
            "amount": -0.00210825038200634,
            "amountRaw": "-2108250382006340",
            "token": {
              "symbol": "ETH",
              "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png",
              "onchainMarketData": {
                "price": 2193.02,
                "priceChange24h": 2.5226014912818284
              }
            }
          }
        }
      ]
    }
  }
}

Enhanced Filtering Options

Target exactly the transactions you need with granular filtering options across multiple dimensions.

Filter by specific networks

Filter by tokens involved

Filter by sender or recipient

Filter by category (swap, mint, NFT sale, etc.)

Control transaction perspective (signer, receiver, etc.)

Read Documentation Try in Sandbox

{
  "filters": {
    "network": ["BASE_MAINNET", "ETHEREUM_MAINNET"],
    "tokenAddress": ["0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"],
    "receivedFrom": ["0x52c8ff44260056f896e20d8a43610dd88f05701b"],
    "sentTo": ["0x9b3a20176d2c5d0a22dae382496416a1a8934b30"],
    "categories": ["Swap", "Bridge", "Nft_Mint", "Nft_Sale"],
    "contractAddress": ["0x03059433bcdb6144624cc2443159d9445c32b7a8"]
  },
  "perspective": "Signer",
  "first": 10,
  "after": "cursor123"
}

Ready to start building transaction histories?

If you need help with implementation or have other questions our team is here to help.

Book a Call