BlockDB Quick Start Guide — Blockchain Data API

Just want the data? 10+ years of Ethereum datasets are published for free on Hugging Face — no account or API key needed. See Free Research Datasets.

Get an API key

API access is available on a custom plan. Email support@blockdb.io with the datasets and chains you need — your API key is issued when your plan is activated.

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.

Call the API with your key

Use Authorization: Bearer <API_KEY> on every request. No token endpoint and no refresh flow—the key issued to you 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, "page_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.

Explore the data catalog

Use the Dataset Index 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 28, 2026

About BlockDB

Real-Time Delivery

Archive Delivery

Quick Start Guide