Accounts

Read-only endpoints to obtain Stacks account details

Get account assets

get

Retrieves a list of all assets events associated with an account or a Contract Identifier. This includes Transfers, Mints.

Authorizations
Path parameters
principalany ofRequired
stringOptional

STX Address

Example: ["SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}
or
stringOptional

Smart Contract ID

Example: ["SP000000000000000000002Q6VF78.pox-3"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$
Query parameters
limitinteger · max: 100Optional

Results per page

Default: 20
offsetintegerOptional

Result offset

Default: 0
unanchoredbooleanOptional

Include data from unanchored (i.e. unconfirmed) microblocks

Default: falseExample: true
until_blockstringOptional

Block hash or block height. Return data representing the state up until that point in time, rather than the current block. Note - Use either of the query parameters but not both at a time.

Example: {"60000":{"value":"60000"},"0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79":{"value":"0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79"}}
Responses
200
Default Response
application/json
get
GET /extended/v1/address/{principal}/assets HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "event_index": 1,
      "event_type": "smart_contract_log",
      "tx_id": "text",
      "contract_log": {
        "contract_id": "text",
        "topic": "text",
        "value": {
          "hex": "text",
          "repr": "text"
        }
      }
    }
  ]
}

Get inbound STX transfers

get

Retrieves a list of STX transfers with memos to the given principal. This includes regular transfers from a stx-transfer transaction type, and transfers from contract-call transactions a the send-many-memo bulk sending contract.

Authorizations
Path parameters
principalany ofRequired
stringOptional

STX Address

Example: ["SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}
or
stringOptional

Smart Contract ID

Example: ["SP000000000000000000002Q6VF78.pox-3"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$
Query parameters
limitinteger · max: 50Optional

Results per page

Default: 20
offsetintegerOptional

Result offset

Default: 0
heightintegerOptional

Filter for transactions only at this given block height

unanchoredbooleanOptional

Include data from unanchored (i.e. unconfirmed) microblocks

Default: falseExample: true
until_blockstringOptional

Block hash or block height. Return data representing the state up until that point in time, rather than the current block. Note - Use either of the query parameters but not both at a time.

Example: {"60000":{"value":"60000"},"0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79":{"value":"0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79"}}
Responses
200
Default Response
application/json
get
GET /extended/v1/address/{principal}/stx_inbound HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "sender": "text",
      "amount": "text",
      "memo": "text",
      "block_height": 1,
      "tx_id": "text",
      "transfer_type": "bulk-send",
      "tx_index": 1
    }
  ]
}

Get the latest nonce used by an account

get

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

Authorizations
Path parameters
principalany ofRequired
stringOptional

STX Address

Example: ["SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}
or
stringOptional

Smart Contract ID

Example: ["SP000000000000000000002Q6VF78.pox-3"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$
Query parameters
block_heightinteger · min: 1Optional

Optionally get the nonce at a given block height.

Example: 66119
block_hashstringOptional

Optionally get the nonce at a given block hash. Note - Use either of the query parameters but not both at a time.

Example: 0x72d53f3cba39e149dcd42708e535bdae03d73e60d2fe853aaf61c0b392f521e9
Responses
200
The latest nonce values used by an account by inspecting the mempool, microblock transactions, and anchored transactions
application/json
get
GET /extended/v1/address/{principal}/nonces HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "last_mempool_tx_nonce": 1,
  "last_executed_tx_nonce": 1,
  "possible_next_nonce": 1,
  "detected_missing_nonces": [
    1
  ],
  "detected_mempool_nonces": [
    1
  ]
}

Get principal STX balance

get

Retrieves STX account balance information for a given Address or Contract Identifier.

Authorizations
Path parameters
principalany ofRequired
stringOptional

STX Address

Example: ["SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}
or
stringOptional

Smart Contract ID

Example: ["SP000000000000000000002Q6VF78.pox-3"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$
Query parameters
include_mempoolbooleanOptional

Include pending mempool transactions in the balance calculation

Default: false
Responses
200
Default Response
application/json
get
GET /extended/v2/addresses/{principal}/balances/stx HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "balance": "text",
  "estimated_balance": "text",
  "pending_balance_inbound": "text",
  "pending_balance_outbound": "text",
  "total_sent": "text",
  "total_received": "text",
  "total_fees_sent": "text",
  "total_miner_rewards_received": "text",
  "lock_tx_id": "text",
  "locked": "text",
  "lock_height": 1,
  "burnchain_lock_height": 1,
  "burnchain_unlock_height": 1
}

Get principal FT balances

get

Retrieves Fungible-token account balance information for a given Address or Contract Identifier.

Authorizations
Path parameters
principalany ofRequired
stringOptional

STX Address

Example: ["SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}
or
stringOptional

Smart Contract ID

Example: ["SP000000000000000000002Q6VF78.pox-3"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$
Query parameters
limitinteger · max: 200Optional

Results per page

Default: 100
offsetintegerOptional

Result offset

Default: 0
Responses
200
Default Response
application/json
get
GET /extended/v2/addresses/{principal}/balances/ft HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "token": "text",
      "balance": "text"
    }
  ]
}

Get principal FT balance

get

Retrieves a specific fungible-token balance for a given principal.

Authorizations
Path parameters
principalany ofRequired
stringOptional

STX Address

Example: ["SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}
or
stringOptional

Smart Contract ID

Example: ["SP000000000000000000002Q6VF78.pox-3"]Pattern: ^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$
tokenstringRequired

fungible token identifier

Example: {"SM3VDXK3WZZSA8\"400\"FKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token":{"value":"SM3VDXK3WZZSA8\"400\"FKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token"},"SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-aeusdc::aeUSDC":{"value":"SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-aeusdc::aeUSDC"}}
Responses
200
Default Response
application/json
get
GET /extended/v2/addresses/{principal}/balances/ft/{token} HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "balance": "text"
}
NextBlocks