Skip to main content

getAllTotems

Retrieves a paginated list of all Totems issued across the network, with optional aggregated counts for issuers, holders, and transfers.


Endpoint Details

  • HTTP Method: POST
  • Gateway Path: /nxt
  • Content-Type: application/x-www-form-urlencoded
  • API Tags: AE
  • Chain Specific: No (Global network state query)

Request Parameters

ParameterTypeRequiredDescription
requestTypeStringYesMust be set to getAllTotems.
firstIndexintNoZero-based start index for pagination. Default: 0.
lastIndexintNoEnd index for pagination. Default: -1 (returns all Totems).
includeCountsbooleanNoIf set to true, includes total issuer, holder, and transfer statistics. Default: false.

Example Request

curl -X POST http://localhost:22024/nxt \
-d "requestType=getAllTotems" \
-d "firstIndex=0" \
-d "lastIndex=5" \
-d "includeCounts=true"

Successful Response

{
"totems": [
{
"totem": "9876543210123456789",
"issuer": "1234567890123456789",
"issuerRS": "SHAMWARI-ABCD-EFGH-JKLM-NOPQR",
"name": "HarareRealEstateFund",
"description": "Tokenized Prime Commercial Property in Harare CBD",
"quantityQNT": "1000000000000",
"maxQuantityQNT": "5000000000000",
"decimals": 4,
"type": 4,
"numberOfIssuers": 1,
"numberOfHolders": 142,
"numberOfTransfers": 589
}
]
}

Error Codes

Error CodeCause / Description
INCORRECT_INDEXInvalid firstIndex or lastIndex pagination bounds.