Claude Skill

---
name: blockdb
description: Query Ethereum / EVM on-chain data (blocks, transactions, transfers, DEX swaps, pools, prices, TVL) via the BlockDB REST API. Use whenever the user asks for on-chain or DeFi data.
---

# BlockDB

Call the BlockDB REST API to answer on-chain data questions.

## Rules
- Base URL: `https://api.blockdb.io/v1`
- Auth: send `Authorization: Bearer <BLOCKDB_API_KEY>` on every request (key from env).
- All endpoints are `POST` + JSON body (filters in the body). Exception: `GET /usage`.
- Response: `{ "data": [...], "cursor": "<string|null>", "page_count": <number> }`.
  Paginate by resending the body with `cursor` until it is null.
- Always include `chain_id` (Ethereum = 1). Prefer `from_block`/`to_block`.
- Never invent chain_id, exchange_id, pool_type_id, or addresses. Resolve IDs from
  https://docs.blockdb.io/api-reference/enumerations/overview.

## Picking an endpoint
- Raw chain data → /api-reference/evm/primitives/overview
- Transfers → /api-reference/evm/transfers/token-transfers
- Swaps → /api-reference/evm/swaps/overview
- Prices → /api-reference/evm/prices/overview
- Full index → /api-reference/evm/overview

## Example
POST https://api.blockdb.io/v1/evm/transfers/token-transfers
{ "chain_id": 1, "from_block": 19000000, "to_block": 19001000, "limit": 250 }