Skip to main content

GetTotem

Retrieves information for a single totem by its ID.

Endpoint: GET /nxt?requestType=GetTotem

Parameters:

  • totem (long, required): The totem ID to retrieve
  • includeCounts (boolean, optional, default: false): Include transfer and account counts

Request Example: /nxt?requestType=GetTotem&totem=123456789&includeCounts=true

Response:

{
  "issuer": "1234567890",
  "name": "Totem Name",
  "description": "Totem Description",
  "decimals": 8,
  "quantityQNT": "100000000",
  "totem": "123456789",
  "hasPhasingTotemControl": true,
  "numberOfTransfers": 42,
  "numberOfAccounts": 10
}

Response Fields (from JSONData.totem):

  • issuer: string - Account ID of the issuer (unsigned string)
  • name: string - Human-readable name of the totem
  • description: string - Description of the totem
  • decimals: number - Number of decimal places (0-8)
  • quantityQNT: string - Current circulating supply in Quantum Units
  • totem: string - Totem ID (unsigned string)
  • hasPhasingTotemControl: boolean - Whether totem has phasing control enabled
  • numberOfTransfers: number - Only if includeCounts=true, total transfer count
  • numberOfAccounts: number - Only if includeCounts=true, number of accounts holding this totem

Source: GetTotem.java, JSONData.totem()