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.

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
}

400