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

Tokens

ETH

17.28

$45,317.03

+2.84%

SYNDOG

30,000,000

$38,615.10

-5.64%

BKIT

28,980,487,535

$28,654.60

+12.32%

DeFi Positions

Morpho

ionicUSDC

$77.49

Aave v3

2 positions

$632.74

Uniswap v3

ETH/USDC LP

$1,078.49

NFT Collection

Estimated Value: $4677.69

Opepen 13841

$1084.29

Pudgy Penguin #1485

$388.72

Azuki #9762

$2226.34

Doodle #4552

$199.34

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"
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      }
    }
  }
}

NFT Balances

View NFTs held by a wallet, across multiple chains.

Comprehensive NFT portfolio data across chains

Collection and NFT metadata with images

Floor price and estimated values

Collection and network-level breakdowns

Read Documentation Try in Sandbox

{
  "data": {
    "portfolioV2": {
      "nftBalances": {
        "totalBalanceUSD": 7256.2761286155,
        "totalTokensOwned": "16140",
        "byToken": {
          "edges": [
            {
              "node": {
                "lastReceived": 1734041699000,
                "token": {
                  "tokenId": "10407",
                  "name": "Lil Pudgy #10407",
                  "description": "Lil Pudgys are a collection of 22,222 randomly generated NFTs minted on Ethereum.",
                  "supply": "1",
                  "circulatingSupply": "1",
                  "estimatedValue": {
                    "valueUsd": 2721.4122982182625,
                    "valueWithDenomination": 1.533253004612431,
                    "denomination": {
                      "address": "0x0000000000000000000000000000000000000000",
                      "symbol": "ETH",
                      "network": "ethereum"
                    }
                  },
                  "collection": {
                    "network": "ETHEREUM_MAINNET",
                    "address": "0x524cab2ec69124574082676e6f654a18df49a048",
                    "name": "LilPudgys",
                    "type": "GENERAL",
                    "deployer": "0xe9da256a28630efdc637bfd4c65f0887be1aeda8",
                    "deployedAt": 1639933745000,
                    "owner": "0xe9da256a28630efdc637bfd4c65f0887be1aeda8",
                    "medias": {
                      "logo": {
                        "mimeType": "image/png",
                        "fileSize": 5962,
                        "blurhash": "URHyw=WZ0stTN2j?xuWD0ut8^aj[?vWYIUt6",
                        "height": 250,
                        "width": 250,
                        "originalUri": "https://storage.googleapis.com/zapper-fi-assets/nfts/collections/ethereum/0x524cab2ec69124574082676e6f654a18df49a048/logo.png",
                        "original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x524cab2ec69124574082676e6f654a18df49a048/logo.png&checksum=VklwQoOgHYKsPj8GPZ1FDTXN8hPPSaVBjHCmiQ7vZy8",
                        "large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x524cab2ec69124574082676e6f654a18df49a048/logo.png&width=500&checksum=NlRY3lUeBcOFw3CzxcAGAQKxOLw3JhreqJ38BZTC9D0",
                        "medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x524cab2ec69124574082676e6f654a18df49a048/logo.png&width=250&checksum=VPxH2Ejt_0dOcWCesNcsfQYZgcGYPIFERQexdytLyP0",
                        "thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x524cab2ec69124574082676e6f654a18df49a048/logo.png&width=100&checksum=BFebU_PxxIAdlqld0-cJ_M0bjMTd3qTBRdFx02pBX5M",
                        "predominantColor": "#9ab3ed"
                      }
                    }
                  },
                  "mediasV3": {
                    "images": {
                      "edges": [
                        {
                          "node": {
                            "mimeType": "image/png",
                            "fileSize": 181886,
                            "blurhash": "UPQ4c{$j_$+^{0n%CRX8s;jtS0bFtlbHv#n%",
                            "height": 2700,
                            "width": 2700,
                            "originalUri": "https://api.pudgypenguins.io/lil/image/10407",
                            "original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/fa856d9f7907ea90f93067a80cfe2a84be04242e834306ddcbe25876438a8684.png&checksum=fRHieiOCQj_0piw8VZc-HDP-f5Uy8cl4p99Dx-66ycM",
                            "thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/fa856d9f7907ea90f93067a80cfe2a84be04242e834306ddcbe25876438a8684.png&width=100&checksum=oDAXzMIzWvlGOLbb1nN8IWKl4_B26B840wd6CXwhSWw",
                            "medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/fa856d9f7907ea90f93067a80cfe2a84be04242e834306ddcbe25876438a8684.png&width=250&checksum=jiyBP_I0JxBPasrg273qHzkTPOfnzRyMCdHakPTV-vk",
                            "large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/fa856d9f7907ea90f93067a80cfe2a84be04242e834306ddcbe25876438a8684.png&width=500&checksum=Ndb7k_Uoscl4oQ8vjoCCLljQcDG7BvtTV-SQ6w6JDRM",
                            "predominantColor": "#e35063"
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          ]
        }
      }
    }
  }
}

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
      }
    }
  }
}

API Comparison: Zapper API vs DeBank API

Compare how efficiently you can build a user portfolio with Zapper API versus alternatives

Zapper API

Two API queries, complete data

robergesoft.eth

0x6f6e...e261

Portfolio Value: $12,547,891.42

Token Holdings

WETH

Ethereum

4,283.72 WETH

$9,874,321.60

$2,305.31

+31%

USDC

Ethereum

1,248,637.42 USDC

$1,248,637.42

$1.00

+0.1%

DAI

Base

4,521,350.00 DAI

$1,017,303.75

$0.998

-0.2%

PEPE

Ethereum

1,832,751,205.06 PEPE

$407,628.65

$0.00022

+145%

Protocol Positions

Aave v3

Ethereum

Lending • 2 positions

$632,741.50

Uniswap v3

Ethereum

DEX • 3 LP positions

$867,250.15

Lido

Ethereum

Liquid Staking • stETH

$500,054.80

API Queries Used

GQL query: account

Cost: $0.002

Returns profile data (profile picture, ENS, BaseName, Farcaster)

GQL query: portfoliov2

Cost: $0.010

Returns token balances with price changes, protocol investments, and total portfolio value across all chains in a single request

Total for portfolio data: 1 API request, $0.010

DeBank API

Multiple requests needed, 52% more expensive

N/A

0x6f6e75fb472ee39d847d825cc7c9a613e227e261

N/A

Portfolio Value: $12,547,891.42

Token Holdings

WETH

Ethereum

4,283.72 WETH

$9,874,321.60

$2,305.31

+31%

3,4

USDC

Ethereum

1,248,637.42 USDC

$1,248,637.42

$1.00

+0.1%

5,6

DAI

Base

4,521,350.00 DAI

$1,017,303.75

$0.998

-0.2%

7,8

PEPE

Ethereum

1,832,751,205.06 PEPE

$407,628.65

$0.00022

+145%

9,10

Protocol Positions

Aave v3

Ethereum

Lending • 2 positions

$632,741.50

Uniswap v3

Ethereum

DEX • 3 LP positions

$867,250.15

Lido

Ethereum

Liquid Staking • stETH

$500,054.80

API Queries Used

Onchain identity : unavailable

Cost: N/A

Only address is displayed

GET /v1/user/total_balance

Cost: $0.006

Returns total portfolio value

GET /v1/user/all_token_list

Cost: $0.0036

Returns token balances across chains

3-10

GET /v1/token/history_price

Cost: $0.0032

8 calls needed to get 4 price change percentages

GET /v1/user/all_simple_protocol_list

Cost: $0.0024

Returns protocol investments data

Total for portfolio data : 11 API requests, $0.0152 (52% more expensive)

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