# Time-Locked Wallet Monitoring

**Implementation Details**

**Class Names**

| Model Name                 | Parameters Class            | Data Class           |
| -------------------------- | --------------------------- | -------------------- |
| TimeLockedWalletMonitoring | TimeLockedWalletQueryParams | TimeLockedWalletData |

**Import Statement**

```python
pythonCopyEditfrom satoshi_terminal.models.time_locked_wallet_monitoring import (
    TimeLockedWalletMonitoring,
    TimeLockedWalletQueryParams,
    TimeLockedWalletData,
)
```

***

**Parameters**

| Name                | Type                       | Description                                                | Default | Optional |
| ------------------- | -------------------------- | ---------------------------------------------------------- | ------- | -------- |
| wallet\_address     | Union\[str, List\[str]]    | Address(es) of time-locked wallets to monitor.             | None    | False    |
| unlock\_time\_range | Tuple\[datetime, datetime] | Time range to track wallet unlock schedules.               | None    | True     |
| include\_historical | bool                       | Whether to include historical data on past wallet unlocks. | False   | True     |

***

**Data**

| Name              | Type     | Description                                                          |
| ----------------- | -------- | -------------------------------------------------------------------- |
| wallet\_address   | str      | Address of the time-locked wallet analyzed.                          |
| unlock\_timestamp | datetime | Scheduled time for the wallet unlock.                                |
| locked\_amount    | float    | Total amount locked in the wallet.                                   |
| unlock\_status    | str      | Current status of the wallet (e.g., "Locked," "Partially Unlocked"). |
| timestamp         | datetime | Timestamp of the monitoring data.                                    |

***

**Key Features**

* **Real-Time Unlock Tracking:** Continuously monitor wallets with time-lock features.
* **Risk Assessment for Large Unlocks:** Highlight wallets unlocking large amounts that may impact market liquidity.
* **Historical Unlock Trends:** Analyze past wallet behavior for patterns in unlocking and spending.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.satoshiterminal.io/resources/copy-of-defi-analytics/monitoring-and-tracking/time-locked-wallet-monitoring.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
