Accounts

Get account information.

get

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

Authorizations

Path parameters

addressstringRequired

An account public key

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

Query parameters

formatstring · enumOptional

Configures whether the response object is JSON or MessagePack encoded. If not provided, defaults to JSON.

Available options:

excludestring · enumOptional

When set to all will exclude asset holdings, application local state, created asset parameters, any created application parameters. Defaults to none.

Available options:

Responses

application/jsonapplication/msgpack

objectOptional

Account information at a given round.

Definition: data/basics/userBalance.go : AccountData

application/jsonapplication/msgpack

application/jsonapplication/msgpack

application/jsonapplication/msgpack

get

HTTPcURLJavaScriptPython

GET /v2/accounts/{address} HTTP/1.1
Host: algo.nownodes.io
X-Algo-API-Token: YOUR_API_KEY
Accept: */*

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