Skip to main content

/extended/v1/address/{principal}/nonces REST API Endpoint

Retrieves the latest nonce values used by an account by inspecting the mempool, microblock transactions, and anchored transactions.

Updated on
Jun 13, 2025

Path Parameters

principal
string
REQUIRED

Stacks address (e.g. SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0)

Query Parameters

block_height
number

Optionally get the nonce at a given block height.

block_hash
string

Optionally get the nonce at a given block hash.

Returns

object
array

The latest nonce values used by an account by inspecting the mempool, microblock transactions, and anchored transactions

last_mempool_tx_nonce
integer

The latest nonce found within mempool transactions sent by this address. Will be null if there are no current mempool transactions for this address.

last_executed_tx_nonce
integer

The latest nonce found within transactions sent by this address, including unanchored microblock transactions. Will be null if there are no current transactions for this address.

possible_next_nonce
integer

The likely nonce required for creating the next transaction, based on the last nonces seen by the API. This can be incorrect if the API's mempool or transactions aren't fully synchronized, even by a small amount, or if a previous transaction is still propagating through the Stacks blockchain network when this endpoint is called.

detected_missing_nonces
array

Nonces that appear to be missing and likely causing a mempool transaction to be stuck.

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free