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

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

1
curl -X 'GET' \
2
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/address/SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9/nonces' \
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