Skip to main content

/extended/v3/principals/{principal}/mempool/transactions REST API Endpoint

Returns a list of pending mempool transactions that involve a principal — as the sender, a token-transfer recipient, the deployed contract, or the called contract.

Updated on
Aug 18, 2026

Path Parameters

principal
string
REQUIRED

Stacks account or contract principal.

Query Parameters

limit
integer

Number of results per page

cursor
string

(Optional) Cursor for paginating mempool transactions. Format: receipt_time:tx_id

Returns

total
integer

Total number of matching records.

limit
integer

Number of results per page

cursor
object

Cursor metadata for this page of results.

next
string | null

Cursor for the next page, or null when there is no next page.

previous
string | null

Cursor for the previous page, or null when there is no previous page.

current
string

Cursor identifying the current page.

results
array

Items returned for the current page.

tx_id
string

Transaction ID

sender
object

Transaction sender details.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

sponsor
object | null

Fee sponsor details, or null when the transaction is not sponsored.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

fee_rate
string

Transaction fee as Integer string (64-bit unsigned integer).

receipt_time
integer

A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.

receipt_block_height
integer

Height of the block this transaction was received by the node

status
string

Status of the mempool transaction

type
string

Discriminator identifying the record or transaction variant.

contract_call
object

Contract-call transaction details.

contract_id
string

Contract identifier formatted as <principaladdress>.<contract_name>

function_name
string

Name of the Clarity function to be invoked

Request
Response
1
{
2
"total": 2,
3
"limit": 1,
4
"cursor": {
5
"next": "1785854632:0x3c4741fa0d79f1847b23eadcbcdbdb8bba702cb65923d718aab3263c77d3c5b9",
6
"previous": null,
7
"current": "1785854642:0xa735804b9e013f0a65eb0266e95b3342c6a49ab7c9e292b89812dc92867e6f56"
8
},
9
"results": [
10
{
11
"tx_id": "0xa735804b9e013f0a65eb0266e95b3342c6a49ab7c9e292b89812dc92867e6f56",
12
"sender": {
13
"address": "SP21EK0KSQG7HEHBGCVRJGPGFMV8SCA2B85X01DK2",
14
"nonce": 591665
15
},
16
"sponsor": null,
17
"fee_rate": "417",
18
"receipt_time": 1785854642,
19
"receipt_block_height": 8702100,
20
"status": "pending",
21
"type": "contract_call",
22
"contract_call": {
23
"contract_id": "SP21EK0KSQG7HEHBGCVRJGPGFMV8SCA2B85X01DK2.blocksurvey-proof-of-submission",
24
"function_name": "proof-of-submission"
25
}
26
}
27
]
28
}
1
{
2
"total": 2,
3
"limit": 1,
4
"cursor": {
5
"next": "1785854632:0x3c4741fa0d79f1847b23eadcbcdbdb8bba702cb65923d718aab3263c77d3c5b9",
6
"previous": null,
7
"current": "1785854642:0xa735804b9e013f0a65eb0266e95b3342c6a49ab7c9e292b89812dc92867e6f56"
8
},
9
"results": [
10
{
11
"tx_id": "0xa735804b9e013f0a65eb0266e95b3342c6a49ab7c9e292b89812dc92867e6f56",
12
"sender": {
13
"address": "SP21EK0KSQG7HEHBGCVRJGPGFMV8SCA2B85X01DK2",
14
"nonce": 591665
15
},
16
"sponsor": null,
17
"fee_rate": "417",
18
"receipt_time": 1785854642,
19
"receipt_block_height": 8702100,
20
"status": "pending",
21
"type": "contract_call",
22
"contract_call": {
23
"contract_id": "SP21EK0KSQG7HEHBGCVRJGPGFMV8SCA2B85X01DK2.blocksurvey-proof-of-submission",
24
"function_name": "proof-of-submission"
25
}
26
}
27
]
28
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free