# newBlocks

**Type:** GraphQL subscriptions

**Description:**
Subscribe to new blocks as they are produced on the Kadena network.

This subscription streams newly mined blocks in real time, allowing clients to react immediately
to chain updates without repeatedly polling the API. It is commonly used by explorers, indexers,
and event-driven applications that need to stay in sync with the latest state of the blockchain.

You can optionally filter the subscription by specific `chainIds` to receive blocks only from selected chains.
If omitted, blocks from all chains are included.
The `quantity` parameter controls how many of the most recent blocks are returned initially
when the subscription starts (default: 20).

After the initial batch, new blocks are pushed to the client as they are finalized.

## Arguments
- chainIds (String): (Optional) A list of chain IDs to subscribe to.
If omitted, the subscription includes new blocks from all chains.
- quantity (Int): The number of most recent blocks to include in the initial payload when the subscription starts.

## Response
**Type:** Block
**Description:**
A **Block** is the fundamental unit of the Kadena blockchain.
Each block bundles a verified set of transactions and metadata that secure and extend the chain.
Blocks are linked together cryptographically — each one referencing its parent — forming the immutable and tamper-evident chain structure.
This type exposes all the core properties of a block, including consensus data (like difficulty, nonce, and proof of work), network metadata (like chain ID and epoch), and relations to transactions, events, and neighboring blocks.

### Fields
- id (ID): Globally unique identifier for this block node.
- hash (String): The cryptographic hash of the block.
This serves as its unique identifier within the blockchain.
- chainId (BigInt): The specific chain where this block was mined.
Kadena is a multi-chain system, and each block belongs to exactly one chain.
- creationTime (DateTime): The timestamp when this block was created and added to the chain.
- difficulty (BigInt): The network difficulty at the time the block was mined.
Higher difficulty reflects the amount of computational work required to produce a valid block.
- epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted.
Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target.
- flags (Decimal): Consensus flags used internally by the protocol.
- height (BigInt): The height (block number) of this block within its chain.
The genesis block is height 0, and each subsequent block increments by 1.
- nonce (Decimal): A nonce value used in the proof-of-work process.
Miners vary this value to discover a hash below the target threshold.
- payloadHash (String): The hash of the payload data contained within the block.
This ensures the integrity of the transactions and other included data.
- weight (String): The cumulative weight of the chain up to and including this block.
Weight increases with each mined block and helps determine the canonical chain.
- target (String): The target hash threshold that the block’s proof-of-work hash must fall below.
This value adjusts with difficulty to regulate block production time.
- coinbase (String): The coinbase transaction data.
This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts.
- neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent.
These neighbors are essential in Kadena’s braided multi-chain architecture.
- powHash (String): The proof-of-work hash of the block.
This is the result of hashing the block header with the nonce and must satisfy the target condition.
- canonical (Boolean): Indicates whether this block is part of the canonical chain.
Non-canonical blocks may occur during temporary forks or reorganizations.
- parent (Block): The parent block directly preceding this one in the chain.
Together with the hash, this forms the cryptographic link that secures the chain.
- totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA.
- events (BlockEventsConnection): Paginated list of events emitted by transactions within this block.
- minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward.
- transactions (BlockTransactionsConnection): Paginated list of transactions included in this block.