Time-Locked Wallet Monitoring

Implementation Details

Class Names

Model Name	Parameters Class	Data Class
TimeLockedWalletMonitoring	TimeLockedWalletQueryParams	TimeLockedWalletData

Import Statement

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.