Remove an address from Host Mode
Removes the address from Host Mode entirely, together with its registered callback_url. The address can be added again later with /time/add.
Without the stop flag the address must be inactive and have no open orders — otherwise the call is refused and nothing changes.
The stop flag. With it an active address is stopped and deleted in one call: all open orders are closed, the mode is switched off, the cycle counter is reset, the stop is written to your action history — and only then is the address deleted. Both steps run in one transaction: either the address is stopped and deleted, or nothing changes at all. There is no state where the address ends up stopped but still registered. On an address that is already inactive and has no open orders the flag changes nothing.
Billing is unaffected: stopping refunds nothing and deleting charges nothing. Cycles already paid for stay paid, and delegated energy is reclaimed on its normal schedule.
Deleting is always available, regardless of your balance.
Authorizations
API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.
Request Body
Responses
Success is code: 0. Every error of this method uses code: -1 and arrives with HTTP 200: authentication, address format, the address is not yours, an attempt to delete an active address without stop, open orders without stop, or a database error. application/json: schema: { $ref: '#/components/schemas/HostEnvelope' } examples: ok: summary: 'Deleted' value: code: 0 msg: Address deleted successfully data: address: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE timestamp: '2026-07-13T05:30:15.123456' active: summary: 'Active address without the stop flag' value: code: -1 msg: Cannot delete an active address. Stop Host mode first data: null