API Reference: deleteTotemShares

Permanently destroys (burns) a specified quantity of Totem units held by the sender account, reducing circulating supply in TotemHistory.

---

Endpoint Details

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

---

Request Parameters

Parameter	Type	Required	Description
requestType	String	Yes	Must be set to deleteTotemShares.
totem	long	Yes	Unique 64-bit Totem identifier.
quantityQNT	long	Yes	Number of base Quantum units (QNT) to destroy.
chain	int	Yes	Sovereign BetaChain ID where the Totem exists.
secretPhrase	String	Yes	Passphrase of the account holding the Totems.
feeNQT	long	Conditional	Transaction execution fee in base units (NQT).
deadline	short	Conditional	Transaction expiration window in minutes (1-1440).

---

Example Request

curl -X POST http://localhost:22024/nxt \
  -d "requestType=deleteTotemShares" \
  -d "chain=2" \
  -d "totem=9876543210123456789" \
  -d "quantityQNT=500000" \
  -d "secretPhrase=your_pqc_passphrase" \
  -d "feeNQT=10000000"

---

Successful Response

{
  "signatureHash": "c7d8e9f0...",
  "unsignedTransactionBytes": "0100...",
  "transactionJSON": {
    "sender": "1234567890123456789",
    "feeNQT": "10000000",
    "type": 2,
    "subtype": 5,
    "attachment": {
      "version.TotemSharesDeletion": 1,
      "totem": "9876543210123456789",
      "quantityQNT": "500000"
    },
    "timestamp": 89234200
  },
  "broadcasted": true,
  "transaction": "76123049120394812"
}

---

Error Codes

Error Code	Cause / Description
NOT_ENOUGH_TOTEMS	Sender account holds fewer unconfirmed Totem units than requested for deletion.
UNKNOWN_TOTEM	Totem ID does not exist on the target BetaChain.