Skip to main content

/extended/v2/blocks/{height_or_hash}/transactions API Method

/extended/v2/blocks/{height_or_hash}/transactions API Method

Updated on
Jun 13, 2025

/extended/v2/blocks/{height_or_hash}/transactions API Method

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