Skip to main content

/extended/v3/principals/{principal}/nonces REST API Endpoint

Get a Stacks account's latest nonce state by inspecting its confirmed (anchored + microblock) transactions and the mempool, including the nonce to use for its next transaction. Only standard principals have nonces; contract principals are not valid.

Updated on
Aug 18, 2026

Path Parameters

principal
string
REQUIRED

Stacks Address

Returns

next_nonce
integer

The nonce to use for this principal's next transaction, derived from the latest confirmed and mempool nonces. May be inaccurate if the API is not fully synchronized.

last_confirmed_nonce
integer

Most recent nonce confirmed on-chain.

mempool
object

PrincipalMempoolNonces

last_nonce
integer

Most recent nonce observed for the principal.

pending_nonces
array

Intermediate nonces found in the mempool between the last confirmed nonce and the highest mempool nonce.

missing_nonces
array

Expected intermediate nonces between the last confirmed nonce and the highest mempool nonce that are absent from the mempool — likely stalling transactions.

Request
Response
1
{
2
"next_nonce": 89742,
3
"last_confirmed_nonce": 89741,
4
"mempool": {
5
"last_nonce": null,
6
"pending_nonces": [],
7
"missing_nonces": []
8
}
9
}
1
{
2
"next_nonce": 89742,
3
"last_confirmed_nonce": 89741,
4
"mempool": {
5
"last_nonce": null,
6
"pending_nonces": [],
7
"missing_nonces": []
8
}
9
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free