Chain

Blockchain Tip

GET /explorer/tip

Returns info about the most recent block, indexer status, running counters for relevant on-chain entities as well as a list of protocol deployments and supply statistics.

Schema

Field	Description
name string	Blockchain name (Tezos).
network string	Network name (e.g. Mainnet, Ghostnet, Sandbox).
symbol string	Ticker symbol (XTZ).
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.
protocol hash	Current protocol.
total_accounts int64	Total number of on-chain accounts in existence.
total_contracts int64	Total number of on-chain contracts in existence.
total_rollups int64	Total number of on-chain rollups in existence.
funded_accounts int64	Total number on funded (non-zero) accounts.
dust_accounts int64	Number of dust accounts (0 < balance < 1 tez)
dust_delegators int64	Number of dust delegators
ghost_accounts int64	Number of unfunded accounts who own tokens.
total_ops int64	Total number of on-chain operations.
delegators int64	Current number of delegators.
stakers int64	Current number of stakers.
bakers int64	Current number of active bakers.
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.

Response

{
    "name": "Tezos",
    "network": "Mainnet",
    "symbol": "XTZ",
    "chain_id": "NetXdQprcVkpaWU",
    "genesis_time": "2018-06-30T16:07:32Z",
    "block_hash": "BMZVAcepCAtq6PjKBKSQB2B9QhrFCa3ZoJAjdNzMqbXaGStuT1g",
    "timestamp": "2024-01-31T14:38:29Z",
    "height": 5020337,
    "cycle": 699,
    "protocol": "PtNairobiyssHuh87hEhfVBGCVrK3WnS8Z2FT4ymB5tAa4r1nQf",
    "total_accounts": 4961771,
    "total_contracts": 191995,
    "total_rollups": 11,
    "funded_accounts": 2560546,
    "dust_accounts": 848437,
    "dust_delegators": 16226,
    "ghost_accounts": 2077976,
    "total_ops": 891700659,
    "delegators": 183371,
    "stakers": 0,
    "bakers": 401,
    "new_accounts_30d": 99167,
    "cleared_accounts_30d": 5246,
    "funded_accounts_30d": 75591,
    "inflation_1y": 43251909.714076,
    "inflation_rate_1y": 4.567952711796725,
    "health": 96,
    "supply": {
        "row_id": 5020337,
        "height": 5020337,
        "cycle": 699,
        "time": "2024-01-31T14:38:29Z",
        "total": 990107370.857053,
        "activated": 743432931.638309,
        "unclaimed": 20885666.374391,
        "circulating": 969221704.482662,
        "liquid": 900108530.047285,
        "delegated": 570234223.514414,
        "staking": 0,
        "unstaking": 0,
        "shielded": 355.002637,
        "active_stake": 675251353.339412,
        "active_delegated": 0,
        "active_staking": 0,
        "inactive_delegated": 0,
        "inactive_staking": 0,
        "minted": 228166026.783267,
        "minted_baking": 91598423.456512,
        "minted_endorsing": 129921605.546401,
        "minted_seeding": 11111.125,
        "minted_airdrop": 28700.007321,
        "minted_subsidy": 6388063.75,
        "burned": 2377253.938914,
        "burned_double_baking": 228687.464089,
        "burned_double_endorse": 31838.219485,
        "burned_origination": 19564.47575,
        "burned_allocation": 299392.15,
        "burned_storage": 1240559.6895,
        "burned_explicit": 144248.089281,
        "burned_seed_miss": 227134.347399,
        "burned_offline": 185829.50341,
        "burned_rollup": 0,
        "frozen": 69113174.435377,
        "frozen_deposits": 69113174.435377,
        "frozen_rewards": 0,
        "frozen_fees": 0,
        "frozen_bonds": 0,
        "frozen_stake": 0,
        "frozen_baker_stake": 0,
        "frozen_staker_stake": 0
    },
    "status": {
        "mode": "sync",
        "status": "synced",
        "blocks": 5020338,
        "finalized": 5020337,
        "indexed": 5020337,
        "progress": 1,
        "last_update": "2024-01-31T14:38:29Z"
    }
}

Example

curl https://api.tzpro.io/explorer/tip

import (
  "context"
  "github.com/trilitech/tzpro-go/tzpro"
)

// use default Mainnet client
tip, err := tzpro.DefaultClient.Explorer.GetTip(context.Background())

Blockchain Config

GET /explorer/config/{head|hash|height}

Fetches blockchain configuration parameters that are specific for each deployed protocol. This endpoint accepts head and a block hash or height as path parameters, so you can access configurations of past protocols as well. Note that as the Tezos blockchain evolves some configuration parameters become obsolete while new parameters are added.

Schema

Field	Description
name string	Blockchain name (Tezos).
network string	Network name (e.g. Mainnet, Hangzhounet, Sandbox).
symbol string	Ticker symbol (XTZ).
chain_id hash	Chain hash.
version int64	Protocol version number.
deployment int64	Number of deployed protocols on this network.
protocol hash	Protocol hash.
start_height int64	Activation height of the protocol.
end_height int64	Deactivation height of the protocol (0 if undefined).
decimals int64	Decimal points of one coin unit.
minimal_stake int64	Min amount of tez required to receive block voting rights.
preserved_cycles int64	Number of cycles for freezing security deposits and rewards.
blocks_per_cycle int64	Number of blocks per consensus cycle.
minimal_block_delay int	Expected time between blocks, replacement for time_between_blocks.

Response

{
{
    "name": "Tezos",
    "network": "Mainnet",
    "symbol": "XTZ",
    "chain_id": "NetXdQprcVkpaWU",
    "deployment": 17,
    "version": 17,
    "protocol": "PtNairobiyssHuh87hEhfVBGCVrK3WnS8Z2FT4ymB5tAa4r1nQf",
    "start_height": 3760129,
    "end_height": -1,
    "decimals": 6,
    "minimal_stake": 6000,
    "preserved_cycles": 5,
    "blocks_per_cycle": 16384,
    "minimal_block_delay": 15
}

Example

curl https://api.tzpro.io/explorer/config/head

import (
  "context"
  "github.com/trilitech/tzpro-go/tzpro"
)

// use default Mainnet client
config, err := tzpro.DefaultClient.Explorer.GetConfigHead(context.Background())