Skip to main content

/extended/v1/tx/mempool REST API Endpoint

Get mempool transactions.

Updated on
Oct 4, 2023

/extended/v1/tx/mempool REST API Endpoint

Query Parameters

sender_address
string
Filter to only return transactions with this sender address..
recipient_address
string
Filter to only return transactions with this recipient address (only applicable for STX transfer tx types)..
address
string
Filter to only return transactions with this address as the sender or recipient (recipient only applicable for STX transfer tx types)..
limit
integer
max number of mempool transactions to fetch.
offset
integer
index of first mempool transaction to fetch.
unanchored
boolean
Include transaction data from unanchored (i.e. unconfirmed) microblocks.

Returns

object
object
GET request that returns transactions
limit
integer
The maximum number of transactions to retrieve.
offset
integer
The number of transactions to skip (starting at 0).
total
integer
The total number of transactions available.
results
array
An array of transactions. Each transaction can be of type MempoolTokenTransferTransaction, MempoolSmartContractTransaction, MempoolContractCallTransaction, MempoolPoisonMicroblockTransaction, or MempoolCoinbaseTransaction.
tx_id
string
The ID of the transaction.
nonce
integer
The nonce value of the transaction.
fee_rate
string
The transaction fee as an integer string.
sender_address
string
The address of the transaction initiator.
sponsor_nonce
integer
The sponsor nonce value.
sponsored
boolean
Denotes whether the originating account is the same as the paying account.
sponsored_address
string
The address of the sponsor.
post_condition_mode
boolean
The post-condition mode. Possible values: 'allow', 'deny'.
post_conditions
array
An array of post conditions. Each condition can be of type PostConditionStx, PostConditionFungible, or PostConditionNonFungible.
anchor_mode
string
The anchor mode. Possible values: 'on_chain_only', 'off_chain_only', 'any'.
tx_status
string
The status of the transaction. Possible values: 'pending', 'dropped_replace_by_fee', 'dropped_replace_across_fork', 'dropped_too_expensive', 'dropped_stale_garbage_collect'.
receipt_time
integer
A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.
receipt_time_iso
integer
A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.
tx_type
string
The type of the transaction. Value: 'token_transfer'.
token_transfer
object
Additional information about the token transfer.
recipient_address
string
The recipient address.
amount
string
The transfer amount as an integer string.
memo
string
The hex encoded arbitrary message.
Request
1
curl -X 'GET' \
2
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/tx/mempool' \
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