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.

Last updated