Ethereum API Documentation
This page is your hub for Ethereum on‑chain analytics—transactions, token balances and holders, DEX trades/liquidity, blocks, events, fees, mempool, and NFTs—available via GraphQL APIs and real‑time streams.
Need help crafting a query or subscription? Message us on support.
What is the Bitquery Ethereum API?​
It’s a GraphQL interface over curated, indexed Ethereum data. Write concise queries instead of building and maintaining your own indexer.
What can you build with it?​
Track wallet portfolios and token holders, monitor DEX price/volume and liquidity events, analyze gas and fees, stream mempool activity, compute KPIs over blocks/transactions, and power dashboards or trading systems with real‑time data.
How is it different from raw Ethereum RPC?​
Ethereum RPC
- Low‑level JSON‑RPC that returns raw node data
- No historical indexing, joins, or analytics out of the box
- Best for transaction submission and node-level introspection
Bitquery Ethereum API
- Pre‑indexed, enriched datasets exposed via GraphQL
- Powerful filtering, joins, aggregations, and subscriptions
- Ideal for analytics, monitoring, dashboards, and backtesting without running infra
WebSockets and Webhooks​
Most queries can be turned into live streams by switching query to subscription, and consumed over WebSocket. See examples and code snippets here.
DEX Trades​
Query and subscribe to on‑chain swaps, OHLCV, liquidity events, pools, and per‑wallet trading activity across major EVM DEXes.
Token Holders​
Identify top holders, concentration, new/active holders, and changes over time.
Transactions​
Inspect transaction metadata, status, value flows, method signatures, and more.
Transfers​
Follow ERC‑20 token flows and compute supply‑side metrics.
Blocks​
Build time‑series metrics from block headers, miner/validator stats, and base fee changes.
Balances​
Get real‑time and historical balances for addresses and tokens.
Events​
Query decoded contract logs with precise filtering on topics and parameters.
Fees​
Analyze gas usage, base fee dynamics, and transaction cost distributions.
Mempool​
Monitor pending transactions to react before inclusion.
NFT​
Fetch collections, ownership, transfers, trades, and metadata.