V2 Features - Advanced Analysis

The V2 parameters provide advanced filtering and analysis capabilities for professional traders and institutions.

Time-Based Filtering

Timeframe Parameter

Filter positions by when they were opened:

?timeframe=24h  # Positions opened in last 24 hours
?timeframe=7d   # Positions opened in last 7 days
?timeframe=30d  # Positions opened in last 30 days

Hold Time Filtering

Filter by position duration:

?min_hold_time=10&max_hold_time=100  # Positions held 10-100 hours

Position Size Analysis

Value Filtering

Filter by position value in USD:

?min_position_value=10000  # Only positions > $10k

Size Buckets

Categorize by position size:

?position_size_bucket=whale   # Only whale positions
?position_size_bucket=large   # Large positions
?position_size_bucket=medium  # Medium positions
?position_size_bucket=small   # Small positions

Enhanced Metrics

Position Changes

Track position changes over time:

?include_changes=true&change_window=24h

Returns:

• position_change_24h: Change in position count
• money_flow_24h: Change in money flow
• new_positions_24h: Newly opened positions
• closed_positions_24h: Recently closed positions

Distribution Analysis

Get position size distribution:

?include_distribution=true

Returns breakdown by size:

• 0-10k: Small positions
• 10k-100k: Medium positions
• 100k-1m: Large positions
• 1m+: Whale positions

Confidence Metrics

Get statistical confidence scores:

?include_confidence=true

Returns:

• position_confidence: Statistical confidence (0-100)
• sample_size: Number of positions analyzed
• trend_strength: Strength of directional trend (0-100)

Volatility Metrics

Track position volatility:

?include_volatility=true

Returns:

• position_volatility_24h: 24-hour volatility score
• volatility_trend: Direction (increasing/decreasing/stable)

Signal Strength Filtering

Filter by signal quality:

?signal_strength=strong    # Only strong signals
?signal_strength=moderate  # Moderate signals
?signal_strength=weak      # Include weak signals

Complete V2 Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.0xathena.ai/smart-money/token-stats?\
timeframe=24h&\
min_position_value=50000&\
position_size_bucket=large&\
include_changes=true&\
change_window=24h&\
include_distribution=true&\
include_confidence=true&\
include_volatility=true&\
signal_strength=strong&\
min_positions=10"

This advanced query:

• Analyzes positions from last 24 hours
• Filters for positions > $50k
• Focuses on large position sizes
• Includes all enhanced metrics
• Only shows strong signals
• Requires at least 10 positions

Use Cases

1. Institutional Analysis

?position_size_bucket=whale&min_position_value=1000000&include_confidence=true

2. Short-Term Trading

?timeframe=6h&include_volatility=true&include_changes=true&change_window=1h

3. Risk Management

?signal_strength=strong&include_confidence=true&min_positions=20

4. Market Sentiment Shifts

?include_changes=true&change_window=24h&sort_by=position_change

Links: Website · GitHub · Support