Explorer API

Explorer endpoints serve individual large JSON objects and a few related lists. JSON objects use the typical JSON key/value structure and you cannot limit the contents of objects (i.e. they are always sent in full). CSV format is not supported here.
Most explorer endpoints take different kinds of path arguments to define the object to return. This can be:
  • a regular hash for blocks, operations or accounts
  • the string head for the most recent on-chain object (e.g. the recent block or cycle)
  • a block height (a.k.a level in Tezos)
  • a sequence number for cycles and elections

Available Endpoints

Endpoint
Comment
GET /explorer/status
indexer status
GET /explorer/config/{id}
blockchain config at head or height
GET /explorer/tip
blockchain tip info
GET /explorer/protocols
list of deployed protocols
GET /explorer/bakers
baker list
GET /explorer/bakers/{hash} NEW
baker info
GET /explorer/bakers/{hash}/votes
baker proposals and ballots
GET /explorer/bakers/{hash}/endorsements
baker endorsements
GET /explorer/bakers/{hash}/delegations
baker delegations
GET /explorer/bakers/{hash}/income/{cycle}
baker income for cycle
GET /explorer/bakers/{hash}/rights/{cycle}
baker rights for cycle
GET /explorer/bakers/{hash}/snapshot/{cycle}
baker snapshot for cycle
GET /explorer/block/{id}
block info at head, hash, of height
GET /explorer/block/{id}/operations
list block operations at head, hash, or height
GET /explorer/op/{hash}
operation info
GET /explorer/account/{hash}
account info
GET /explorer/account/{hash}/contracts
list of contracts managed by this account
GET /explorer/account/{hash}/operations
account info with embedded list of related operations
GET /explorer/contract/{hash}
smart contract metadata
GET /explorer/contract/{hash}/calls
list contract calls
GET /explorer/contract/{hash}/script
smart contract code, storage and parameter spec
GET /explorer/contract/{hash}/storage
smart contract storage
GET /explorer/constant/{hash}
global constants
GET /explorer/bigmap/{id}
bigmap metadata
GET /explorer/bigmap/{id}/keys
list of bigmap keys
GET /explorer/bigmap/{id}/values
list of bigmap key/value pairs
GET /explorer/bigmap/{id}/{key}
single bigmap value
GET /explorer/bigmap/{id}/updates
list of bigmap updates
GET /explorer/bigmap/{id}/updates/{key}
list of bigmap updates related to a key
GET /explorer/cycle/{id}
cycle info for head or cycle
GET /explorer/election/{id}
election info
GET /explorer/election/{id}/{stage}/voters
list voters
GET /explorer/election/{id}/{stage}/ballots
list ballots
GET /metadata/{hash}[/{id}]
read account & token metadata
GET /metadata/schemas
list metadata schema names
GET /markets
list known markets
GET /markets/tickers
list market tickers
GET /markets/{exchange}
read exchange status
GET /markets/{exchange}/{market}
read market status
GET /markets/{exchange}/{market}/ticker
read single market ticker

Pagination and Sorting

List endpoints support pagination (e.g. to list historic transactions, contract calls, voters, etc). Two pagination methods are supported:
  • cursor + limit is the preferred method, it uses the row_id of the last result as argument to efficiently skips to the next available object
  • offset + limit is similar, but less efficient, it takes the count of objects seen so far and skips them when retrieving more results (as the chain grows, using offset in combination with descending order may return duplicates; we therefore recommend using the cursor method)
Default value for limit is 20 results on explorer endpoints and 500 results on tables, maximum is 500 and 50,000. Results are always sorted by row_id of the underlying table. Sort direction can be controlled by order (asc, or desc). If you require sorting by a different field, you have to do this client-side.

Indexer Status

GET https://api.tzpro.io/explorer/status
Returns the current indexer status, useful to check if the indexer is in sync with the blockchain.

HTTP Response

Field
Description
mode enum
Chain crawling mode (sync = live monitoring).
status enum
Indexer status (connecting, syncing, synced, failed).
blocks int64
Most recent block height seen by the connected Tezos node.
indexed int64
Most recent block height indexed.
progress float
Percentage of blocks indexed.

Example Request

curl "https://api.tzpro.io/explorer/status"
import (
"context"
"blockwatch.cc/tzstats-go"
)
// use default Mainnet client
status, err := tzstats.DefaultClient.GetStatus(context.Background())

Example Response

{
"mode": "sync",
"status": "synced",
"blocks": 626399,
"indexed": 626399,
"progress": 1
}
Returns the current indexer status, useful to check if the indexer is in sync with the blockchain.

Blockchain Config

GET https://api.tzpro.io/explorer/status
Fetches blockchain configuration parameters. This endpoint accepts head and a block height as path parameters, so you can access configurations of past protocols as well.

Example Request

curl "https://api.tzpro.io/explorer/config/head"
import (
"context"
"blockwatch.cc/tzstats-go"
)
// use default Mainnet client
config, err := tzstats.DefaultClient.GetConfig(context.Background())
Example response
{
"name": "Tezos",
"network": "Mainnet",
"symbol": "XTZ",
"chain_id": "NetXdQprcVkpaWU",
"genesis_time": "2018-06-30T16:07:32Z",
"block_hash": "BLWxEruWC23hx6EvBFxr8SYCE36H2Xq3hFA3kDFEhSjBhQx7QRj",
"timestamp": "2021-02-13T10:27:55Z",
"height": 1342864,
"cycle": 327,
"total_accounts": 1101579,
"funded_accounts": 999143,
"total_ops": 39596837,
"delegators": 93314,
"delegates": 426,
"rolls": 84949,
"roll_owners": 404,
"new_accounts_30d": 103666,
"cleared_accounts_30d": 15709,
"funded_accounts_30d": 112848,
"inflation_1y": 40335052.002298,
"inflation_rate_1y": 4.884188578147172,
"health": 98,
"supply": {
"row_id": 1342865,
"height": 1342864,
"cycle": 327,
"time": "2021-02-13T10:27:55Z",
"total": 866164181.179763,
"activated": 576359477.929109,
"unclaimed": 35095400.481071,
"liquid": 759883213.005411,
"circulating": 769208476.09957,
"delegated": 533114195.249729,
"staking": 684588680.629035,
"shielded": 0,
"active_delegated": 530853021.716629,
"active_staking": 680814744.486729,
"inactive_delegated": 2261173.5331,
"inactive_staking": 3773936.142306,
"minted": 102201165.989543,
"minted_baking": 32078464.975639,
"minted_endorsing": 70116902.006583,
"minted_seeding": 5199,
"minted_airdrop": 600.007321,
"minted_subsidy": 0,
"burned": 355582.82248,
"burned_double_baking": 132029.815883,
"burned_double_endorse": 31838.219485,
"burned_origination": 9211.19225,
"burned_allocation": 177021.9575,
"burned_storage": 1743.045,
"burned_explicit": 0,
"burned_seed_miss": 5481.637362,
"frozen": 61860304.599122,
"frozen_deposits": 60057024,
"frozen_rewards": 1801805.068634,
"frozen_fees": 1475.530488
},
"status": {
"mode": "sync",
"status": "synced",
"blocks": 1342864,
"indexed": 1342864,
"progress": 1
}
}
Fetches blockchain configuration parameters. This endpoint accepts head and a block height as path parameters, so you can access configurations of past protocols as well.

Explorer Tip

GET https://api.tzpro.io/explorer/tip
Returns info about the most recent block, indexer status, protocol deployments and supply statistics.
Example Request
curl "https://api.tzstats.com/explorer/tip"
import (
"context"
"blockwatch.cc/tzstats-go"
)
// use default Mainnet client
tip, err := tzstats.DefaultClient.GetTip(context.Background())
Example Response
{
"name": "Tezos",
"network": "Mainnet",
"symbol": "XTZ",
"chain_id": "NetXdQprcVkpaWU",
"genesis_time": "2018-06-30T16:07:32Z",
"block_hash": "BLWxEruWC23hx6EvBFxr8SYCE36H2Xq3hFA3kDFEhSjBhQx7QRj",
"timestamp": "2021-02-13T10:27:55Z",
"height": 1342864,
"cycle": 327,
"total_accounts": 1101579,
"funded_accounts": 999143,
"total_ops": 39596837,
"delegators": 93314,
"delegates": 426,
"rolls": 84949,
"roll_owners": 404,
"new_accounts_30d": 103666,
"cleared_accounts_30d": 15709,
"funded_accounts_30d": 112848,
"inflation_1y": 40335052.002298,
"inflation_rate_1y": 4.884188578147172,
"health": 98,
"supply": {
"row_id": 1342865,
"height": 1342864,
"cycle": 327,
"time": "2021-02-13T10:27:55Z",
"total": 866164181.179763,
"activated": 576359477.929109,
"unclaimed": 35095400.481071,
"liquid": 759883213.005411,
"circulating": 769208476.09957,
"delegated": 533114195.249729,
"staking": 684588680.629035,
"shielded": 0,
"active_delegated": 530853021.716629,
"active_staking": 680814744.486729,
"inactive_delegated": 2261173.5331,
"inactive_staking": 3773936.142306,
"minted": 102201165.989543,
"minted_baking": 32078464.975639,
"minted_endorsing": 70116902.006583,
"minted_seeding": 5199,
"minted_airdrop": 600.007321,
"minted_subsidy": 0,
"burned": 355582.82248,
"burned_double_baking": 132029.815883,
"burned_double_endorse": 31838.219485,
"burned_origination": 9211.19225,
"burned_allocation": 177021.9575,
"burned_storage": 1743.045,
"burned_explicit": 0,
"burned_seed_miss": 5481.637362,
"frozen": 61860304.599122,
"frozen_deposits": 60057024,
"frozen_rewards": 1801805.068634,
"frozen_fees": 1475.530488
},
"status": {
"mode": "sync",
"status": "synced",
"blocks": 1342864,
"indexed": 1342864,
"progress": 1
}
}

HTTP Request

GET /explorer/tip

HTTP Response

Field
Description
name string
Blockchain name (Tezos).
symbol string
Ticker symbol (XTZ).
network string
Network name (e.g. Mainnet, Granadanet, Sandbox).
chain_id hash
Chain hash.
genesis_time datetime
Genesis block timestamp.
block_hash hash
Current block hash.
timestamp datetime
Current block timestamp.
height int64
Current block height (level).
cycle int64
Current cycle.
total_accounts int64
Total number of on-chain accounts in existence.
funded_accounts int64
Total number on funded (non-zero) accounts.
total_ops int64
Total number of on-chain operations.
delegators int64
Current number of delegators (updated each block).
delegates int64
Current number of active delegates (updated each block).
rolls int64
Current number of network-wide rolls (updated each block).
roll_owners int64
Current number of network-wide roll owners (updated each block).
new_accounts_30d int64
Accounts created during the past 30 days.
cleared_accounts_30d int64
Accounts emptied during the past 30 days.
funded_accounts_30d int64
Accounts (re)funded (new and previously empty) during the past 30 days.
inflation_1y money
Absolute inflation in tez.
inflation_rate_1y float
Relative annualized inflation in percent.
health int64
Blockchain and consensus health indicator with range [0..100] based on recent 128 blocks (priority, endorsements, reorgs).
supply object
Coin supply statistics at current block height.
status object
Indexer status, embedded for efficiency.