Skip to main content

Clear Unconfirmed Transactions

Clears all unconfirmed transactions from the transaction processor. Requires admin password. This is a POST-only endpoint.

Request

POST /nxt?requestType=clearUnconfirmedTransactions&adminPassword=<adminPassword>

Parameters

NameTypeRequiredDescription
adminPasswordstringConditionalAdmin password required if nxt.adminPassword is set.

Response

{
"done": true
}

Response Fields

FieldTypeDescription
donebooleantrue if clearing was successful.

Error Responses

ConditionResponse
Runtime exception during clearError response from JSONData.putException()

Notes

  • This endpoint does not require the blockchain to be running (requireBlockchain = false).
  • Not chain-specific.
  • Requires admin password authentication (requirePassword = true).
  • Requires POST method (requirePost = true).
  • Calls Nxt.getTransactionProcessor().clearUnconfirmedTransactions().

Source: ClearUnconfirmedTransactions.java.

Example

curl -X POST "http://localhost:22024/nxt" \
-d "requestType=clearUnconfirmedTransactions" \
-d "adminPassword=mySecretPassword"