POST /wallet/delete Deletes a wallet owned by your account.

​
Request

{
  "api_key": "sk_live_...",
  "wallet_id": "w_c8b07c7d-9c7d-4a33-9200-0bdfa82dc497"
}
FieldTypeRequiredNotes
api_keystring✓Customer API key.
wallet_idstring✓Wallet ID (w_<uuid>) or on-chain address.

​
Response

{
  "result": "ok",
  "wallet_name": "first_wallet"
}
  • Returns the wallet_name of the deleted wallet.
  • Plan quotas are recalculated so another wallet may become included in plan.

​
Errors

StatusPayloadWhen it happens
400{ "error": "Missing required fields" }Missing parameters.
403{ "error": "API key is not valid" }API key fails validation.
404{ "error": "Wallet not found" }Wallet does not exist or isn’t owned by your account.
500{ "error": "<message>" }Unexpected service error.

​
SDK equivalents

  • JavaScript: client.deleteWallet({ walletId })
  • Python: client.delete_wallet(wallet_id)