Skip to main content
1

Request access and credentials

Contact [email protected] to provision your account and delivery method (API, WebSocket, archive).
You should receive API keys or storage/share permissions depending on your selection.
2

Make your first API call

Query the latest block to validate connectivity.
curl -sS -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  "https://api.blockdb.io/evm/blocks?order=desc&limit=1"

{
  "data": [
    {
      "block_number": 21345678,
      "block_hash": "0x...",
      "timestamp": "2025-11-11T10:00:00Z"
    }
  ],
  "next": null
}
3

Configure authentication and rate limits

Set up secure token management and understand your rate limits. Review Authorization for OAuth 2.0 setup and Rate Limiting for quota management.
Store API keys securely using environment variables or secret management systems. Never commit credentials to version control.
4

Explore the data catalog

Use the Dataset Index and EVM overview to find tables and schemas relevant to your use case.
5

Choose a delivery path

  • API/WebSocket for real-time pipelines
  • Archive delivery for historical backfills
  • Warehouse shares for analytics at scale
6

Verify and monitor

Refer to Data Lineage and Data Verification. Track status for uptime and incidents.
For bulk workloads, start with an archive backfill, then switch to API/WebSocket for deltas.