How to Get the Top Wallets on Ethereum with The Graph

Why Track Top Wallets?

High-value wallets move markets. Spotting them early lets you:

• Protect users – flag risky inflows before they hit your dapp
• Focus growth – airdrop or message holders who matter most
• Measure decentralization – know how supply is distributed

Until now you either ran an archive node or stitched third-party APIs. The Graph makes it easy with two options:

Option 1 – Token API in Three Steps

One REST endpoint returns the richest wallets for any ERC-20.

1. Get an auth token – sign up for Token API, then copy your JWT key.
2. Call the Holders endpoint:

curl --request GET \
  --url "https://token-api.thegraph.com/holders/evm/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48?network_id=mainnet&orderBy=balance&orderDirection=desc&limit=100&page=1" \
  --header "Authorization: Bearer <JWT Key>"

1. Filter human wallets – remove known exchange or contract addresses in code.

Result fields include address, balance, and percentageOfSupply. Docs cover pagination, historical snapshots, and ETH balances.

When to choose Token API

• You need data now, without on-chain indexing.
• Your stack is REST-centric (Python, Go, AI tools).
• You want pay-as-you-go cost control.

Option 2 – Build a Subgraph in Five Steps

Custom GraphQL for when you need full control.

Step 1: Create our Subgraph in Subgraph Studio

Subgraph Studio where we will interact with our Subgraph and get its endpoints after it has been deployed and is indexing our smart contract’s data.

1. Open Subgraph Studio and click Create a Subgraph.
2. Name it. For this example, we will call this subgraph nft‑transfers.
3. Select the chain where your smart contract is deployed from the network list.
4. Click Save.

Step 2: Scaffold Locally with the Graph CLI

Now, let’s spin up our Subgraph locally to prepare it to deploy to Subgraph Studio.

Install the CLI:

yarn install -g @graphprotocol/graph-cli

# npm, yarn, pnpm, and bun can also be used.

Inside an empty project folder, run:

graph init nft-transfers

Then follow the prompts:

• Choose the chain where your smart contract is deployed.
• Select Smart Contract.
• Paste your contract address when asked.

The CLI autogenerates three core files:

• subgraph.yaml — Manifest of data sources & handlers.
• schema.graphql — Entity definitions (already includes a Transfer entity for ERC‑721).
• mapping.ts — AssemblyScript logic.

Heads‑up: The CLI automatically scaffolds all entities and their handlers for you. In fact, every event emitted by the contract you supply to graph init is mirrored in the generated schema and mapping stubs, so for most vanilla use‑cases you can deploy without hand‑editing these files.

Step 3: Build & Deploy

Now that our Subgraph is scaffolded locally, we can deploy it to Subgraph Studio and begin indexing!

Back in your project folder:

yarn codegen && yarn build

# Authenticate once per machine

graph auth --studio <DEPLOY_KEY>

# Deploy

graph deploy --studio nft-transfers

After the initial sync finishes, Studio will display a GraphQL Playground. Copy the endpoint ending in /graphql and test it with the pre-populated query.

When to choose a subgraph

• You plan to expose a public API for your community.
• You want customizability with how your indexed data is stored and provided.

Putting It All Together

Want to try out Token API or Subgraphs? Get your JWT Token and read Token API Quickstart to get building fast with Token API, or hop into Subgraph Studio to build your custom Subgraph.

And as always, The Graph Discord is there should you have any questions.

Happy building!

About The Graph

The Graph is a suite of blockchain data infrastructure products that extract, process, and deliver scalable blockchain data solutions across 60+ networks. The Graph enables application developers, data analysts, AI agents, and enterprise teams that need structured, real-time access to blockchain data. Products include Subgraphs, Firehose, Substreams, and Amp. As of early 2026, The Graph has served over 1.27 trillion queries to more than 75,000 projects, powered by a network of independent Indexers around the world.

Follow The Graph on X, LinkedIn, Instagram, and Reddit. Join the community on The Graph’s Telegram, join technical discussions on The Graph’s Discord.