Skip to main content

/extended/v1/tx REST API Endpoint

Get recent transactions.

Updated on
Oct 4, 2023

/extended/v1/tx REST API Endpoint

Query Parameters

limit
integer
max number of transactions to fetch.
offset
integer
index of first transaction to fetch.
type
array
Filter by transaction type.
unanchored
boolean
Include transaction data from unanchored (i.e. unconfirmed) microblocks.

Returns

object
GET request that returns transactions
limit
integer
The number of mints event to return
offset
integer
The number to mints event to skip (starting at 0)
total
integer
The number of mints event available
results
array
An array of transaction objects.
tx_id
array
Array of transaction IDs.
nonce
array
Array of nonces.
fee_rate
array
Array of 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.
principal
object
Principal object.
type_id
string
String literal of type - PostConditionPrincipalType.
condition_code
string
Enum: 'sent_equal_to', 'sent_greater_than', 'sent_greater_than_or_equal_to', 'sent_less_than', 'sent_less_than_or_equal_to'. A fungible condition code encodes a statement being made for either STX or a fungible token, with respect to the originating account.
amount
string
Amount.
type
string
Value: 'STX'.
anchor_mode
string
Possible values: 'on_chain_only', 'off_chain_only', 'any'.
block_hash
string
Hash of the block this transaction was associated with.
block_height
integer
Height of the block this transaction was 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 this parent block was mined.
parent_burn_block_time_iso
string
An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) timestamp indicating when this parent block was mined.
canonical
array
Set to true if 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), then 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), then 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 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 Integer string (64-bit unsigned integer).
memo
string
Hex encoded arbitrary message, up to 34 bytes length (should try decoding to an ASCII string).
Request
1
curl -X 'GET' \
2
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/tx' \
3
    -H 'Content-Type: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free