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
| Parameter | Type | Required | Description |
|---|---|---|---|
requestType | String | Yes | Must be set to getAllTotems. |
firstIndex | int | No | Zero-based start index for pagination. Default: 0. |
lastIndex | int | No | End index for pagination. Default: -1 (returns all Totems). |
includeCounts | boolean | No | If 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 Code | Cause / Description |
|---|---|
INCORRECT_INDEX | Invalid firstIndex or lastIndex pagination bounds. |