Skip to main content

/extended/v2/addresses/{address}/transactions API Method

Retrieves transactions sent or received by a STX address or smart contract ID

Updated on
Jun 13, 2025

/extended/v2/addresses/{address}/transactions API Method

Path Parameters

address
string
REQUIRED
STX Address (string) or Smart Contract ID (string)

Query Parameters

limit
integer
Results per page
offset
integer
Result offset

Returns

address_transactions_response
object
Transaction list for the specified address
limit
integer
Number of transactions per page
offset
integer
The offset of the returned transactions
total
integer
Total number of transactions for this address
results
array
List of transactions associated with this address
tx
object
Transaction details
tx_id
string
Unique transaction identifier
nonce
integer
Transaction nonce
fee_rate
string
The fee rate for this transaction
sender_address
string
The address that sent this transaction
sponsor_nonce
integer
The nonce of the sponsor if the transaction is sponsored
sponsored
boolean
Indicates if the transaction is sponsored
sponsor_address
string
The address of the sponsor if the transaction is sponsored
post_condition_mode
string
The post-condition mode for the transaction
post_conditions
array
List of post-conditions for the transaction
principal
object
The principal (address or contract) for this post condition
type_id
string
The type of principal (e.g., principal_origin)
condition_code
string
The condition code (e.g., sent_equal_to)
amount
string
The amount specified in the post condition
type
string
The type of asset for this post condition (e.g., stx)
anchor_mode
string
The anchor mode of the transaction
block_hash
string
The hash of the block containing this transaction
block_height
integer
The height of the block containing this transaction
block_time
integer
Unix timestamp of the block
block_time_iso
string
ISO format timestamp of the block
burn_block_height
integer
The burn block height
burn_block_time
integer
Unix timestamp of the burn block
burn_block_time_iso
string
ISO format timestamp of the burn block
parent_burn_block_time
integer
Unix timestamp of the parent burn block
parent_burn_block_time_iso
string
ISO format timestamp of the parent burn block
canonical
boolean
Indicates if the transaction is in the canonical chain
tx_index
integer
The index of the transaction in the block
tx_status
string
The status of the transaction (e.g., success, failed)
tx_result
object
The result of the transaction execution
hex
string
Hexadecimal representation of the transaction result
repr
string
String representation of the transaction result
event_count
integer
The number of events emitted by this transaction
parent_block_hash
string
The hash of the parent block
is_unanchored
boolean
Indicates if the transaction is in an unanchored microblock
microblock_hash
string
The hash of the microblock containing this transaction
microblock_sequence
integer
The sequence number of the microblock
microblock_canonical
boolean
Indicates if the microblock is in the canonical chain
execution_cost_read_count
integer
The number of read operations during execution
execution_cost_read_length
integer
The total length of data read during execution
execution_cost_runtime
integer
The runtime cost of execution
execution_cost_write_count
integer
The number of write operations during execution
execution_cost_write_length
integer
The total length of data written during execution
tx_type
string
The type of transaction (e.g., token_transfer, contract_call)
token_transfer
object
Details of the token transfer if this is a token transfer transaction
recipient_address
string
The address of the recipient
amount
string
The amount of tokens transferred
memo
string
Optional memo included with the transfer
events
array
List of events triggered by this transaction
event_index
integer
The index of the event within the transaction
event_type
string
The type of event (e.g., smart_contract_log)
tx_id
string
The transaction ID that generated this event
contract_log
object
Details of a contract log event
contract_id
string
The contract identifier that emitted the log
topic
string
The topic/name of the log event
value
object
The value included in the log event
hex
string
Hexadecimal representation of the value
repr
string
String representation of the value
stx_sent
string
Amount of STX sent in this transaction
stx_received
string
Amount of STX received in this transaction
events
object
Summary of events related to this transaction
stx
object
STX token events
transfer
integer
Number of STX transfer events
mint
integer
Number of STX mint events
burn
integer
Number of STX burn events
ft
object
Fungible token events
transfer
integer
Number of fungible token transfer events
mint
integer
Number of fungible token mint events
burn
integer
Number of fungible token burn events
nft
object
Non-fungible token events
transfer
integer
Number of non-fungible token transfer events
mint
integer
Number of non-fungible token mint events
burn
integer
Number of non-fungible token burn events
Request
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free