CO-A

Indicator Documentation

This document provides a systematic overview of the Activity and Sentiment indicators , including their definitions, calculation methods, data specifications, and application guidelines. The dataset supports multiple time granularities and multi-asset coverage, designed for quantitative analysis, market sentiment research, and strategy modeling.

1. Data Specifications

1.1 Time Granularity

The V2 dataset supports four levels of temporal resolution, covering both high-frequency and low-frequency analytical needs:

15 minutes (15m)
1 hour (1H)
4 hours (4H)
1 day (1D)

1.2 Asset Coverage

Full Coverage: BTC, ETH (available across all time granularities)
Broad Coverage: BNB, DOGE, SOL, UNI, etc. (available for 1D / 4H / 1H)
Basic Coverage: AIN, DOT, TRX, etc. (available for 1D / 4H)

Note: Coverage tiers are determined by each asset’s liquidity, community activity, and data stability. Higher-liquidity assets support finer-grained data.

1.3 Time Range & Update Frequency

Start time: 2025-01-01 00:00:00 (UTC)
End time: Real-time updates
Minimum update frequency: Every 15 minutes

2. Indicator System

2.1 Activity Indicators

Code

Field Name

Type

Indicator Name

Version

CO-A-01-03

volume

Numeric

Total Mentions per Token

v1.0.1

Indicator Description

Definition: The total number of messages mentioning a given token within the specified time granularity across all tracked community channels.
Statistical Characteristics: Non-negative integer; fluctuates in response to changes in the token’s market attention and community activity level.

2.2 Emotion Indicator

Code

Field Name

Type

Indicator Name

Version

CO-A-02-01

positive_message_ratio

Numeric

Percentage of positive emotions

v1.0.1

CO-A-02-02

negative_message_ratio

Numeric

Percentage of negative emotions

v1.0.1

CO-A-02-03

emotional_volatility

Numeric

Emotional momentum

v1.0.1

2.2.1 Positive Sentiment Ratio (CO-A-02-01)

Definition: Within the specified time window, this indicator measures the proportion of community messages related to a given token that are classified as positive by the sentiment analysis model, relative to the total number of positive + negative messages.Formula:

Value Range: [0, 1] — higher values indicate stronger overall positive sentiment toward the token.

2.2.2 Negative Sentiment Ratio (CO-A-02-02)

Definition: Within the specified time window, this indicator measures the proportion of community messages related to a given token that are classified as negative by the sentiment analysis model, relative to the total number of positive + negative messages.Formula:

Value Range: [0, 1] — higher values indicate stronger overall negative sentiment toward the token.

2.2.3 Sentiment Momentum (CO-A-02-03)

Definition: Sentiment Momentum captures both the direction and intensity of community sentiment shifts. It is defined as the difference between the Positive Sentiment Ratio and the Negative Sentiment Ratio.Core Formula:

Outlier Handling Mechanism: To ensure indicator stability, the calculation incorporates a moving-window mean and standard deviation adjustment to smooth extreme fluctuations and mitigate short-term noise.

Where:

window_mean — the moving average calculated over the previous 30 periods.
σ (sigma) — the standard deviation calculated over the previous 30 periods.

Value Range: [-1, 1]

Values closer to 1 indicate a dominant positive sentiment in the community.
Values closer to -1 indicate a dominant negative sentiment in the community.

3. Example Applications

To illustrate the use of sentiment indicators, we select tokens of high, medium, and low market capitalization — ETC, UNI, and APE respectively — and compare their Sentiment Momentum with closing prices at 4H and 1D time granularities. The visualization aims to explore the correlation and co-movement between community sentiment and market price dynamics.