Accounts

Get account information.

Given a specific account public key, this call returns the accounts status, balance and spendable amounts

GEThttps://algo.nownodes.io/v2/accounts/{address}

Path parameters

address*string

An account public key

Pattern: [A-Z0-9]{58}

Query parameters

Response

200400401500default

AccountResponse wraps the Account type in a response.

Body

application/jsonapplication/msgpack

address*string

the account public key

amount*integer

[algo] total number of MicroAlgos in the account

amount-without-pending-rewards*integer

specifies the amount of MicroAlgos in the account, without the pending rewards.

apps-local-statearray of ApplicationLocalState (object)

[appl] applications local data stored in this account.

Note the raw object uses map[int] -> AppLocalState for this type.

apps-total-extra-pagesinteger

[teap] the sum of all extra application program pages for this account.

apps-total-schemaApplicationStateSchema (object)

Specifies maximums on the number of each type that may be stored.

assetsarray of AssetHolding (object)

[asset] assets held by this account.

Note the raw object uses map[int] -> AssetHolding for this type.

auth-addrstring

[spend] the address against which signing should be checked. If empty, the address of the current account is used. This field can be updated in any transaction by setting the RekeyTo field.

created-appsarray of Application (object)

[appp] parameters of applications created by this account including app global data.

Note: the raw account uses map[int] -> AppParams for this type.

created-assetsarray of Asset (object)

[apar] parameters of assets created by this account.

Note: the raw account uses map[int] -> Asset for this type.

min-balance*integer

MicroAlgo balance required by the account.

The requirement grows based on asset and application usage.

participationAccountParticipation (object)

AccountParticipation describes the parameters used by this account in consensus protocol.

pending-rewards*integer

amount of MicroAlgos of pending rewards in this account.

reward-baseinteger

[ebase] used as part of the rewards computation. Only applicable to accounts which are participating.

rewards*integer

[ern] total rewards of MicroAlgos the account has received, including pending rewards.

round*integer

The round for which this information is relevant.

sig-typeenum

Indicates what type of signature is used by this account, must be one of:

• sig
• msig
• lsig

sigmsiglsig

status*string

[onl] delegation status of the account's MicroAlgos

• Offline - indicates that the associated account is delegated.
• Online - indicates that the associated account used as part of the delegation pool.
• NotParticipating - indicates that the associated account is neither a delegator nor a delegate.

total-apps-opted-in*integer

The count of all applications that have been opted in, equivalent to the count of application local data (AppLocalState objects) stored in this account.

total-assets-opted-in*integer

The count of all assets that have been opted in, equivalent to the count of AssetHolding objects held by this account.

total-box-bytesinteger

[tbxb] The total number of bytes used by this account's app's box keys and values.

total-boxesinteger

[tbx] The number of existing boxes created by this account's app.

total-created-apps*integer

The count of all apps (AppParams objects) created by this account.

total-created-assets*integer

The count of all assets (AssetParams objects) created by this account.

Request

JavaScriptCurlPython

const response = await fetch('https://algo.nownodes.io/v2/accounts/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401500

{
  "address": "text",
  "amount": 0,
  "amount-without-pending-rewards": 0,
  "apps-local-state": [
    {
      "id": 0,
      "key-value": [
        {
          "key": "text",
          "value": {
            "bytes": "text",
            "type": 0,
            "uint": 0
          }
        }
      ],
      "schema": {
        "num-byte-slice": 0,
        "num-uint": 0
      }
    }
  ],
  "apps-total-extra-pages": 0,
  "apps-total-schema": {
    "num-byte-slice": 0,
    "num-uint": 0
  },
  "assets": [
    {
      "amount": 0,
      "asset-id": 0,
      "is-frozen": false
    }
  ],
  "auth-addr": "text",
  "created-apps": [
    {
      "id": 0,
      "params": {
        "approval-program": "Ynl0ZXM=",
        "clear-state-program": "Ynl0ZXM=",
        "creator": "text",
        "extra-program-pages": 0,
        "global-state": [
          {
            "key": "text",
            "value": {
              "bytes": "text",
              "type": 0,
              "uint": 0
            }
          }
        ],
        "global-state-schema": {
          "num-byte-slice": 0,
          "num-uint": 0
        },
        "local-state-schema": {
          "num-byte-slice": 0,
          "num-uint": 0
        }
      }
    }
  ],
  "created-assets": [
    {
      "index": 0,
      "params": {
        "clawback": "text",
        "creator": "text",
        "decimals": 0,
        "default-frozen": false,
        "freeze": "text",
        "manager": "text",
        "metadata-hash": "Ynl0ZXM=",
        "name": "text",
        "name-b64": "Ynl0ZXM=",
        "reserve": "text",
        "total": 0,
        "unit-name": "text",
        "unit-name-b64": "Ynl0ZXM=",
        "url": "text",
        "url-b64": "Ynl0ZXM="
      }
    }
  ],
  "min-balance": 0,
  "participation": {
    "selection-participation-key": "Ynl0ZXM=",
    "state-proof-key": "Ynl0ZXM=",
    "vote-first-valid": 0,
    "vote-key-dilution": 0,
    "vote-last-valid": 0,
    "vote-participation-key": "Ynl0ZXM="
  },
  "pending-rewards": 0,
  "reward-base": 0,
  "rewards": 0,
  "round": 0,
  "sig-type": "sig",
  "status": "text",
  "total-apps-opted-in": 0,
  "total-assets-opted-in": 0,
  "total-box-bytes": 0,
  "total-boxes": 0,
  "total-created-apps": 0,
  "total-created-assets": 0
}