Block Table

GET /tables/block?args

List detailed information about each block, including orphans.

Schema

Field	Description
row_id uint64	Unique row identifier.
parent_id uint64	Unique row id of parent block.
hash hash	Block hash.
height int64	Block height.
cycle int64	Consensus cycle this block is part of.
is_cycle_snapshot bool	Flag indicating this block is a cycle snapshot.
time datetime	Block timestamp.
solvetime int64	Duration between the parent block's timestamp and this block.
version int64	Block protocol version (note, this is a serial version that depends on how many protocols have been activated on the current chain so far).
round int64	Baking round/priority.
nonce uint64	Block nonce.
voting_period_kind enum	Current voting period proposal, exploration, cooldown, promotion, adoption.
baker_id uint64	Baker account id.
proposer_id uint64	Proposer account id.
n_endorsed_slots int64	Count of endorsed slots. (Note this field will be set from endorsements published in the subsequent block.)
n_ops_applied int64	Count of successful operations.
n_ops_failed int64	Count of failed operations.
n_calls int64	Count of smart contract calls (transactions sent to contracts by externally owned accounts excluding internal operations sent between contracts).
n_rollup_calls int64	Count of rollup operations.
n_events int64	Count of implicit protocol events.
n_tx int64	Count of transactions.
n_tickets int64	Count of ticket updates.
volume money	Total amount of tokens moved between accounts.
fee money	Total fees paid (and frozen) by all operations.
reward money	Reward earned (and frozen) by baker.
deposit money	Deposit frozen by baker.
activated_supply money	Total amount of commitments activated in tez.
burned_supply money	Total amount of tokens burned by operations in tez.
minted_supply money	Total amount of new tokens minted by operations in tez.
n_accounts int64	Count of accounts seen in this block (i.e. this includes all operation senders, receivers, delegates and the block's baker).
n_new_accounts int64	Count of new EOA accounts created (tz1/2/3).
n_new_contracts int64	Count of created smart contracts (KT1 with code).
n_cleared_accounts int64	Count of accounts that were emptied (final balance = 0).
n_funded_accounts int64	Count of accounts that were funded by operations (this includes all new accounts plus previously cleared accounts that were funded again).
gas_limit int64	Total gas limit defined by operations.
gas_used int64	Total gas consumed by operations.
storage_paid int64	Total sum of new storage allocated by operations.
lb_vote bool	Liquidity baking vote flag.
lb_ema int64	Liquidity baking vote moving average.
ai_vote bool	Adaptive issuance vote flag.
ai_ema int64	Adaptive issuance vote moving average.
baker_consensus_key_id uint64	Baker account id used to sign this block.
proposer_consensus_key_id uint64	Baker account id used to sign the payload.
pct_account_reuse int	Percentage of existing accounts seen this block.
baker hash	Address of the block baker account.
proposer hash	Address of the block proposer account.
protocol hash	Hash of the protocol that was active at this block.
baker_consensus_key hash	Baker key (address) used to sign this block.
proposer_consensus_key hash	Baker key (address) to sign the payload.

Response

[
  [
    5020702,                                               // row_id
    5020701,                                               // parent_id
    "BLSAamrf462CnBFVKAKTowdCS318QGvsrPWq5XRCsD2wPj1iJH7", // hash
    5020701,                                               // height
    699,                                                   // cycle
    0,                                                     // is_cycle_snapshot
    1706717369000,                                         // time
    15,                                                    // solvetime
    17,                                                    // version
    0,                                                     // round
    "6b31a6d20d760000",                                    // nonce
    "adoption",                                            // voting_period_kind
    1307855,                                               // baker_id
    1307855,                                               // proposer_id
    0,                                                     // n_endorsed_slots
    224,                                                   // n_ops_applied
    0,                                                     // n_ops_failed
    8,                                                     // n_calls
    0,                                                     // n_rollup_calls
    2,                                                     // n_events
    8,                                                     // n_tx
    0,                                                     // n_tickets
    0.000000,                                              // volume
    0.005135,                                              // fee
    9.834608,                                              // reward
    0.000000,                                              // deposit
    0.000000,                                              // activated_supply
    0.016750,                                              // burned_supply
    11.084608,                                             // minted_supply
    231,                                                   // n_accounts
    2,                                                     // n_new_accounts
    0,                                                     // n_new_contracts
    0,                                                     // n_cleared_accounts
    0,                                                     // n_funded_accounts
    15821,                                                 // gas_limit
    12975,                                                 // gas_used
    67,                                                    // storage_paid
    "on",                                                  // lb_vote
    413148804,                                             // lb_ema
    "",                                                    // ai_vote
    0,                                                     // ai_ema
    1307855,                                               // baker_consensus_key_id
    1307855,                                               // proposer_consensus_key_id
    99.134199,                                             // pct_account_reuse
    "tz3gtoUxdudfBRcNY7iVdKPHCYYX6xdPpoRS",                // baker
    "tz3gtoUxdudfBRcNY7iVdKPHCYYX6xdPpoRS",                // proposer
    "PtNairobiyssHuh87hEhfVBGCVrK3WnS8Z2FT4ymB5tAa4r1nQf", // protocol
    "tz3gtoUxdudfBRcNY7iVdKPHCYYX6xdPpoRS",                // baker_consensus_key
    "tz3gtoUxdudfBRcNY7iVdKPHCYYX6xdPpoRS"                 // proposer_consensus_key
  ]
]

Example

curl https://api.tzpro.io/tables/block?time.gte=today&limit=1

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

// create a new query object
q := tzpro.DefaultClient.Block.NewQuery()

// add filters and configure the query
q.WithFilter(tzpro.FilterModeGte, "time", "today").WithLimit(1)

// execute the query
list, err := q.Run(context.Background())

// access that block
if list.Len() == 1 {
    fmt.Println(list.Rows[0].Hash)
}