ValidatorsContractsGovernanceStats

Developer API

Access BlockMaze Testnet data programmatically

REST API

Access all blockchain data via standard HTTP GET requests. Responses are JSON with an {error, message, data} envelope.

API Keys

Register for a free API key to identify your application. Keys are prefixed with bmz_live_ for easy identification.

Base URL

http://localhost:2100 — all endpoints are relative to this base. Use the X-API-Key header to authenticate.

Authentication

Get Your API Key

Rate Limits

Free Plan

200 requests per minute · No burst limit

Response Format

All responses: { error, message, data }

Endpoint Reference

GET/api/evm/blocks

List Layer 1 blocks (paginated)

Params: page, limit

GET/api/evm/blocks/{hash}

Get Layer 1 block by hash or number

Params: hash (path)

GET/api/cosmos/blocks

List native blocks (paginated)

Params: page, limit

GET/api/cosmos/blocks/{hash}

Get native block by hash

Params: hash (path)

Code Examples

Fetch latest blocks

curl "http://localhost:2100/api/evm/blocks?page=1&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Get transaction by hash

curl "http://localhost:2100/api/evm/txs/0xabc123..." \
  -H "X-API-Key: YOUR_API_KEY"

Search by token name

curl "http://localhost:2100/api/search?q=BMZ" \
  -H "X-API-Key: YOUR_API_KEY"

Network stats

curl "http://localhost:2100/api/cosmos/stats" \
  -H "X-API-Key: YOUR_API_KEY"