Accounts

get

Search for accounts.

Query parameters

asset-idintegerOptional

Asset ID

limitintegerOptional

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringOptional

The next page of results. Use the next token provided by the previous results.

currency-greater-thanintegerOptional

Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.

include-allbooleanOptional

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

excludestring · enum[]Optional

Exclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account.

currency-less-thanintegerOptional

Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.

auth-addrstringOptional

Include accounts configured to use this spending key.

roundintegerOptional

Include results for the specified round. For performance reasons, this parameter may be disabled on some configurations. Using application-id or asset-id filters will return both creator and opt-in accounts. Filtering by include-all will return creator and opt-in accounts for deleted assets and accounts. Non-opt-in managers are not included in the results when asset-id is used.

application-idintegerOptional

Application ID

Responses

application/json

objectOptional

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v2/accounts HTTP/1.1
Host: algo-index.nownodes.io
Accept: */*

{
  "accounts": [
    {
      "address": "text",
      "amount": 1,
      "amount-without-pending-rewards": 1,
      "apps-local-state": [
        {
          "closed-out-at-round": 1,
          "deleted": true,
          "id": 1,
          "key-value": [
            {
              "key": "text",
              "value": {
                "bytes": "text",
                "type": 1,
                "uint": 1
              }
            }
          ],
          "opted-in-at-round": 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,
          "deleted": true,
          "is-frozen": true,
          "opted-in-at-round": 1,
          "opted-out-at-round": 1
        }
      ],
      "auth-addr": "text",
      "closed-at-round": 1,
      "created-apps": [
        {
          "created-at-round": 1,
          "deleted": true,
          "deleted-at-round": 1,
          "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": [
        {
          "created-at-round": 1,
          "deleted": true,
          "destroyed-at-round": 1,
          "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="
          }
        }
      ],
      "created-at-round": 1,
      "deleted": true,
      "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
    }
  ],
  "current-round": 1,
  "next-token": "text"
}

get

Lookup account information.

Path parameters

account-idstringRequired

account string

Query parameters

roundintegerOptional

Include results for the specified round.

include-allbooleanOptional

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

excludestring · enum[]Optional

Exclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account.

Responses

application/json

objectOptional

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v2/accounts/{account-id} HTTP/1.1
Host: algo-index.nownodes.io
Accept: */*

{
  "account": {
    "address": "text",
    "amount": 1,
    "amount-without-pending-rewards": 1,
    "apps-local-state": [
      {
        "closed-out-at-round": 1,
        "deleted": true,
        "id": 1,
        "key-value": [
          {
            "key": "text",
            "value": {
              "bytes": "text",
              "type": 1,
              "uint": 1
            }
          }
        ],
        "opted-in-at-round": 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,
        "deleted": true,
        "is-frozen": true,
        "opted-in-at-round": 1,
        "opted-out-at-round": 1
      }
    ],
    "auth-addr": "text",
    "closed-at-round": 1,
    "created-apps": [
      {
        "created-at-round": 1,
        "deleted": true,
        "deleted-at-round": 1,
        "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": [
      {
        "created-at-round": 1,
        "deleted": true,
        "destroyed-at-round": 1,
        "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="
        }
      }
    ],
    "created-at-round": 1,
    "deleted": true,
    "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
  },
  "current-round": 1
}