POST /wallets/delete

Delete wallets. Primary wallets cannot be deleted.

Batch of up to 100 addresses. All-or-nothing: any unknown address or primary-wallet conflict rejects the whole call.

Use case

User removes wallets from their account after migrating funds out — call with the list of addresses they no longer want tracked.

Body

Field	Type	Required	Description
addresses	string[]	yes	1–100 pubkeys.

All-or-nothing.

Response 200

{ "deleted": ["Pubkey1…"] }

Errors

Status	Meaning
404	Any address unknown or already deleted.
409	Any address is the user's primary wallet. Response includes addresses of the offending entries.

Example

curl -X POST "$BASE_URL/wallets/delete" \
  -H "Authorization: Bearer $ACCESS" \
  -H "x-user-id: $USER_ID" \
  -H "Content-Type: application/json" \
  -d '{ "addresses": ["Pubkey1…"] }'