Base API Documentation
Overview
In this section we will see how to fetch data on tokens, transactions, DEXs like Aerodrome and Uniswap, liquidity pools, and slippage data on Base via APIs and Streams.
If you need help getting data on Base, reach out to support.
What is Base API?
Bitquery Base APIs help you fetch onchain data like trades, transactions, balances, token holders, liquidity pools, and slippage data etc using graphQL query.
What are capabilities of Bitquery Base API?
Bitquery Base APIs are very flexible; you can fetch trade, transaction, balance, liquidity, and slippage information for a period, for a specific wallet, and join with other information.
Difference between Base RPC and Bitquery Base API?
| Base RPC | Bitquery Base API |
|---|---|
| JSON-RPC endpoint exposing raw EVM on-chain state and transactions | GraphQL endpoint over pre-indexed, parsed Base chain data (token transfers, DEX trades, logs, calls, etc.) |
| No built-in history or analytics—any indexing/aggregation you build or outsource | Historical data, joins, aggregations & real-time subscriptions |
| Ideal for submitting transactions | Great for real-time data and historical backtesting without running your own indexer |
Does Bitquery support Base Websocket and Webhooks?
Bitquery supports websocket and webhooks; you can convert most GraphQL APIs into GraphQL streams by changing the word query to subscription. You can monitor this data via a websocket. More docs and code samples are available here.
Quick start
Run this minimal GraphQL query to fetch the latest 5 DEX trades on Base:
query LatestBaseTrades {
EVM(network: base) {
DEXTrades(limit: { count: 5 }, orderBy: { descending: Block_Time }) {
Block { Time }
Trade {
Dex { ProtocolName }
Buy { AmountInUSD Currency { Symbol } }
Sell { AmountInUSD Currency { Symbol } }
}
Transaction { Hash }
}
}
}
DEX and Protocol APIs
Base Slippage API
Get slippage and price impact data for Base DEX pools. Understand price impact and liquidity depth for token swaps, calculate maximum input amounts at different slippage tolerances, and monitor real-time slippage data across all DEX pools on Base.
Base Liquidity API
Monitor real-time liquidity changes, track pool reserves, and analyze liquidity depth for token pairs on Base DEX pools. Track when liquidity is added or removed, monitor pool health and depth, and analyze liquidity patterns across different pools.