/extended/v2/blocks/{height_or_hash}/transactions REST API Endpoint

Path Parameters

height_or_hash string REQUIRED: Block hash (string) or Block height (integer)

Query Parameters

limit integer: Max number of transactions to return

offset integer: The number of transactions to skip (for pagination)

Returns

block_transactions object

GET request that returns transactions for a block

limit integer: The number of transactions to return.

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

total integer: The total number of transactions in the block.

results array

List of transactions.

tx_id string: Transaction ID (hash).

nonce integer: Transaction nonce.

fee_rate string: Transaction fee rate in micro-STX.

sender_address string: Address of the transaction sender.

sponsor_nonce integer: Nonce of the sponsor (if transaction is sponsored).

sponsored boolean: Whether the transaction is sponsored.

sponsor_address string: Address of the sponsor (if transaction is sponsored).

post_condition_mode string: Post-condition mode (allow or deny).

post_conditions array

List of post-conditions for the transaction.

principal object

Principal affected by the post condition.

type_id string: Type of the principal (principal_origin, principal_standard, etc.).

address string: Address of the principal (if applicable).

condition_code string: Condition code (sent_equal_to, sent_less_than_or_equal_to, etc.).

amount string: Amount specified in the condition.

type string: Type of asset (stx, fungible, non_fungible).

asset object

Asset details for fungible or non-fungible assets.

asset_name string: Name of the asset.

contract_address string: Contract address of the asset.

contract_name string: Contract name of the asset.

asset_value object

Value of non-fungible asset in the condition.

hex string: Hex representation of the asset value.

repr string: String representation of the asset value.

anchor_mode string: Anchor mode for the transaction (on_chain_only, off_chain_only, any).

block_hash string: Hash of the block containing this transaction.

block_height integer: Height of the block containing this transaction.

block_time integer: Unix timestamp of when this block was processed.

block_time_iso string: ISO 8601 formatted timestamp of when this block was processed.

burn_block_time integer: Unix timestamp of when this block was mined on the anchor chain.

burn_block_height integer: Height of the anchor chain block.

burn_block_time_iso string: ISO 8601 formatted timestamp of when this block was mined on the anchor chain.

parent_burn_block_time integer: Unix timestamp of the parent anchor chain block.

parent_burn_block_time_iso string: ISO 8601 formatted timestamp of the parent anchor chain block.

canonical boolean: Whether this transaction is in the canonical chain tip.

tx_index integer: Index of this transaction within the block.

tx_status string: Status of the transaction (success, abort_by_response, abort_by_post_condition).

tx_result object

Result of the transaction execution.

hex string: Hex representation of the result.

repr string: String representation of the result.

event_count integer: Number of events emitted by this transaction.

parent_block_hash string: Hash of the parent block.

is_unanchored boolean: Whether this transaction is in an unanchored (non-confirmed) block.

microblock_hash string: Hash of the microblock containing this transaction.

microblock_sequence integer: Sequence number of the microblock containing this transaction.

microblock_canonical boolean: Whether the microblock containing this transaction is in the canonical chain.

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 events emitted by this transaction.

event_index integer: Index of the event.

event_type string: Type of event (smart_contract_log, stx_asset, etc.).

tx_id string: Transaction ID that emitted this event.

contract_log object

Details for smart_contract_log events.

contract_id string: ID of the contract that emitted the log.

topic string: Topic of the log.

value object

Value emitted in the log.

hex string: Hex representation of the value.

repr string: String representation of the value.

tx_type string: Type of transaction (contract_call, token_transfer, etc.).

contract_call object

Contract call details (present when tx_type is contract_call).

contract_id string: The contract identifier.

function_name string: The function called in the contract.

function_signature string: The function signature.

function_args array

List of arguments passed to the function.

hex string: Hex representation of the argument.

repr string: String representation of the argument.

name string: Name of the argument (if available).

type string: Type of the argument.

token_transfer object

Token transfer details (present when tx_type is token_transfer).

recipient_address string: The recipient's address.

amount string: The amount of tokens transferred.

memo string: Memo included with the transfer.

Request

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free