# Bitquery Docs

> Bitquery is a blockchain data platform for builders who need trades, prices, and history
> without running their own nodes. Query or stream data across 40+ chains through GraphQL,
> WebSocket, Kafka, and Solana gRPC — or ask in plain English via the MCP server for AI agents.

## Start here

- [**Bitquery in one page**](https://docs.bitquery.io/docs/start/bitquery-for-ai/) — the whole API as one self-contained page: endpoints, chains, cubes, datasets, rules and worked queries. Written to be pasted into an AI assistant's context. Raw markdown: https://docs.bitquery.io/docs/start/bitquery-for-ai/index.md
- [Docs home](https://docs.bitquery.io/) — platform overview and navigation
- [GraphQL IDE](https://ide.bitquery.io/) — run queries in the browser, no setup
- [First query in 5 minutes](https://docs.bitquery.io/docs/start/first-query/)
- [API keys & authentication](https://docs.bitquery.io/docs/authorization/how-to-generate/)
- [Starter queries](https://docs.bitquery.io/docs/start/starter-queries/) — tested queries by chain and data type, the same tree the IDE shows
- [Starter subscriptions](https://docs.bitquery.io/docs/start/starter-subscriptions/) — the real-time half of the same tree
- [MCP Server for AI agents](https://docs.bitquery.io/docs/mcp/mcp-server/)

## Endpoints, chains and datasets

Two generations of the API, with different schemas. Sending a query to the wrong one is the
most common mistake.

- **V2** — `https://streaming.bitquery.io/graphql`, and `wss://` for subscriptions. Covers
  Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, Robinhood Chain, Solana, Tron and
  Hyperliquid. Roots are capitalised: `EVM`, `Solana`, `Tron`, `Trading`.
- **V1** — `https://graphql.bitquery.io`. Everything else: Bitcoin, Litecoin, Bitcoin Cash,
  Dogecoin, Dash, Zcash, Cardano, Ripple, Stellar, Algorand, Filecoin, Avalanche, Celo,
  Cronos, Klaytn, Fantom, Moonbeam. Roots are lowercase: `bitcoin(network:)`,
  `ethereum(network:)`, `stellar(network:)`, `filecoin(network:)`.
- Ethereum, BSC, Tron and Polygon are **migrating off V1** — query them on V2.
- Every V2 root takes `dataset:` — `realtime` (default, recent window only), `archive` (full
  history), `combined` (both). Archive and combined need the historical data add-on.

- [Dataset options](https://docs.bitquery.io/docs/graphql/dataset/options/) — realtime vs archive vs combined
- [Archive dataset](https://docs.bitquery.io/docs/graphql/dataset/archive/) — how to query history
- [Data coverage & retention](https://docs.bitquery.io/docs/graphql/data-coverage-retention/) — how far back each cube goes, per chain
- [Endpoints](https://docs.bitquery.io/docs/start/endpoints/) — regional hosts for V1 and V2

## Trading data — prices, trades & OHLCV

Most teams building charts, bots, or dashboards start here. The **Trading cube** gives you
clean, MEV-filtered swap data with USD price, market cap, and supply on every row.

- [Trading data overview](https://docs.bitquery.io/docs/trading/trading-data-overview/) — when to use Trading cube vs chain-level APIs
- [Crypto Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/) — real-time DEX swaps across 9 chains in one query
- [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/) — token prices, pairs, and aggregated feeds
- [OHLC / candlestick (K-line) API](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/) — build charts and technical indicators
- [Market cap & supply fields](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-marketcap-api/) — FDV, circulating supply on trade rows
- [Traders API](https://docs.bitquery.io/docs/trading/crypto-trades-api/traders-api/) — wallet-level trade history and PnL-style analytics

For **historical OHLC older than ~30 days**, use chain-level [`DEXTradeByTokens`](https://docs.bitquery.io/docs/cubes/dextradesbyTokens) instead of the Trading cube.

### Query operators — filtering, aggregating and screening server-side

The Trading cube is an analytics engine, not just a feed. These operators let you answer
questions about a whole chain in one request instead of one query per token.

- [Screeners with `selectWhere`](https://docs.bitquery.io/docs/trading/query-operators/selectwhere-screeners/) — a `HAVING` clause: filter on computed aggregates server-side
- [Whole-population sweeps and pagination](https://docs.bitquery.io/docs/trading/query-operators/sweeps-and-pagination/) — `limitBy` returns one row per entity across the entire population
- [Argmax selectors](https://docs.bitquery.io/docs/trading/query-operators/argmax-selectors/) — `Field(maximum: Key)` is the first/last/peak-value primitive
- [Filters and operators reference](https://docs.bitquery.io/docs/trading/query-operators/filters-and-operators/) — operator sets per type, `any` as the only boolean combinator, per-cube branches
- [Statistics and concentration metrics](https://docs.bitquery.io/docs/trading/query-operators/statistics/) — correlation, quantiles, Gini, Nakamoto, and which are unsafe on price columns
- [Derived values with `calculate()`](https://docs.bitquery.io/docs/trading/query-operators/calculate-expressions/) — the `$` reference rule and the coercion traps
- [Wallet overlap with `array_intersect`](https://docs.bitquery.io/docs/trading/query-operators/array-intersect-wallet-overlap/) — which wallets traded every token in a set

A window defined **relative to each row's own event** (for example "hours 4–24 after each token's
own first trade") cannot be expressed in GraphQL. Pull per-interval rows for the whole population
and compute the relative window in your own store.

## Historical data & bulk uploads

Need a full backfill, data lake, or warehouse load — not row-by-row GraphQL?

- [Cloud datasets overview](https://docs.bitquery.io/docs/cloud/) — Parquet exports to S3, GCS, Snowflake, BigQuery
- [EVM historical dumps](https://docs.bitquery.io/docs/cloud/evm/) — Ethereum, Polygon, Base, and other EVM chains
- [Solana historical dumps](https://docs.bitquery.io/docs/cloud/solana/)
- [BSC / BNB Chain dumps](https://docs.bitquery.io/docs/cloud/bsc/)
- [Sample data on GitHub](https://github.com/bitquery/blockchain-cloud-data-dump-sample) — explore schemas before you buy

Contact [sales@bitquery.io](mailto:sales@bitquery.io) for custom historical exports and upload schedules.

## Streaming interfaces

- [GraphQL queries](https://docs.bitquery.io/docs/graphql/query/)
- [WebSocket subscriptions](https://docs.bitquery.io/docs/subscriptions/subscription/)
- [What does not survive streaming](https://docs.bitquery.io/docs/subscriptions/what-does-not-survive-streaming/) — `selectWhere`, `if` and most statistics are query-only, so not every query converts to a subscription
- [Kafka streaming](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)
- [Solana gRPC / Protobuf](https://docs.bitquery.io/docs/streams/protobuf/chains/Solana-protobuf/)

## Popular protocol APIs

- [Solana DEX trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)
- [Polymarket API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-api/)
- [Token holders API](https://docs.bitquery.io/docs/blockchain/Ethereum/token-holders/token-holder-api/)
- [Hyperliquid perpetuals](https://docs.bitquery.io/docs/perpetuals/hyperliquid/)
- [Phoenix perpetuals on Solana](https://docs.bitquery.io/docs/perpetuals/solana/phoenix-perpetuals-api/)

## Launchpads and memecoins

The most asked-about area. The IDE's Solana section carries ~15 Pump.fun
queries and ~15 Pump.fun streams, plus Raydium, Meteora and LetsBonk.fun — new
token creation, bonding curve progress, graduation to PumpSwap, ATH market cap,
top traders, creator fees, and first-buyer/sniper detection.

- [Pump.fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) — token creation, trades, migrations
- [Pump.fun API product page](https://bitquery.io/products/pumpfun-api) — delivery channels (GraphQL, WebSocket, gRPC, Kafka), latency, pricing, free trial
- [Pump.fun market cap & bonding curve](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API/) — graduation progress
- [Raydium DEX API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Raydium-DEX-API/)
- [Meteora dynamic bonding curve](https://docs.bitquery.io/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api/)
- [Four Meme on BSC](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/)
- [Robinhood Chain API](https://docs.bitquery.io/docs/blockchain/robinhood/) — trades, launchpads and real-time streams on Robinhood Chain
- [Pons Launchpad API](https://docs.bitquery.io/docs/blockchain/robinhood/pons-api/) — Pons V2 launches, bonding-curve trades, graduations, launch factory and locked liquidity
- [Robinhood New Pools & Trending Tokens API](https://docs.bitquery.io/docs/blockchain/robinhood/robinhood-new-pools-trending/) — new Uniswap pools, trending tokens, pair lookup and token search on Robinhood Chain
- [Sniper trading with Kafka](https://docs.bitquery.io/docs/streams/sniper-trade-using-bitquery-kafka-stream/)

## MCP for AI agents

- [MCP overview](https://docs.bitquery.io/docs/mcp/mcp-server/)
- [Claude Desktop setup](https://docs.bitquery.io/docs/mcp/claude-desktop/)
- [Cursor setup](https://docs.bitquery.io/docs/mcp/cursor/)
- [Build a trading agent](https://docs.bitquery.io/docs/mcp/build-a-trading-agent/)

## Full index

The whole corpus is one file of 5.6 MB, more than most AI fetchers read in one request.
The same 581 pages are also published in parts of under 1.5 MB each, grouped by topic:

- [Solana (65 pages, 1.0 MB)](https://docs.bitquery.io/llms-full-solana.txt)
- [Ethereum (69 pages, 0.6 MB)](https://docs.bitquery.io/llms-full-ethereum.txt)
- [Robinhood Chain (18 pages, 0.5 MB)](https://docs.bitquery.io/llms-full-robinhood.txt)
- [BSC, Base, Arbitrum, Optimism, Polygon and other EVM chains (85 pages, 0.8 MB)](https://docs.bitquery.io/llms-full-evm-chains.txt)
- [Tron, Bitcoin, Cardano, Algorand and the remaining chain pages (37 pages, 0.2 MB)](https://docs.bitquery.io/llms-full-other-chains.txt)
- [Use cases, trading APIs, examples, perpetuals, stablecoins and the API blog (119 pages, 1.2 MB)](https://docs.bitquery.io/llms-full-guides.txt)
- [Getting started, authorization, GraphQL, cubes, streams, gRPC, Kafka, cloud, MCP and everything else (188 pages, 1.4 MB)](https://docs.bitquery.io/llms-full-platform.txt)
- [Everything in one file (581 pages, 5.6 MB)](https://docs.bitquery.io/llms-full.txt)

Every page also has a raw markdown twin at its URL plus `index.md`, for example https://docs.bitquery.io/docs/start/first-query/index.md.