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'

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