Block Table

GET https://api.tzpro.io/tables/block?args
List detailed information about each block, including orphans.
HTTP Response
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.
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_esc_ema int64
Granada liquidity baking vote moving average.
lb_esc_vote bool
Granada liquidity baking disable vote flag.
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.
Example Request
curl https://api.tzpro.io/tables/block?time.gte=today&limit=1
import (
  "context"
  "blockwatch.cc/tzstats-go"
)
​
// create a new query object
q := tzstats.DefaultClient.NewBlockQuery()
​
// add filters and configure the query
q.WithFilter(tzstats.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)
}
Example Response (comments added for explanation)
[
  [
    632250,             // row_id
    632249,             // parent_id
    "BMapnMicyiqFsWU9NdqXvfQJQcpFfzWHMicRRjALEMNngkefd7B", // hash
    632249,             // height
    154,                // cycle
    0,                  // is_cycle_snapshot
    1569974422000,      // time
    60,                 // solvetime
    4,                  // version
    0,                  // round / priority
    "000000036e731d39", // nonce
    "promotion",        // voting_period_kind
    35034,              // baker_id
    35034,              // proposer_id
    32,                 // n_endorsed_slots
    0,                  // n_ops_failed
    0,                  // n_ops_contract
    0,                  // n_calls
    0,                  // n_rollup_calls
    1,                  // n_events
    10529.635160,       // volume
    0.004140,           // fee
    80.000000,          // reward
    2560.000000,        // deposit
    0.000000,           // activated_supply
    0.000000,           // burned_supply
    0.000000,           // minted_supply
    31,                 // n_accounts
    0,                  // n_new_accounts
    0,                  // n_new_contracts
    0,                  // n_cleared_accounts
    0,                  // n_funded_accounts
    32100,              // gas_limit
    30414,              // gas_used
    0,                  // storage_paid
    false,              // lb_esc_vote
    0,                  // lb_esc_ema
    100,                // pct_account_reuse
    "tz1hThMBD8jQjFt78heuCnKxJnJtQo9Ao25X", // baker
    "tz1hThMBD8jQjFt78heuCnKxJnJtQo9Ao25X", // proposer
    "Pt24m4xiPbLDhVgVfABUjirbmda3yohdN82Sp9FeuAXJ4eV9otd" // protocol
    "tz1hThMBD8jQjFt78heuCnKxJnJtQo9Ao25X", // baker_consensus_key
    "tz1hThMBD8jQjFt78heuCnKxJnJtQo9Ao25X", // proposer_consensus_key
  ]
]

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.
`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_esc_ema` int64	Granada liquidity baking vote moving average.
`lb_esc_vote` bool	Granada liquidity baking disable vote flag.
`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.

Bigmap Update Table

Chain Table

Last modified 1mo ago