Reputation-Based Wallet Scoring

Implementation Details

Class Names

Model Name	Parameters Class	Data Class
ReputationWalletScoring	WalletReputationQueryParams	WalletReputationData

Import Statement

pythonCopyEditfrom satoshi_terminal.models.reputation_based_wallet_scoring import (
    ReputationWalletScoring,
    WalletReputationQueryParams,
    WalletReputationData,
)

---

Parameters

Name	Type	Description	Default	Optional
wallet_address	Union[str, List[str]]	Wallet address(es) to evaluate for reputation scoring.	None	False
scoring_criteria	List[str]	Criteria for scoring (e.g., "Transaction History," "DeFi Participation").	None	True
time_horizon	int	Time window (in days) for evaluating wallet activities.	30	True

---

Data

Name	Type	Description
wallet_address	str	Wallet address analyzed for reputation.
reputation_score	float	Overall reputation score (0-100).
scoring_breakdown	dict	Breakdown of scores by criteria (e.g., transaction volume, staking activity).
flagged_behaviors	List[str]	List of detected behaviors that negatively impacted reputation.
timestamp	datetime	Timestamp of the analysis.

---

Key Features

• Behavioral Scoring: Evaluates wallets based on transaction patterns, DeFi activity, and compliance.

• Customizable Criteria: Allows users to define metrics that contribute to reputation scoring.

• Risk Alerts: Flags wallets exhibiting risky behaviors like frequent liquidation events or anomalies.