Ergo Explorer API v1

High-performance blockchain explorer API - Compatible with ergoplatform.com API

Quick Navigation:

Blocks Transactions Addresses Boxes Tokens Mempool Network Assets Utils Search

Blocks (5 endpoints)

GET /api/v1/blocks
List blocks with pagination. Params: offset, limit, sortBy, sortDirection
GET /api/v1/blocks/{id}
Get block by ID or height with full details including transactions
GET /api/v1/blocks/headers
Get block headers only (lightweight). Params: offset, limit
GET /api/v1/blocks/stream/summary
Stream block summaries starting from minHeight. Params: minHeight, limit
GET /api/v1/blocks/byMiner/{minerPk}
Get blocks mined by a specific miner public key

Transactions (7 endpoints)

GET /api/v1/transactions
List recent transactions. Params: offset, limit
GET /api/v1/transactions/{id}
Get transaction by ID with full inputs, outputs, and data inputs
GET /api/v1/transactions/byBlockId/{blockId}
Get transactions in a specific block
GET /api/v1/transactions/byInputsScriptTemplateHash/{hash}
Get transactions by input script template hash
GET /api/v1/transactions/byGlobalIndex/stream
Stream transactions by global index. Params: minGix, limit
POST /api/v1/transactions/submit
Submit a signed transaction to the network

Addresses (4 endpoints)

GET /api/v1/addresses/{address}
Get address summary: balance, transaction count, first/last seen
GET /api/v1/addresses/{address}/transactions
Get transactions for an address. Params: offset, limit
GET /api/v1/addresses/{address}/balance/confirmed
Get confirmed balance for an address
GET /api/v1/addresses/{address}/balance/total
Get total balance (confirmed + unconfirmed) for an address

Boxes (UTXOs) (14 endpoints)

GET /api/v1/boxes/{boxId}
Get box by ID with assets
GET /api/v1/boxes/byAddress/{address}
Get all boxes for an address. Params: offset, limit, spent
GET /api/v1/boxes/unspent/byAddress/{address}
Get unspent boxes for an address
GET /api/v1/boxes/byTokenId/{tokenId}
Get all boxes containing a specific token
GET /api/v1/boxes/unspent/byTokenId/{tokenId}
Get unspent boxes containing a specific token
GET /api/v1/boxes/byErgoTree/{ergoTree}
Get boxes by ErgoTree script
GET /api/v1/boxes/unspent/byErgoTree/{ergoTree}
Get unspent boxes by ErgoTree script
GET /api/v1/boxes/byErgoTreeTemplateHash/{hash}
Get boxes by ErgoTree template hash
GET /api/v1/boxes/unspent/byErgoTreeTemplateHash/{hash}
Get unspent boxes by ErgoTree template hash
GET /api/v1/boxes/unspent/unconfirmed/byAddress/{address}
Get unconfirmed (mempool) boxes for an address
POST /api/v1/boxes/search
Search boxes by ergoTreeTemplateHash and registers
POST /api/v1/boxes/unspent/search
Search unspent boxes by ergoTreeTemplateHash and registers
POST /api/v1/boxes/unspent/search/union
Search unspent boxes by multiple ErgoTrees (union)

Tokens (5 endpoints)

GET /api/v1/tokens
List tokens with pagination and search. Params: offset, limit, search
GET /api/v1/tokens/{tokenId}
Get token details including holder count
GET /api/v1/tokens/bySymbol/{symbol}
Get tokens by name/symbol
GET /api/v1/tokens/{tokenId}/holders
Get token holders with balances. Params: offset, limit
POST /api/v1/tokens/search
Search tokens by name/description. Body: { query, offset, limit }

Mempool (5 endpoints)

GET /api/v1/mempool/transactions
Get unconfirmed transactions from mempool
GET /api/v1/mempool/transactions/byAddress/{address}
Get mempool transactions for an address
POST /api/v1/mempool/transactions/submit
Submit a transaction to the mempool
GET /api/v1/mempool/boxes/unspent
Get unspent boxes from mempool
GET /api/v1/mempool/boxes/unspent/byAddress/{address}
Get unspent mempool boxes for an address

Network & Stats (5 endpoints)

GET /api/v1/info
Get API info and network summary
GET /api/v1/stats
Get network statistics (24h metrics)
GET /api/v1/networkState
Get current network state (height, difficulty, sync status)
GET /api/v1/networkStats
Get extended network statistics (hourly, daily, weekly)
GET /api/v1/epochs/params
Get current epoch parameters and voting info

Assets (1 endpoint)

GET /api/v1/assets/byAddress/{address}
Get all token assets held by an address with balances

Utils & ErgoTree (2 endpoints)

POST /api/v1/ergoTree/convert
Convert address to ErgoTree. Body: { address }
POST /api/v1/ergoTree/toAddress
Convert ErgoTree to address. Body: { ergoTree }
GET /api/v1/search?query={query}
Search for blocks, transactions, addresses, boxes, or tokens
Total: 49 API endpoints | All endpoints support CORS | Rate limit: 1000 req/min | Response format: JSON