🔑 Chain-Data API

Query BB84 L2
Chain Data

Register your company, generate an API key, and read balances, blocks and transactions from a simple REST API — no node to run, no raw JSON-RPC required.

🏢 Company details

Every API key is tied to a company so we can reach you about rate limits, incidents, or abuse. This is a self-service form — no manual approval, your key is issued immediately.

API reference
Base URL: https://bb84.com/v1 · all endpoints require the X-API-Key header · JSON responses.

Authentication

Send your key on every request:

curl https://bb84.com/v1/status \
  -H "X-API-Key: bb84_live_YOUR_KEY"
🔷
Rate limit: 120 requests/minute per key. Exceeding it returns HTTP 429.

Endpoints

Method & PathDescription
GET /v1/statusChain ID, latest block number, current gas price
GET /v1/block/latestLatest block — number, hash, timestamp, tx count
GET /v1/balance?address=0x..Native ETH balance of an address (wei + ETH)
GET /v1/token-balance?token=0x..&address=0x..ERC-20 balance of an address for any token contract
GET /v1/tx?hash=0x..Transaction details + confirmation status

Example

curl "https://bb84.com/v1/balance?address=0xYourAddress" \
  -H "X-API-Key: bb84_live_YOUR_KEY"

# {"address":"0x...","balanceWei":"1000000000000000000","balanceEth":"1.000000000000000000"}

🔒 Revoke a key

Lost or compromised key? Revoke it — you'll need to register a new one. Revoking requires the key itself as proof of ownership.

FAQ
Common questions about the Developer API.
Is this API free?+
Yes. BB84 is an experimental testnet — the API is free, rate-limited to 120 requests/minute per key.
Can I have multiple keys?+
Yes — register once per use case (e.g. staging vs. production) using different contact emails.
Need something the API doesn't cover?+
For anything beyond simple reads — full JSON-RPC access is available at https://bb84.com/rpc, see the docs. For custom needs, reach out via the support button.

Support Ticket

Question, bug report or feedback — we'll get back to you by email.