Token Velocity Heatmaps

Implementation Details

Class Names

Model Name	Parameters Class	Data Class
TokenVelocityHeatmaps	TokenVelocityQueryParams	TokenVelocityData

Import Statement

pythonCopyEditfrom satoshi_terminal.models.token_velocity_heatmaps import (
    TokenVelocityHeatmaps,
    TokenVelocityQueryParams,
    TokenVelocityData,
)

---

Parameters

Name	Type	Description	Default	Optional
token_symbol	Union[str, List[str]]	Token(s) to analyze for velocity patterns.	None	False
time_horizon	int	Time window (in days) for tracking token velocity.	7	True
include_visuals	bool	Generate visual heatmaps for velocity patterns.	True	True

---

Data

Name	Type	Description
token_symbol	str	Symbol of the token analyzed.
average_velocity	float	Average velocity (transaction frequency relative to supply).
high_activity_zones	List[str]	Regions or addresses with the highest token activity.
velocity_trend	List[float]	Historical velocity trends over the specified period.
timestamp	datetime	Timestamp of the analysis.

---

Key Features

• Transaction Frequency Analysis: Evaluates how frequently tokens are transacted relative to supply.

• High Activity Zones: Highlights regions or wallets with the most significant transaction volumes.

• Dynamic Heatmap Generation: Provides visual representations of token velocity across time and regions.