Portfolio Data

Access complete onchain portfolio data with a single query. Get comprehensive balances across tokens, apps, and NFTs, with portfolio breakdowns by network.

Multi-chain in one call

Real-time updates

Token and DeFi balances

Portfolio totals and breakdowns

Read Documentation

01{
02  "data": {
03    "portfolioV2": {
04      "tokenBalances": {
05        "totalBalanceUSD": 292328.8286857288,
06        "byToken": {
07          "totalCount": 1223,
08          "edges": [
09            {
10              "node": {
11                "symbol": "ETH",
12                "tokenAddress": "0x0000000000000000000000000000000000000000",
13                "balance": 17.286417826281596,
14                "balanceUSD": 45317.035788310255,
15                "price": 2621.54,
16                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png",
17                "name": "Ethereum",
18                "network": {
19                  "name": "Base"
20                }
21              }
22            },
23            {
24              "node": {
25                "symbol": "SYNDOG",
26                "tokenAddress": "0x3d1d651761d535df881740ab50ba4bd8a2ec2c00",
27                "balance": 30000000,
28                "balanceUSD": 38615.1,
29                "price": 0.00128717,
30                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x3d1d651761d535df881740ab50ba4bd8a2ec2c00.png",
31                "name": "Synthesizer Dog",
32                "network": {
33                  "name": "Base"
34                }
35              }
36            },
37            {
38              "node": {
39                "symbol": "BKIT",
40                "tokenAddress": "0x262a9f4e84efa2816d87a68606bb4c1ea3874bf1",
41                "balance": 28980487535.238518,
42                "balanceUSD": 28654.60195290476,
43                "price": 9.88755e-7,
44                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x262a9f4e84efa2816d87a68606bb4c1ea3874bf1.png",
45                "name": "Bangkit",
46                "network": {
47                  "name": "Base"
48                }
49              }
50            }
51          ]
52        }
53      },
54      "appBalances": {
55        "totalBalanceUSD": 1788.726036163165,
56        "byApp": {
57          "totalCount": 15
58        }
59      },
60      "nftBalances": {
61        "totalBalanceUSD": 164.6907089747224,
62        "byNetwork": {
63          "totalCount": 5
64        }
65      }
66    }
67  }
68}

Multi-chain in one call

Query balances across 45+ chains with a single API call. No need for multiple requests or chain-specific integration.

Real-time updates

Get immediate access to onchain balances with real-time computation, no more waiting for indexing jobs to complete.

Token Balances

Access token holdings across different networks with real-time computation built in.

Total portfolio value in USD

Native token balances across chains

Token metadata and prices

Network and account breakdowns

Read Documentation Try in Sandbox

{
  "data": {
    "portfolioV2": {
      "tokenBalances": {
        "totalBalanceUSD": 292328.8286857288,
        "byToken": {
          "totalCount": 1223,
          "edges": [
            {
              "node": {
                "symbol": "ETH",
                "tokenAddress": "0x0000000000000000000000000000000000000000",
                "balance": 17.286417826281596,
                "balanceUSD": 45317.035788310255,
                "price": 2621.54,
                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png",
                "name": "Ethereum",
                "network": {
                  "name": "Base"
                }
              }
            },
            {
              "node": {
                "symbol": "SYNDOG",
                "tokenAddress": "0x3d1d651761d535df881740ab50ba4bd8a2ec2c00",
                "balance": 30000000,
                "balanceUSD": 38615.1,
                "price": 0.00128717,
                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x3d1d651761d535df881740ab50ba4bd8a2ec2c00.png",
                "name": "Synthesizer Dog",
                "network": {
                  "name": "Base"
                }
              }
            },
            {
              "node": {
                "symbol": "BKIT",
                "tokenAddress": "0x262a9f4e84efa2816d87a68606bb4c1ea3874bf1",
                "balance": 28980487535.238518,
                "balanceUSD": 28654.60195290476,
                "price": 9.88755e-7,
                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x262a9f4e84efa2816d87a68606bb4c1ea3874bf1.png",
                "name": "Bangkit",
                "network": {
                  "name": "Base"
                }
              }
            }
          ]
        }
      }
    }
  }
}

DeFi Balances

View positions within onchain applications like lending protocols, DEXes, liquidity pools, and more.

App positions across protocols

Detailed protocol metadata

Position values and underlying tokens

Lent, borrowed, and staked assets

Read Documentation Try in Sandbox

{
  "data": {
    "portfolioV2": {
      "appBalances": {
        "totalBalanceUSD": 1788.726036163165,
        "byApp": {
          "totalCount": 15,
          "edges": [
            {
              "node": {
                "balanceUSD": 77.4990347567012,
                "app": {
                  "displayName": "Morpho",
                  "imgUrl": "https://storage.googleapis.com/zapper-fi-assets/apps%2Fmorpho.png",
                  "description": "Earn yield, borrow assets, curate markets and vaults.",
                  "slug": "morpho",
                  "url": "https://morpho.org/",
                  "category": {
                    "name": "DeFi"
                  }
                },
                "network": {
                  "name": "Base",
                  "slug": "base",
                  "chainId": 8453,
                  "evmCompatible": true
                },
                "balances": {
                  "edges": [
                    {
                      "node": {
                        "type": "app-token",
                        "address": "0x23479229e52ab6aad312d0b03df9f33b46753b5e",
                        "symbol": "ionicUSDC",
                        "balance": "37.03453811510863",
                        "balanceUSD": 37.373950883832,
                        "price": 1.009164769562798,
                        "tokens": [
                          {
                            "type": "base-token",
                            "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
                            "balance": "37.378212",
                            "balanceUSD": 37.373950883832,
                            "price": 0.999886,
                            "symbol": "USDC"
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      }
    }
  }
}

Portfolio Totals

Get consolidated portfolio values with detailed breakdowns across networks and asset types.

Total portfolio value across all assets

Network distribution breakdown

Token vs DeFi vs NFT allocation

Account-level contributions

Read Documentation Try in Sandbox

{
  "data": {
    "portfolioV2": {
      "tokenBalances": {
        "totalBalanceUSD": 191519.4268333953,
        "byNetwork": {
          "edges": [
            {
              "node": {
                "network": {
                  "name": "Base",
                  "slug": "base",
                  "chainId": 8453
                },
                "balanceUSD": 187210.46140590182
              }
            },
            {
              "node": {
                "network": {
                  "name": "Ethereum",
                  "slug": "ethereum",
                  "chainId": 1
                },
                "balanceUSD": 712.0326101880804
              }
            }
          ]
        }
      },
      "appBalances": {
        "totalBalanceUSD": 2354.7695934482635,
        "byNetwork": {
          "edges": [
            {
              "node": {
                "network": {
                  "name": "Base",
                  "slug": "base",
                  "chainId": 8453
                },
                "balanceUSD": 2337.336868521915
              }
            },
            {
              "node": {
                "network": {
                  "name": "Ethereum",
                  "slug": "ethereum",
                  "chainId": 1
                },
                "balanceUSD": 16.6343219463486
              }
            }
          ]
        }
      },
      "nftBalances": {
        "totalBalanceUSD": 164.6907089747224
      }
    }
  }
}

Ready to start building with portfolio data?

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

Book a Call