Machine-Learning-Driven Wallet Clustering

Implementation Details

Class Names

Model Name	Parameters Class	Data Class
WalletClustering	WalletClusteringQueryParams	WalletClusteringData

Import Statement

pythonCopyEditfrom satoshi_terminal.models.wallet_clustering import (
    WalletClustering,
    WalletClusteringQueryParams,
    WalletClusteringData,
)

---

Parameters

Name	Type	Description	Default	Optional
wallet_address	Union[str, List[str]]	Wallet address(es) to include in clustering analysis.	None	True
clustering_method	str	Method for clustering (e.g., "Behavioral", "Geographic").	None	True
time_range	Tuple[datetime, datetime]	Date range for activity clustering.	None	True

---

Data

Name	Type	Description
cluster_id	str	Identifier for the wallet cluster.
wallet_addresses	List[str]	List of wallets in the cluster.
common_behaviors	List[str]	Frequently observed patterns among wallets in the cluster.
anomaly_score	float	Anomaly score for unusual activity within the cluster.
timestamp	datetime	Timestamp of the clustering operation.