Skip to main content
1

Open account and get credentials

Open a free account at Open Account to get API access and credentials. After signup you can provide organization name, use case, required datasets and chains, and expected request volume if needed. Choose your delivery method (API, WebSocket, or archive).
In your account you receive Client ID and Client Secret (OAuth 2.0 Client Credentials), scopes (e.g. offline_access api), and rate limits based on your plan. Store credentials securely — use environment variables or a secret manager and never commit them to version control.
2

Generate JWT token

Use your Client ID and Client Secret to request a JWT from the UserService authentication endpoint (Client Credentials flow). Use the code examples for generating the JWT Access Token (.NET, Python, and more) to obtain an access token. The token is valid for 15 minutes; for production, use a token refresh mechanism (see Authorization). See Rate Limiting for quota management.
3

Make your first API call

Send the JWT in the Authorization header with every request. Query the latest Ethereum block to confirm connectivity:
curl -X POST https://api.blockdb.io/v1/evm/raw/blocks \
  -H "Authorization: Bearer $BLOCKDB_ACCESS_TOKEN" \
  -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, ensure your token is valid (tokens expire after 15 minutes — for production, use a refresh mechanism; see Authorization).
You received a JSON response with a data array containing block records.
4

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 April 6, 2026