GetAccountTotems
Returns Totem holdings for a specific account, optionally filtered by Totem ID.
Request
GET /nxt?requestType=getAccountTotems
All endpoints use port 22024 by default.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
account | string | Account ID or SHAMWARI address | Yes |
totem | long | Filter by Totem ID | Optional |
height | int | Block height for historical query | Optional |
includeTotemInfo | boolean | Include Totem metadata in response | Optional |
Response
{
"accountTotems": [
{
"account": "1234567890",
"accountRS": "SHAMWARI-ABCD-EFGH-IJKL-MNOPQ",
"totem": "987654321",
"unitsQNT": "1000",
"unconfirmedUnitsQNT": "100",
"height": 250
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
account | string | Account ID |
accountRS | string | Account Reed-Solomon address in SHAMWARI format |
totem | string | Totem ID |
unitsQNT | string | Number of Totem units held |
unconfirmedUnitsQNT | string | Unconfirmed units |
height | int | Block height |
Error Codes
| Code | Description |
|---|---|
| 3 | Unknown account |
Example
curl "http://localhost:22024/nxt?requestType=getAccountTotems&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ"