Token Snapshot

Field Reference

Overview

The TradeActivityStats class represents comprehensive trade and volume statistics for cryptocurrency tokens over configurable time windows.

This immutable data model captures OHLCV candle data, transaction metrics, volume analytics, and unique participant tracking.

Field Reference

Time Window Fields

Field	Type	Description
mintId	String	Token mint identifier
windowStart	long	Window start timestamp (epoch milliseconds)
windowEnd	long	Window end timestamp (epoch milliseconds)
windowDurationMillis	long	Explicit window duration in milliseconds
windowLabel	String	Human-readable window label (e.g., "1m", "5m", "1h", "24h")

OHLCV Price Data

Field	Type	Description
openPrice	double	Opening price (first trade in window)
highPrice	double	Highest price traded in the window
lowPrice	double	Lowest price traded in the window
closePrice	double	Closing price (last trade in window)

Volume Metrics - Token Units

Field	Type	Description
totalVolume	double	Total trade volume in token units
buyVolume	double	Buy-side volume in token units
sellVolume	double	Sell-side volume in token units

Volume Metrics - Quote Currency

Field	Type	Description
totalVolumeQuote	double	Total volume in quote currency (USDT/SOL)
buyVolumeQuote	double	Buy-side volume in quote currency
sellVolumeQuote	double	Sell-side volume in quote currency

Volume Ratios

Field	Type	Description
buyVolumePercentage	double	Buy volume as percentage of total (0-100)
sellVolumePercentage	double	Sell volume as percentage of total (0-100)

Transaction Counts

Field	Type	Description
totalTxCount	int	Total number of transactions (buys + sells)
buyTxCount	int	Number of buy transactions
sellTxCount	int	Number of sell transactions

Transaction Ratios

Field	Type	Description
buySellCountRatio	double	Ratio of buy to sell transaction counts
buyCountPercentage	double	Buy transactions as percentage of total
sellCountPercentage	double	Sell transactions as percentage of total

Unique Participants

Field	Type	Description
uniqueBuyers	Set<String>	Set of unique buyer wallet IDs
uniqueSellers	Set<String>	Set of unique seller wallet IDs
uniqueBuyerCount	int	Count of unique buyers in the window
uniqueSellerCount	int	Count of unique sellers in the window

Transaction References

Field	Type	Description
openTxSignature	String	Transaction hash of the opening trade
closeTxSignature	String	Transaction hash of the closing trade

Field Categories Summary

• Time Window: 5 fields defining the temporal scope

• OHLCV Data: 4 fields for candlestick price information

• Volume Metrics: 9 fields covering token and quote currency volumes with ratios

• Transaction Metrics: 6 fields for transaction counts and ratios

• Participants: 4 fields tracking unique buyers and sellers

• References: 2 fields linking to boundary transactions

Total Fields: 30 fields providing comprehensive trading analytics data

Usage Notes

• All price and volume fields use double precision for accurate financial calculations

• Transaction counts use int type, suitable for typical trading volumes

• Unique participant tracking uses Set<String> for efficient deduplication

• Timestamps are stored as epoch milliseconds (long) for precise time tracking

• The class is immutable and uses the builder pattern for construction