Skip to main content

/extended/v1/address/{address}/mempool REST API Endpoint

Retrieves all transactions for a given address that are currently in mempool.

Updated on
Oct 4, 2023

/extended/v1/address/{address}/mempool REST API Endpoint

Path Parameters

address
string
REQUIRED
Transactions for the address.

Query Parameters

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

Returns

array[objects]
Returns a list of transactions
limit
integer
The maximum number of pending transactions retrieved
offset
integer
The index of first transaction
total
integer
The total number of pending transactions
results
array
Array of MempoolTokenTransferTransaction (object) or MempoolSmartContractTransaction (object) or MempoolContractCallTransaction (object) or MempoolPoisonMicroblockTransaction (object) or MempoolCoinbaseTransaction (object)
tx_id
string
Transaction ID.
nonce
integer
Used for ordering the transactions originating from and paying from an account. The nonce ensures that a transaction is processed at most once. The nonce counts the number of times an account's owner(s) have authorized a transaction. The first transaction from an account will have a nonce value equal to 0, the second will have a nonce value equal to 1, and so on.
fee_rate
string
Transaction fee as Integer string (64-bit unsigned integer).
sender_address
string
Address of the transaction initiator.
sponsor_nonce
integer
The nonce of the sponsor associated with a particular pending transaction
sponsored
boolean
Denotes whether the originating account is the same as the paying account
sponsor_address
string
The address of the sponsor associated with a specific pending transaction
post_condition_mode
string
Enum: 'allow', 'deny'
post_conditions
object
Array of PostConditionStx (object) or PostConditionFungible (object) or PostConditionNonFungible (object) (PostCondition).
principal
object
The object with the following fields
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
The amount of STX being transferred or involved in the pending transaction
type
string
Value: 'STX'
anchor_mode
string
Enum: 'on_chain_only', 'off_chain_only', 'any', on_chain_only: the transaction MUST be included in an anchored block, off_chain_only: the transaction MUST be included in a microblock, any: the leader can choose where to include the transaction.
tx_status
string
Status of the transaction. Enum: '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
string
An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) timestamp indicating when the transaction broadcast was received by the node.
tx_type
string
Value: 'token_transfer'
token_transfer
object
The object with the following fields
recipient_address
string
The recipient address.
amount
string
Transfer amount as Integer string (64-bit unsigned integer)
memo
string
Hex encoded abritrary 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/address/SP1XM0M9FFQ9Q927Z01AV3K73W53E2H1D6WS2YY55/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