Skip to main content

Get account info

Retrieves the account data for a given Account or a Contract Identifier

Where balance is the hex encoding of a unsigned 128-bit integer (big-endian), nonce is an unsigned 64-bit integer, and the proofs are provided as hex strings.

For non-existent accounts, this does not return a 404 error, rather it returns an object with balance and nonce of 0.

Path Parameters
principal string REQUIRED

Stacks address or a Contract identifier

Example: SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0
Query Parameters
proof integer

Returns object without the proof field if set to 0

tip string

The Stacks chain tip to query from

Responses
200

Success

Schema OPTIONAL
balance string
locked string
unlock_height integer
nonce integer
balance_proof string
nonce_proof string
get_account_info
GET /v2/accounts/:principal
principal — path
proof — query
tip — query
https://api.mainnet.hiro.so
curl -L 'https://api.mainnet.hiro.so/v2/accounts/:principal' \
-H 'Accept: application/json'