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.

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
200
(empty)
application/json
get
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.

Responses
200
(empty)
application/json
get
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
}
PreviousHealthNextApps local state