Free, static, CORS-enabled JSON datasets for blockchain builders, rebuilt nightly from public sources. No API key, no backend, no rate limit beyond GitHub Pages.
Built by Blockchain Lab — blockchainlab.com
- Docs: https://blockchains.github.io/blockchainlab-api/
- Catalogue: https://blockchains.github.io/blockchainlab-api/v1/index.json
- OpenAPI 3.1:
openapi.yaml· interactive
| Endpoint | Rows | What | Source | Schema |
|---|---|---|---|---|
bips |
213 | Bitcoin Improvement Proposals index parsed from bitcoin/bips. | github.com/bitcoin/bips | schema |
bridges |
260 | Cross-chain and canonical bridges ranked by TVL (DefiLlama bridge categories). | DefiLlama protocols (bridge categories) | schema |
chains |
2787 | EVM chain registry: chain IDs, native currency, public RPC endpoints and explorers. | chainid.network (ethereum-lists/chains) | schema |
chains-tvl |
330 | DeFi TVL by chain (USD). Snapshot from DefiLlama. | DefiLlama | schema |
dex-volumes |
300 | DEX trading volume by protocol (top 300 by 24h). Snapshot from DefiLlama. | DefiLlama overview/dexs | schema |
eips |
593 | EIPS index (number, title, status, type, category) parsed from ethereum/EIPs. | github.com/ethereum/EIPs | schema |
ercs |
617 | ERCS index (number, title, status, type, category) parsed from ethereum/ERCs. | github.com/ethereum/ERCs | schema |
events |
7 | Upcoming blockchain events from the Blockchain Lab feeds. | Blockchains/blockchainlab-feeds (ethglobal.com/events; devpost.com (blockchain hackathons)) | schema |
fees |
300 | Protocol fees by protocol (top 300 by 24h). Snapshot from DefiLlama. | DefiLlama overview/fees | schema |
glossary |
80 | Plain-language blockchain glossary from blockchainlab.com (concepts, protocol profiles, failure classes, stack layers). | blockchainlab.com/learn/glossary | schema |
grants |
22 | Directory of blockchain ecosystem grant / funding programmes with official links. Curated by Blockchain Lab; link status re-checked nightly. No amounts are listed — read each programme's own page. | Official programme pages (curated) | schema |
hackathons |
4 | Open and upcoming blockchain hackathons (Devpost, ETHGlobal). | Blockchains/blockchainlab-feeds (devpost.com/api/hackathons (theme Blockchain, open+upcoming); ethglobal.com/events (future hackathons); X posts (leads only)) | schema |
l2-metrics |
100 | Ethereum L2/L3 scaling projects: stage, category, stack, risk summary and Total Value Secured breakdown. From L2BEAT. | L2BEAT public API | schema |
protocols |
500 | Top 500 DeFi protocols by TVL (USD), excluding CEXs. Snapshot from DefiLlama; not investment advice. | DefiLlama | schema |
rpc-health |
34 | Health of popular free public RPC endpoints (EVM chains, Solana, Bitcoin): reachability, latency, block lag vs best endpoint, chain-ID check. Probed from a GitHub Actions runner (US) at build time. | Blockchain Lab probe (GitHub Actions) | schema |
sanctioned-addresses |
1060 | Digital currency addresses on the US Treasury OFAC SDN list, per asset. Extracted daily from the official SDN XML by github.com/0xB10C. Compliance screening aid only — verify against the official list. | OFAC SDN list via 0xB10C/ofac-sanctioned-digital-currency-addresses | schema |
security-incidents |
1293 | Public record of crypto hacks and exploits: date, protocol, technique, classification, amount lost/returned. From DefiLlama's hacks database. | DefiLlama hacks | schema |
stablecoins |
426 | Stablecoins by circulating supply with price, peg mechanism and 1d/7d/30d supply change. Snapshot from DefiLlama. | DefiLlama stablecoins | schema |
whitepapers |
607 | Blockchain Lab research corpus — whitepaper metadata (no paper text). Original sources linked. | Blockchain Lab /api/v1/papers | schema |
yields |
500 | Top 500 DeFi yield pools by TVL (>= $10m) with APY, base/reward split, IL risk. Snapshot from DefiLlama; APYs change constantly and are not advice. | DefiLlama yields | schema |
Versioning: /v1/ path, semver schema_version in every envelope, JSON Schema per dataset, nightly job refuses to publish data that fails validation. See CHANGELOG.md.
Typed SDKs: npm i github:Blockchains/blockchainlab-sdk (TypeScript) · pip install "git+https://github.com/Blockchains/blockchainlab-sdk#subdirectory=python" — see blockchainlab-sdk.
Every file uses the same envelope:
{ "dataset": "chains", "api_version": "v1", "schema_version": "1.1.0", "schema_url": "https://…/v1/schemas/chains.schema.json", "generated_at": "ISO-8601", "source": "...", "source_url": "https://...", "count": 0, "data": [ ... ] }# Base mainnet RPCs + explorer
curl -s https://blockchains.github.io/blockchainlab-api/v1/chains.json | jq '.data[] | select(.chainId==8453)'
# Top 10 DeFi protocols by TVL (DefiLlama snapshot)
curl -s https://blockchains.github.io/blockchainlab-api/v1/protocols.json | jq '.data[:10][] | {name, tvl_usd}'
# Final ERCs
curl -s https://blockchains.github.io/blockchainlab-api/v1/ercs.json | jq '.data[] | select(.status=="Final") | "ERC-\(.number) \(.title)"'const { data } = await (await fetch("https://blockchains.github.io/blockchainlab-api/v1/whitepapers.json")).json();
console.log(data.filter(p => p.topics?.includes("Proof of stake")).map(p => p.title));scripts/build.mjs (Node 20, zero dependencies) runs nightly in GitHub Actions, fetches each public source, normalises it and commits v1/*.json. If a source fails, the previous file is kept and flagged stale in index.json.
- chains — chainid.network (ethereum-lists/chains, the data behind chainlist.org); RPCs with
${API_KEY}placeholders removed. - protocols / chains-tvl — DefiLlama public API. CEXs excluded from protocols. Snapshot, not advice.
- hackathons / events — reused from Blockchains/blockchainlab-feeds (Devpost, ETHGlobal), not re-scraped.
- whitepapers — metadata from Blockchain Lab's research corpus API; each row links to the original source and to the Blockchain Lab whitepaper page.
- glossary — Blockchain Lab's concept, protocol, failure-class and stack-layer pages (/learn/glossary).
- grants — curated list of official programme pages (
data/grants.json); link status re-checked on every build. No amounts are listed — they change; read the programme page. - eips / ercs / bips — parsed from front-matter in ethereum/EIPs, ethereum/ERCs and bitcoin/bips.
Run locally: node scripts/build.mjs && python3 scripts/openapi.py
| blockchainlab-tools | Client-side dev tools: gas, units, ABI, tx decoder, ENS, merkle, storage slots |
| blockchainlab-mcp | MCP server + JS SDK for AI agents over this API |
| blockchainlab-lens | Explain any Etherscan address / tx with the tools |
| blockchainlab-labs | 30 hands-on Foundry labs with CI |
| blockchain-dev-roadmap | Curated developer roadmap |
| blockchain-interview-questions | Interview question bank |
| blockchainlab-feeds | Hackathon / event / X-intel feeds |
For AI agents and builders: read
AGENTS.md(setup, commands, structure, rules),llms.txt(doc map) and the machine-readableblocks.json(schema). How all Blockchains blocks fit together: Build with Blocks · org catalogue: https://blockchains.github.io/blocks.json.
What it exports
| Export | Type | Install / access |
|---|---|---|
GET /v1/{dataset}.json |
http | curl -s https://blockchains.github.io/blockchainlab-api/v1/chains.json |
GET /v1/index.json |
http | catalogue: dataset, url, schema, count, generated_at, stale |
GET /v1/schemas/{dataset}.schema.json |
http | JSON Schema per dataset |
openapi.yaml |
file | https://blockchains.github.io/blockchainlab-api/openapi.yaml |
Minimal example (live endpoints, checked 2026-10-04)
# Base mainnet RPCs + explorer
curl -s https://blockchains.github.io/blockchainlab-api/v1/chains.json | jq '.data[] | select(.chainId==8453) | {name, rpc: .rpc[:3]}'
# Healthy public RPCs for Ethereum, fastest first
curl -s https://blockchains.github.io/blockchainlab-api/v1/rpc-health.json | jq '[.data[] | select(.chain=="ethereum" and .healthy)] | sort_by(.latency_ms) | .[:3] | map(.url)'Inputs → outputs
- In:
dataset(path segment) bips, bridges, chains, chains-tvl, dex-volumes, eips, ercs, events, fees, glossary, grants, hackathons, l2-metrics, protocols, rpc-health, sanctioned-addresses, security-incidents, stablecoins, whitepapers, yields - Out:
envelope(JSON) {dataset, api_version, schema_version, schema_url, generated_at, source, source_url, count, data[]}
Composes with
- Blockchains/blockchainlab-sdk: typed TS/Python client generated from these schemas
- Blockchains/blockchainlab-mcp: 43 MCP tools, many backed by these datasets
- Blockchains/blockchainlab-tools: browser tools read chains and EIP/ERC/BIP data from here
- Blockchains/blockchains.github.io: hub pages and AI briefs are built on it
- Blockchains/blockchainlab-feeds: source of the hackathons and events datasets
Versioning & stability: stable. Path-versioned (/v1/). Every envelope carries a semver schema_version; breaking changes bump the major and get a new path. The nightly job refuses to publish data that fails its JSON Schema; if a source fails, the previous file is kept and flagged stale in index.json. See CHANGELOG.md.
Code: MIT. Data: belongs to each named source — check its terms. Glossary text © Blockchain Lab; please attribute and link blockchainlab.com.
None for consumers: static JSON over GitHub Pages with Access-Control-Allow-Origin: *, no key, no rate-limit token. The nightly build uses only public sources and the default GITHUB_TOKEN.
Issues and pull requests are welcome. Please read the contributing guide, code of conduct and security policy first.
Built by Blockchain Lab — blockchainlab.com