Skip to main content

/extended/v2/addresses/{address}/transactions REST API Endpoint

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

Updated on
Aug 25, 2025

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