Skip to main content

/v2/accounts/{principal} REST API Endpoint

Get account info.

Updated on
Oct 4, 2023

/v2/accounts/{principal} REST API Endpoint

Path Parameters

principal
string
REQUIRED
Stacks address or a Contract identifier (e.g. SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0.get-info).

Query Parameters

proof
integer
Returns object without the proof field if set to 0.
tip
string
The Stacks chain tip to query from.

Returns

object
Get request for account data
balance
string
The current balance of the account. It represents the amount of funds or tokens held by the account on the blockchain.
locked
string
The amount of funds or tokens that are currently locked or inaccessible in the account. These locked funds may be subject to certain conditions or restrictions.
unlock_height
integer
The block height at which the locked funds in the account will be automatically unlocked. After this block height, the locked funds become available for use.
nonce
integer
The nonce associated with the account. It is a sequential number used to prevent replay attacks and ensure the order of transactions from the account.
balance_proof
string
The balance proof associated with the account. It is a cryptographic proof that attests to the current balance of the account and can be used for verification purposes.
nonce_proof
string
The nonce proof associated with the account. It is a cryptographic proof that attests to the current balance of the account and can be used for verification purposes.
Request
1
curl -X 'GET' \
2
'https://docs-demo.stacks-mainnet.quiknode.pro/v2/accounts/SP197DVH8KTJGX4STM61QN0WJV8Y9QJWXV83ZGNR9' \
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