Skip to main content

GetTotemAccounts

Retrieves accounts holding a specific totem, paginated.

Endpoint: GET /nxt?requestType=GetTotemAccounts

Parameters:

  • totem (long, required): The totem ID
  • height (int, optional, default: current): Block height at which to query holdings
  • firstIndex (int, optional, default: 0): Starting index for pagination
  • lastIndex (int, optional, default: 99): Ending index for pagination

Request Example: /nxt?requestType=GetTotemAccounts&totem=123456789&firstIndex=0&lastIndex=49

Response:

{
  "accountTotems": [
    {
      "account": "111111111",
      "totem": "123456789",
      "quantityQNT": "100000000",
      "unconfirmedQuantityQNT": "0"
    },
    {
      "account": "222222222",
      "totem": "123456789",
      "quantityQNT": "50000000",
      "unconfirmedQuantityQNT": "1000000"
    }
  ]
}

Response Fields (with includeAccount=true, includeTotemInfo=false):

  • accountTotems: array - Array of account-totem holding objects
  • accountTotems[].account: string - Account ID (unsigned string)
  • accountTotems[].totem: string - Totem ID (unsigned string)
  • accountTotems[].quantityQNT: string - Confirmed balance in Quantum Units
  • accountTotems[].unconfirmedQuantityQNT: string - Unconfirmed balance in Quantum Units

Source: GetTotemAccounts.java