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 Wallet

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

Headers

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

Body

Name	Type	Required	Description
uuid	string	true	UUID of the wallet to freeze

Response

200

{
  "uuid": "8c1bd3c3-5c7c-4c1c-9af1-0f2127d8c317",
  "status": "frozen"
}

400

Unfreeze Wallet

POST https://api-processing.crypto-chief.com/v1/wallet/unfreeze

Headers

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

Body

Name	Type	Required	Description
uuid	string	true	UUID of the wallet to unfreeze

Response

200

{
  "uuid": "8c1bd3c3-5c7c-4c1c-9af1-0f2127d8c317",
  "status": "active"
}

400