App Transactions
Presents the onchain activity for a specific application by monitoring transactions through its smart contracts. This endpoint enables you to track all interactions with a particular protocol or dapp across multiple networks.
transactionsForApp
Takes an app slug as input, with optional parameters for network, and spamFilter. Returns chronological on-chain activity including:
Example Use Case: Protocol Activity Feed
Let's say you want to build a real-time activity feed showing all transactions happening in a specific app like Uniswap or Aave. Start by passing the app's slug. The query returns:
- Human-readable transaction descriptions (
processedDescription) - Network information
- Complete transaction details
- Comprehensive data about tokens or NFTs involved
- Account information for transaction actors
This allows you to build rich activity feeds with:
- Formatted descriptions (e.g., "Swapped 400 USDC for 0.2 ETH")
- Complete token details including amounts and prices
- NFT transfers and metadata when relevant
- Links to relevant accounts and transactions
To find the correct slug for the app you are trying to reference, find the app on Zapper. The slug is the last part of the URL. For example: https://zapper.xyz/apps/aave-v3 has the slug aave-v3.
Example Variables
{
"slug": "aave-v3",
"first": 10,
"spamFilter": true
}
Example Query
query TransactionsForApp($slug: String!, $network: Network, $networks: [Network!], $first: Int, $after: String) {
transactionsForApp(slug: $slug, network: $network, networks: $networks, first: $first, after: $after) {
edges {
node {
# Transaction metadata
transaction {
hash
nonce
gasPrice
gas
blockNumber
timestamp
fromUser {
displayName {
value
}
}
toUser {
displayName {
value
}
}
}
# Application details (if any)
app {
slug
name
imgUrl
}
interpretation {
# Basic text description
processedDescription
# Templated description with reference tokens
description
# Structured data for referenced elements
descriptionDisplayItems {
... on TokenDisplayItem {
type
network
tokenAddress
amountRaw
tokenV2 {
address
symbol
decimals
name
imageUrlV2
priceData {
price(currency: USD)
priceChange24h
marketCap
}
}
}
... on NFTDisplayItem {
type
network
collectionAddress
tokenId
quantity
nftToken {
collection {
name
}
}
}
... on ActorDisplayItem {
type
address
account {
address
displayName {
value
}
farcasterProfile {
username
fid
}
}
}
... on NFTCollectionDisplayItem {
collectionAddress
network
nftCollection {
displayName
medias {
logo {
thumbnail
}
}
}
}
... on StringDisplayItem {
stringValue
type
}
... on NetworkDisplayItem {
chainId
type
networkMetadata {
name
}
}
}
}
# Account deltas
perspectiveDelta {
tokenDeltasV2(first: 5) {
edges {
node {
address
amountRaw
amount
token {
symbol
decimals
name
imageUrlV2
}
}
}
}
nftDeltasV2(first: 5) {
edges {
node {
collectionAddress
tokenId
amount
nft {
name
collection {
name
}
}
}
}
}
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
Example Response
{
"data": {
"transactionsForApp": {
"edges": [
{
"node": {
"transaction": {
"hash": "0xac50cc7e8393e87bd1549fa29f095fd3c16620f0140a9c96caf0e85904ccf7c0",
"nonce": 507,
"gasPrice": "41603808",
"gas": 300000,
"blockNumber": 16505914,
"timestamp": 1741028989000,
"fromUser": {
"displayName": {
"value": "averagenjoyer.eth"
}
},
"toUser": {
"displayName": {
"value": "0xc47b...a8ac"
}
}
},
"app": {
"slug": "aave-v3",
"name": "Aave V3",
"imgUrl": "https://storage.googleapis.com/zapper-fi-assets/apps%2Faave-v3.png"
},
"interpretation": {
"processedDescription": "Deposited 0.0592 WETH ",
"description": "Deposited $1 ",
"descriptionDisplayItems": [
{
"type": "token",
"network": "LINEA_MAINNET",
"tokenAddress": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
"amountRaw": "59200000000000000",
"tokenV2": {
"address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
"symbol": "WETH",
"decimals": 18,
"name": "Wrapped Ether",
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/linea/0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f.png",
"priceData": {
"price": 2191.603934,
"priceChange24h": -11.320993482740416,
"marketCap": 81948094.85707492
}
}
}
]
},
"perspectiveDelta": {
"tokenDeltasV2": {
"edges": [
{
"node": {
"address": "0x787897df92703bb3fc4d9ee98e15c0b8130bf163",
"amountRaw": "59376926813196014",
"amount": 0.059376926813196014,
"token": {
"symbol": "aLinWETH",
"decimals": 18,
"name": "Aave Linea WETH",
"imageUrlV2": null
}
}
},
{
"node": {
"address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
"amountRaw": "-59200000000000000",
"amount": -0.0592,
"token": {
"symbol": "WETH",
"decimals": 18,
"name": "Wrapped Ether",
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/linea/0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f.png"
}
}
}
]
},
"nftDeltasV2": {
"edges": []
}
}
}
},
]
}
}
}
To create interactive elements referencing tokens, NFTs, accounts, or other onchain items embedded within the transaction description, use description and descriptionDisplayItems instead of processedDescription. This enables you to add links to tokens, NFTs, or accounts (e.g., cl0kwork.eth supplied 50 ETH as collateral).
Pagination is highly recommended using first and after to ensure fast query response times and optimal performance.
Arguments
| Argument | Description | Type |
|---|---|---|
slug | The unique identifier for the app (e.g., "uniswap", "aave-v2") | String! |
network | Filter by a specific network | Network |
networks | Filter by multiple networks, input as an array | [Network!] |
realtimeInterpretation | Enable human-readable transactions (default: true) | Boolean |
spamFilter | Filter out spam transactions (default: true) | Boolean |
first | Number of items to return (for pagination) | Int |
after | Cursor for pagination | String |
Fields
Main Fields
| Field | Description | Type |
|---|---|---|
key | A unique identifier | String! |
network | Network where the transaction occurred | Network! |
timestamp | Unix timestamp in milliseconds | Timestamp! |
transaction | Contains detailed transaction information | OnChainTransaction! |
interpretation | Contains human-readable descriptions and asset transfers | ActivityInterpretation! |
Transaction Fields
| Field | Description | Type |
|---|---|---|
hash | Transaction hash | String! |
fromUser | The initiating address with details | Account! |
toUser | The receiving address with details | Account! |
value | Transaction value in wei | String! |
Interpretation Fields
| Field | Description | Type |
|---|---|---|
description | Human-readable description with variables | String! |
processedDescription | Fully processed human-readable description | String! |
descriptionDisplayItems | References for variables in the description | [ActivityFeedDisplayItem!]! |
inboundAttachments | Assets received in the transaction | [ActivityFeedDisplayItem!]! |
outboundAttachments | Assets sent in the transaction | [ActivityFeedDisplayItem!]! |
Account Fields
| Field | Description | Type |
|---|---|---|
address | The wallet address | Address! |
displayName | The account's display name (ENS, Lens, etc.) | DisplayName! |
Delta Fields
| Field | Description | Type |
|---|---|---|
perspectiveDelta | Contains token and NFT changes from the actor's perspective | ActivityAccountDelta! |
tokenDeltasV2 | Token transfer details including amounts and token info | FungibleTokenDeltaConnection! |
nftDeltasV2 | NFT transfer details including collection and token info | NftDeltaConnection! |
When working with token amounts, remember to divide amountRaw by 10^decimals to get the human-readable amount. For example, an amountRaw of "50000000000000000000" with 18 decimals represents 50 ETH.
All fields marked with ! are required fields in the response.