Freeze / Unfreeze Wallet

Overview

The freeze function allows you to temporarily disable a wallet from all operations, including automated processes, outgoing transactions, and incoming transfers.

Freeze is used for:

• security and stopping suspicious activity,

• manual transaction review,

• maintenance,

• blocking payouts,

• blocking incoming deposits.

Behavior by Wallet Type

1. Master Wallet

When frozen:

• all outgoing transactions are blocked (payouts + system operations),

• master-side auto-sweep is disabled,

• payouts from master → cold are not possible,

• the wallet cannot spend native tokens for gas,

• any related payout requests automatically move to HOLD status.

When unfrozen:

• payouts are allowed again,

• auto-sweep and automated network operations resume,

• the wallet can again spend native tokens to pay gas fees.

---

2. Transit Wallet

When frozen:

• accepting deposit transactions is prohibited (the address is removed from the incoming payment distribution pool),

• auto-sweep is disabled,

• force-sweep is disabled,

• any movement of funds is blocked,

• the address is marked as inactive and is not used by the system.

A frozen transit wallet is effectively removed from active circulation but remains stored in the database.

When unfrozen:

• the wallet can accept deposits again,

• auto-sweep becomes active again,

• force-sweep is available again,

• the address is returned to the pool of active addresses for order generation.

---

3. Static Wallet

When frozen:

• incoming deposit detection is paused — new transactions on this address are ignored by the blockchain scanner,

• force-sweep is disabled,

• webhook and email notifications for new deposits are suspended,

• the wallet remains stored in the database and retains its address permanently.

When unfrozen:

• deposit detection resumes — the scanner begins tracking the address again,

• force-sweep is available again,

• webhook/email notifications resume for all new status changes.

Freeze / Unfreeze Wallet

POST https://api-processing.crypto-chief.com/v1/wallets/freeze

Headers

Name	Value
Content-Type	application/json
Signature	Signed request body
Merchant	Merchant ID

Body

Name	Type	Required	Description
address	string	true	address of the wallet to freeze/ unfreeze

Response

200

{
    "type": "master",
    "address": "0xe45d45e1af4cb62fb37402dc8e382dc573dc1ca2",
    "chain_family": "EVM",
    "frozen": true,
    "created_at": "2025-12-23T13:05:32Z",
    "private_key_encrypted": "J3pcwHb5kiAsYb6hA3tZl50lLCAl0WVp51TWFssHd5GhrzrUtWr+Q1wUibr4pia0AxRt50/MipJi3t1BEiymzlZvSk2rsxHbBXSeh+i2Sv9euo7mS4UNHErU7h5TamKbE2TWfEBeu7EuNbkomWTte1uvJ1VkgI3/kA50pGnjmKuxUTXPsXu9mlUpoXcR8jDRxzCffb+snBf7WH4xAh8c8VPJ0tmjslnKAWuA2HU7khG/oSkYvL8vtnWN6BROGC/umzq9wnqGdgf/BqIuNgjjvMTW/3qY73/8PHguSGNjooDX+CoihbrKU80+avo63zStDBOZtcYgMnY8XoKIBebIvA==",
    "master_wallet_address": null,
    "callback_url": null
}

400