DeleteCurrency
Deletes a currency from the Monetary System. Only currencies with specific properties can be deleted.
Request
POST /nxt?requestType=deleteCurrency
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
secretPhrase | string | Currency issuer's secret passphrase | Yes |
currency | long | Currency ID to delete | Yes |
Deletion Constraints
- The currency must be deletable by the issuer account
- Only certain currency types support deletion
- Deleted currencies may still have historical transfer records
Response
{
"transaction": "1234567890123456789",
"fullHash": "abc123...",
"errorCode": 0,
"errorDescription": ""
}
Error Handling
| Error | Condition |
|---|---|
CANNOT_DELETE_CURRENCY | Currency cannot be deleted by this account |
UNKNOWN_CURRENCY | Specified currency does not exist |
Example
curl -X POST http://localhost:22024/nxt \
-d "requestType=deleteCurrency" \
-d "secretPhrase=your_phrase" \
-d "currency=987654321"