Skip to main content

getExpectedTotemDeletes

Retrieves unconfirmed, pending Totem share deletion (burning) transactions currently resting in the node's memory pool waiting to be forged in an upcoming block.


Endpoint Details

  • HTTP Method: POST
  • Gateway Path: /nxt
  • Content-Type: application/x-www-form-urlencoded
  • API Tags: AE
  • Chain Specific: Optional / Conditional

Request Parameters

ParameterTypeRequiredDescription
requestTypeStringYesMust be set to getExpectedTotemDeletes.
chainintNoSovereign BetaChain ID filter.
totemlong / StringNoUnique 6464-bit identifier of the Totem to filter by. Default: 0.
accountlong / StringNoFilter pending deletion transactions originating from a specific sender Account ID or Reed-Solomon address.
includeTotemInfobooleanNoIf true, embeds complete Totem metadata into each transaction JSON record. Default: false.

Example Request

curl -X POST http://localhost:22024/nxt \
-d "requestType=getExpectedTotemDeletes" \
-d "chain=2" \
-d "totem=9876543210123456789" \
-d "account=SHAMWARI-ABCD-EFGH-JKLM-NOPQR" \
-d "includeTotemInfo=true"

Successful Response

{
"deletes": [
{
"transaction": "76123049120394812",
"totem": "9876543210123456789",
"sender": "1234567890123456789",
"senderRS": "SHAMWARI-ABCD-EFGH-JKLM-NOPQR",
"quantityQNT": "500000",
"feeNQT": "10000000",
"type": 2,
"subtype": 5,
"totemInfo": {
"name": "HarareRealEstateFund",
"decimals": 4,
"type": 4,
"quantityQNT": "1000000000000"
}
}
]
}

Error Codes

Error CodeCause / Description
INCORRECT_CHAINInvalid or non-existent BetaChain ID specified in the request.
UNKNOWN_ACCOUNTThe specified account parameter is malformed or invalid.