ADDRESS API · GraphQL · Labels · Risk

Address & Balance API balances, labels & risk for any wallet, any chain

Skip running an archive node and summing every Transfer to get a wallet's balance. We've already indexed balance updates across 40+ chains — so native and token balances, the balance at any past block, entity labels and risk scores for any address are one query away.

Powering wallet data forNansen logoChainalysis logoTRM Labs logoLukka logo
EVM.BalanceUpdatesNative and token balances for any wallet, summed from on-chain balance updates.Docs
wallet_balances.graphqlCopy
query {
  EVM(network: eth) {
    BalanceUpdates(
      where: {BalanceUpdate: {Address:
        {is: "0xab5801a7d398351b8be11c439e05c5b3259aec9b"}}}
    ) {
      Currency { Symbol }
      balance: sum(of:
        BalanceUpdate_Amount)
    }
  }
}
responseSTREAMING
TokenChainBalance
200 · GraphQL · 160msgraphql.bitquery.io
Trusted by 40,000+ developers & teams like
Binance logoChainalysis logoTRM Labs logoNansen logo0x logoCoinMarketCap logoCoin Metrics logoBybit logoLukka logo3Commas logoNexo logoTether logo
40+
Chains supported
1PB+
Blockchain data indexed
10B+
API calls / month
99.9%
Production uptime
01
Forget summing every Transfer

A wallet's balance is the number that has to be right.

Getting a balance yourself means an archive node per chain, replaying every transfer in and out, keeping a token list current and joining external feeds for labels and risk — and one missed log makes the number wrong. We indexed balance updates across every chain, so the answer is one query.

What you're doing
Build it yourself
Bitquery Address API
A wallet's current balance
Sum every transfer in and out
A single GraphQL query
Every token a wallet holds
Track and refresh a token list
Native + all tokens, built in
Balance at a past block
Replay logs up to that block
Point-in-time, one query away
Solana and EVM in one place
Two stacks, two schemas
One schema across chains
Whose address is this?
Buy and stitch a labels feed
Entity labels, built in
Is this wallet risky?
Hand-roll exposure tracing
Risk scoring & exposure flags
02
Delivery channels

Four ways to get address data — one schema underneath.

Design your query once in GraphQL, then read the exact same fields as GraphQL streams, Kafka, gRPC or a bulk cloud export. Pick the channel that fits your latency and volume — no second pipeline.

03
What you get per address

Everything you need to know about a wallet.

A single address resolves to its native balance, every token it holds, its balance at any past block, the entity behind it and a risk score — all from one schema. Filter by address, token, chain or time and read it as a query or a live stream.

What you getScopeDetails
ΞNative balanceETH · SOL · BNB · TRXThe gas-token balance for any wallet, on every supported chain, summed from balance updates
$Token balancesERC-20 · SPL · TRC-20Every fungible token a wallet holds, with symbol, contract and amount — no per-token RPC calls
TtBalance historyAny block · any datePoint-in-time balance at any past block or timestamp, for audit, backfill and reconciliation
LbEntity labelsExchange · MEV · ContractHuman-readable tags — Binance, Uniswap Router, MEV bots, bridges — for context on any address
RkRisk scoringExposure · SanctionsRisk flags and exposure paths to mixers, sanctioned wallets and scams for AML screening
FtFirst / last seenActivity · CounterpartiesWhen a wallet first and last transacted, its counterparties and total transfer count
+ NFT holdings, staking, transfers and source / destination of funds across 40+ chains
05
Build it this weekend

The address products people ship on us.

Each one is a filter on the same indexed balance, label and risk data — subscribe over Kafka or gRPC for live updates, or query GraphQL for dashboards and screening.

GraphQL

Portfolio tracker

Pull every native and token balance for a wallet across chains in one query, then value it in USD for a live multi-chain portfolio view.

BalanceUpdates
  balance: sum(of: BalanceUpdate_Amount)
Read the docs
GraphQL

Wallet risk & AML screening

Screen any address against entity labels and risk flags before you transact — surface exchange ties, mixer exposure and sanctioned counterparties.

Transfers {
  Receiver # label + risk
}
Explore Money Flow
Kafka · gRPC

Address labeling pipeline

Stream balance updates and transfers for a watchlist of addresses, attach entity labels and feed a real-time labeling or alerting pipeline.

subscribe BalanceUpdates
  where: { Address: "0x…" }
See Kafka streams

What teams say about our data

"We did a thorough search of the market for the best onchain data. Bitquery came out on top — and now powers all live prices across Nansen. We don't think of them as a vendor. They're a partner."

A
Alexander Karsten
Nansen
40+
Chains with balances, labels & risk
Any block
Point-in-time balance, one query
<100ms
Kafka & gRPC balance-stream latency

Bitquery does the hard work of parsing blockchain transaction data into a usable form so that we don't have to. We use their interface to diagnose issues with complex transactions and their analytics as a starting point for our own.

0x Protocol logo
Alex Knaggs
0x Protocol

They proved they had the technology to deliver sophisticated data solutions. We extended our support through the Binance X fellowship — building an open-source library of visualization widgets on their blockchain data.

Director, Binance X logo
Flora Sun
Director, Binance X

The complex raw data is available at different levels of detail and from different viewpoints — whether we need simple aggregated transfers or parameters for failed contract calls. The support is responsive, friendly and quick.

Backend Developer, Blockpit logo
Jan Dreske
Backend Developer, Blockpit

Partnering with Bitquery has been highly cost-effective — leveraging their established infrastructure rather than building our own let us rapidly expand our blockchain support and reach a much broader segment of on-chain users.

Co-Founder, Syla logo
Nick Christie
Co-Founder, Syla

Bitquery's products are very intuitive and easy to use. We currently use their products to obtain DEX-related trading and liquidity information, which saves us the manpower and tedious technical details required to develop our own system. Their excellent technical team deserves special praise; they provide near-24/7 support and resolve issues quickly. I greatly appreciate their products and work ethic.

Ourbit logo
Data Team
Ourbit

Bitquery provides the infrastructure we rely on every day. Fast, reliable, and comprehensive across the chains that matter to our business.

Webacy
Webacy
webacy.com
06
Pricing

Start free. Scale when you ship.

Query every blockchain on every plan — no chain is paywalled. Move to commercial when you need volume, SLAs and bulk datashares.

Developer
$0 / month
Free plan for developers or small projects.
  • All blockchains, all plans
  • 10 requests / minute
  • 2 streams for testing
  • GraphQL IDE access
Get started free
Most popular
Commercial
Custom
Tailored solutions for business and enterprise.
  • Scalable calls, no throttling
  • SQL, Cloud, Kafka & more
  • 24/7 engineering access
  • Dedicated onboarding & SLA
Talk to sales
Datashares
Custom
Bulk historical & real-time data on your cloud.
  • Snowflake, BigQuery, S3, Azure
  • No setup or infrastructure
  • Structured for AI agents & MCP
  • Audit data for custodians
Talk to sales
FAQ

Address & balance questions, answered.

How do I get a wallet's balance with Bitquery?
Query the BalanceUpdates dataset for any address and read sum(of: BalanceUpdate_Amount) per currency — native and token balances in one call. Sign up at ide.bitquery.io for an API key, then fetch balances for any wallet across 40+ chains from a single endpoint.
Can I get a historical balance at a past block or date?
Yes. Add a Block.Time filter with a till date or a block height to BalanceUpdates to read the exact balance as of any point in time — ideal for audits, reconciliation and backfilling portfolio charts.
Do you provide address labels and entity tags?
Yes. We attach human-readable entity labels — exchanges, contracts, MEV bots, bridges and more — to addresses, so you can tell whose wallet you're looking at. Labels and risk scoring are part of our Money Flow & Compliance data.
Can I screen an address for risk?
Yes. Combine entity labels with risk scoring and exposure paths to flag wallets tied to mixers, sanctioned addresses or scams — the data behind AML and KYT screening. Pair it with Coinpath money-flow tracing to follow the funds.
Which chains and tokens are supported?
40+ chains across EVM and Solana — Ethereum, BNB Chain, Base, Arbitrum, Polygon, Tron, Solana and more — with native balances plus every ERC-20, SPL and TRC-20 a wallet holds, all in one schema.
Do you support Solana wallet balances?
Yes. The Solana.BalanceUpdates dataset returns SOL and SPL-token balances for any Solana account over gRPC, WebSocket and GraphQL, summed from on-chain balance updates the same way as EVM chains.

Ship your wallet product this week.

Free API key, balances, labels and risk on every chain, no node to run. Fetch a wallet's balance and screen an address in your first call.

No credit card · 10K free points for your first month · All 40+ chains included