Skip to main content
Chainbase provides multiple ways to query on-chain data. Choose the approach that fits your use case.

​
Quick Start: CLI

The fastest way to try Chainbase. Install the CLI and run a query in under a minute: 
npm install -g chainbase-cli
chainbase config set api-key YOUR_API_KEY

# Get ETH price
chainbase token price 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

# Check wallet balances
chainbase balance tokens 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# Trending crypto narratives (free, no API key)
chainbase tops trending
Get your API key at console.chainbase.com. For demo purposes, use the key “demo”.
Full CLI reference: CLI Documentation

​
Web3 API

REST API for structured queries — token metadata, balances, NFT ownership, ENS domains, and more. 
curl -X GET 'https://api.chainbase.com/v1/token/price?chain_id=1&contract_address=0xdAC17F958D2ee523a2206206994597C13D831ec7' \
  -H 'X-API-KEY: YOUR_API_KEY'
Available API suites:
  • Basic API — Block and transaction queries
  • Token API — Price, holders, metadata, transfers
  • NFT API — Metadata, ownership, rarity, transfers
  • Balance API — Native and ERC-20 token balances
  • Domain API — ENS resolution and reverse lookup
  • Label API — Address classification (exchange, whale, contract)
Full reference: Web3 API Documentation | API Reference

​
SQL API

Run custom SQL queries against Chainbase’s indexed on-chain data warehouse for complex analytics. 
SELECT block_timestamp, _from, _to, _value
FROM ethereum.erc20_transfer
WHERE contract_address = '0xdAC17F958D2ee523a2206206994597C13D831ec7'
  AND block_number > 19000000
LIMIT 10
Full reference: SQL API Documentation | API Reference

​
Tops API

Query crypto social intelligence — trending narratives, Twitter/X mentions, and sentiment signals. Free, no API key required. 
# Via CLI
chainbase tops trending

# Via API
curl -X GET 'https://api.chainbase.com/tops/v1/trending'
Full reference: Tops API Reference

​
Next Steps