Bitquery
Bitquery provides historical and real-time indexed data for over 40 blockchains through GraphQL APIs, Websockets, SQL, and cloud providers.
Verdict
Common use cases
- Track unique wallet addresses in a DeFi protocol
- Count transactions per block across multiple chains
- Merge live and historical token transfer data
- Filter on-chain metrics by contract address or time
- Evaluate new blockchain networks via streaming data
Integration
- Vendor
- Bitquery
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 18
- Composio slug
bitquery
Tools
- Aliases Metric
Tool to use graphql aliases to rename fields in the response for clarity and disambiguation. use when you need to query multiple metrics with identical field names in one call.
- Archive Database Query
Tool to query the archive database. use when you need full historical blockchain data (delayed by tens of minutes to hours).
- Combined Database Query
Tool to query the combined database, which merges archive and real-time databases. use when you need both historical and up-to-the-second blockchain data in one request.
- Conditional Metrics Snippet
Tool to generate a graphql metric snippet with conditional logic. use when you need to apply filters directly on metric calculations via the `if` attribute.
- Count Distinct Metric
Tool to use the count distinct metric to aggregate unique values for a field. use when you need to count the number of unique occurrences in a dataset.
- Count Metric
Tool to use the count metric to aggregate the number of records matching a graphql query. use when you need simple record counts.
- Database Selection
Tool to select the database (archive, realtime, combined) to query at the top level of a graphql request. use after determining whether you need live, historical, or combined blockchain data.
- Early Access Program Query
Tool to access streaming data across various blockchain networks for evaluation purposes. use when querying chains not available via the v2 endpoint; limited to real-time data only.
- Mempool Subscription
Tool to subscribe to real-time mempool updates for evm chains (ethereum, bnb, etc.). use after constructing your graphql subscription to stream pending transactions live.
- Network Selection
Tool to select the blockchain network for graphql queries. use before constructing dataset or metric queries to ensure the correct chain is targeted.
- Options Query
Tool to fetch graphql dataset options via schema introspection. use when you need to discover root-level query fields and their arguments before building queries.
- Price Asymmetry Metric
Tool to generate graphql priceasymmetry filter snippet. use when you need to filter trades based on price asymmetry metric.
- Quantile Metric
Tool to calculate quantiles to understand the distribution of numerical data. use when you need percentile metrics (e.g., median or quartiles) of a numerical field in a dataset.
- Realtime Database Query
Realtime database query
- Select By Metric
Tool to generate a graphql metric snippet filtering by its value using selectwhere. use when you need to include only metrics meeting specific value conditions (e.g., only positive sums).
- Statistics Metric
Tool to compute statistical metrics (mean, median, etc.) over one variable in a dataset. use when you need precise summary statistics in your graphql query.
- Sum Metric
Tool to calculate the sum of a specified field's values across defined dimensions. use when you need to aggregate total values in a dataset.
- Uniq Metric
Tool to estimate the count of unique values using the uniq metric. use when you need approximate or exact unique counts for analytics on blockchain datasets.
Setup
Setup guide
- 11. Log into your Bitquery account at bitquery.io and navigate to the API Keys section under your profile. 2. Generate a new API key and copy it to your clipboard. 3. In Switchy, open your workspace settings and click 'Connect MCP'. 4. Search for Bitquery, select it, then paste your API key into the authentication field. 5. Click 'Connect' — Switchy will validate the key against Bitquery's endpoint. 6. Open any Space and type '@Bitquery query the combined database for Ethereum transaction count in the last hour' to confirm the connection works. 7. If the MCP returns data, you're ready; if it errors, double-check the key hasn't expired and that your Bitquery plan includes API access.
What teammates see: by default, memories from Bitquery are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Ethereum Transaction Volume
@Bitquery query the combined database for Ethereum and return the count of all transactions in the last 24 hours.Open in a Space →
Unique Senders by Block
@Bitquery use the count distinct metric on the archive database to find unique sender addresses in Ethereum blocks 18000000 to 18001000.Open in a Space →
Real-Time DEX Trades
@Bitquery query the realtime database for Uniswap V3 swap events on Ethereum in the last 10 minutes, returning token pairs and amounts.Open in a Space →
Conditional Token Transfers
@Bitquery generate a conditional metric snippet that counts USDC transfers on Polygon where the amount exceeds 10,000 in the past hour.Open in a Space →
Multi-Chain Address Activity
@Bitquery use graphql aliases to query transaction counts for address 0xABC123 on both Ethereum and Binance Smart Chain in the last 7 days.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Bitquery show me the top 10 Ethereum addresses by transaction count in the last 24 hours
This example would query Bitquery's realtime database for Ethereum mainnet transactions, grouping by sender address and using the count metric to aggregate transaction volume. The response would return a ranked list showing addresses like '0x1234...abcd' with counts ranging from thousands to tens of thousands of transactions, depending on current network activity. The data reflects the most active wallets, exchanges, or smart contracts during the specified timeframe.
This demonstrates Bitquery's read-heavy analytics capabilities using the realtime database for recent blockchain data. Requires an API key with query permissions. Note that 'last 24 hours' queries hit the realtime database, which may have rate limits on complex aggregations — consider narrowing the time window if you encounter throttling.
@Bitquery query the archive database for all USDC transfers over $1M on Polygon between January 1-7, 2024
This example would use the archive database tool to retrieve historical ERC-20 transfer events for the USDC contract on Polygon, filtering by transfer amount and date range. The response would include transaction hashes, sender/receiver addresses, exact transfer amounts in USDC, block numbers, and timestamps. Expect results delayed by tens of minutes to hours compared to realtime data, as the archive database prioritizes completeness over immediacy.
This showcases Bitquery's historical data access for compliance or research use cases. The archive database is essential for queries beyond the realtime retention window. Be aware that archive queries can be slower and more expensive (in API credits) than realtime queries — the delay is a trade-off for accessing the full blockchain history.
@Bitquery compare daily unique active addresses across Ethereum, Polygon, and Arbitrum for the past week, then summarize which chain had the most growth
This example would use the combined database and count distinct metric to calculate unique addresses interacting with each chain daily, then leverage aliases to structure the multi-chain query clearly. The raw response would show seven days of unique address counts per chain — for instance, Ethereum might show 400K-500K daily, Polygon 200K-300K, Arbitrum 150K-250K. The AI would then analyze the trend lines to identify that, hypothetically, Arbitrum grew 18% week-over-week while Ethereum remained flat, making Arbitrum the growth leader.
This demonstrates Bitquery's synthesis power: pulling multi-chain metrics in one query, then pairing the data with AI reasoning to answer a strategic question. The combined database ensures you get both historical baseline and latest data. Watch for query complexity limits — comparing three chains over seven days is manageable, but scaling to dozens of chains or months may require batching requests.
Use-case deep-dives
When real-time blockchain data beats manual Discord scraping
A 6-person crypto fund tracks new token launches across Ethereum and BSC to spot early liquidity opportunities. They used to monitor Telegram channels and Dexscreener manually—slow, error-prone, and they'd miss launches overnight. Bitquery's Combined Database Query tool lets them pull both historical launch patterns and live mint events in one call, feeding a Slack channel that alerts the team within seconds. The Count Distinct Metric tool tracks unique deployer addresses to filter out spam contracts. This MCP is the right call if your team needs sub-minute latency on multi-chain events and can write basic GraphQL. If you're only tracking one chain or checking prices once a day, a simpler REST API or Dune dashboard is cheaper. For funds making time-sensitive calls on new assets, Bitquery's 18-tool suite turns blockchain noise into actionable signals without hiring a data engineer.
How a 3-person dev team built compliance reporting in a sprint
A DeFi protocol with 3 backend engineers needed to generate monthly compliance reports showing transaction volumes, unique users, and gas spent across their smart contracts. They were manually exporting CSVs from Etherscan and pivoting in Google Sheets—taking 2 days per report. The Archive Database Query tool gave them full historical access to their contract events, and the Count Metric and Count Distinct Metric tools let them aggregate totals and unique wallet counts in a single GraphQL call. They built a Python script that runs monthly, pulls the data via Bitquery's MCP, and outputs a PDF for their legal team. The trade-off: archive data lags by 30-60 minutes, so this doesn't work for live dashboards. If your compliance window is monthly or quarterly and you need auditable historical data without managing your own node, Bitquery's archive tooling is the fastest path from zero to automated reporting.
When cross-chain queries justify the API key overhead
A 5-person product team at an NFT aggregator wanted to compare minting trends across Ethereum, Polygon, and Solana to decide which chain to prioritize for their next feature. They needed 90 days of mint counts, unique minters, and average gas fees per chain. The Early Access Program Query tool gave them streaming access to Solana (not in the main v2 endpoint), and the Conditional Metrics Snippet tool let them filter out test mints and bot activity in the same query. They ran the analysis in an afternoon instead of stitching together three separate APIs. The catch: if you're only analyzing one chain or your data needs are static (like a one-time research report), paying for Bitquery's API key is overkill—use a free Dune query instead. But if your roadmap depends on multi-chain insights updated weekly, Bitquery's 18-tool MCP turns cross-chain data wrangling into a repeatable workflow your team can run without a blockchain specialist.
Frequently asked
What does the Bitquery MCP let me do in Switchy?
It lets your team query blockchain data across multiple networks using GraphQL — historical archives, real-time streams, or combined datasets. You can count transactions, track unique addresses, filter by contract events, and rename fields for clarity. Useful for crypto analytics, DeFi monitoring, or building dashboards without writing custom indexers.
Do I need a Bitquery paid plan to use this MCP?
Yes. The MCP authenticates via API key, which means you need an active Bitquery account with API access. Free-tier keys may hit rate limits quickly if your team runs frequent queries. Check your Bitquery dashboard for quota details before connecting it to Switchy.
Can the Bitquery MCP write data or submit transactions on-chain?
No. It's read-only. The MCP queries blockchain data (blocks, transactions, logs, token transfers) but cannot sign transactions, deploy contracts, or modify state. If you need to execute on-chain actions, use a wallet integration or web3 library separately.
How does this compare to querying Bitquery's API directly?
The MCP wraps Bitquery's GraphQL API so your team can ask natural-language questions instead of writing queries by hand. Switchy handles schema selection (archive vs. realtime), metric construction, and error handling. You lose some low-level control but gain speed and accessibility for non-developers.
Who on the team should connect the Bitquery MCP?
Whoever holds your Bitquery API key. That person connects it once in Switchy; the whole workspace inherits access. If multiple people need to run blockchain queries, share the connection rather than creating duplicate API keys — it keeps usage tracking simpler.