Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Video walkthrough

BlockDB Free Account, API Key & First Query in 2 Minutes — sign up, create a key, and run your first query:
1

Open account and create an API key

Open a free account at accounts.blockdb.io to create an API key.
You can have up to five active keys per account—use separate keys for production and staging when possible. Store keys only in environment variables or a secret manager (for example BLOCKDB_API_KEY) and never commit them to version control. See Authorization for key rotation and Rate Limiting for RPS and compute units.
2

Call the API with your key

Use Authorization: Bearer <API_KEY> on every request. No token endpoint and no refresh flow—the key from the dashboard is the credential. Example: query a small block range on Ethereum mainnet:
curl -X POST https://api.blockdb.io/v1/evm/raw/blocks \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chain_id": 1,
    "from_block": 21000000,
    "to_block": 21000001,
    "limit": 1
  }'
A successful response returns { "data": [...], "cursor": null, "count": 1 }. If you get a 401, confirm the key is copied correctly, not revoked, and still allowed for that dataset (see Authorization).
You received a JSON response with a data array containing block records.
3

Explore the data catalog

Use the Dataset Index and EVM Overview to find the tables and schemas relevant to your use case. Each dataset page documents available fields, lineage keys, and example queries.
For bulk workloads, start with an archive backfill, then switch to API/WebSocket for deltas.
Last modified on May 12, 2026