Skip to main content

/extended/v1/tx/block_height/{height} REST API Endpoint

Retrieves all transactions within a block at a given height.

Updated on

Jun 13, 2025

Path Parameters

height string REQUIRED: Height of block.

Query Parameters

limit integer: max number of transactions to fetch.

offset integer: index of first transaction to fetch.

unanchored boolean: Include transaction data from unanchored (i.e. unconfirmed) microblocks.

Returns

object

with the following values:

limit integer: The number of transactions to return.

offset integer: The number of transactions to skip (starting at 0).

total integer: The number of unanchored transactions available.

results array

Array of transaction objects.

tx_id array: Array of transaction IDs.

nonce array: Array of transaction nonces.

fee_rate array: Array of transaction fee rates.

sender_address string: Address of the transaction initiator.

sponsor_nonce integer: Sponsor nonce.

sponsored boolean: Denotes whether the originating account is the same as the paying account.

sponsor_address string: Sponsor address.

post_condition_mode string: Possible values: 'allow', 'deny'.

post_conditions array: Array of post conditions.

anchor_mode string: Possible values: 'on_chain_only', 'off_chain_only', 'any'.

block_hash string: Hash of the block this transaction is associated with.

block_height integer: Height of the block this transaction is associated with.

burn_block_time string: Unix timestamp (in seconds) indicating when this block was mined.

burn_block_time_iso string: An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) timestamp indicating when this block was mined.

parent_burn_block_time string: Unix timestamp (in seconds) indicating when the parent block was mined.

parent_burn_block_time_iso string: An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) timestamp indicating when the parent block was mined.

canonical array: Set to true if the block corresponds to the canonical chain tip.

tx_index integer: Index of the transaction, indicating the order. Starts at 0 and increases with each transaction.

tx_status string: Enum: 'success', 'abort_by_response', 'abort_by_post_condition'. Status of the transaction.

tx_result object

Result of the transaction.

hex string: Hex string representing the value for the transaction result.

repr string: Readable string of the transaction result.

event_count integer: Number of transaction events.

parent_block_hash string: Hash of the previous block.

is_unanchored boolean: True if the transaction is included in a microblock that has not been confirmed by an anchor block.

microblock_hash string: The microblock hash that this transaction was streamed in. If the transaction was batched in an anchor block (not included within a microblock), this value will be an empty string.

microblock_sequence integer: The microblock sequence number that this transaction was streamed in. If the transaction was batched in an anchor block (not included within a microblock), this value will be 2147483647 (0x7fffffff, the max int32 value). This value preserves logical transaction ordering on (block_height, microblock_sequence, tx_index).

microblock_canonical boolean: Set to true if the microblock is anchored in the canonical chain tip. False if the transaction was orphaned in a micro-fork.

execution_cost_read_count integer: Execution cost read count.

execution_cost_read_length integer: Execution cost read length.

execution_cost_runtime integer: Execution cost runtime.

execution_cost_write_count integer: Execution cost write count.

execution_cost_write_length integer: Execution cost write length.

events array: List of transaction events.

tx_type string: Value: 'token_transfer'.

token_transfer object

Token transfer object.

recipient_address string: The recipient address.

amount string: Transfer amount as an integer string.

memo string: Hex-encoded arbitrary message.

Request

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free