/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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free