Introduction to Athena AI Smart Money API
Welcome to the Athena AI Smart Money API! This API provides real-time insights into smart money positioning across cryptocurrency markets, helping you make informed trading decisions based on what professional traders are doing.
What is Smart Money?
"Smart money" refers to positions and trades made by professional traders, institutional investors, and high-performing individuals in the cryptocurrency futures markets. By tracking their collective behavior, you can gain valuable insights into market sentiment and potential price movements.
What This API Provides
📊 Real-Time Position Data
- Token Sentiment: See whether smart money is long, short, or neutral on specific cryptocurrencies
- Position Strength: Understand the conviction behind each position
- Money Flow: Track where capital is moving in real-time
👥 Trader Analytics
- Top Traders: Identify and follow the most successful traders
- Portfolio Insights: See what positions the best traders are holding
- Performance Metrics: Win rates, PnL, Sharpe ratios, and more
⏱️ Time-Based Analysis
- Hold Times: Understand whether positions are short-term trades or long-term holds
- Position Changes: See how sentiment shifts over 1h, 6h, and 24h windows
- Trend Detection: Identify accumulation, distribution, and reversal patterns
🐋 Size-Based Filtering
- Whale Positions: Focus on million-dollar+ positions
- Institutional Activity: Track large professional trades
- Retail vs Pro: Compare retail and institutional positioning
Who Should Use This API?
This API is perfect for:
- Algorithmic Traders: Build data-driven trading strategies
- Portfolio Managers: Get institutional-grade market intelligence
- Research Teams: Analyze market behavior and sentiment
- Trading Platforms: Enhance your platform with smart money data
- Individual Traders: Make better-informed trading decisions
Key Features
⚡ Fast & Reliable
- Sub-2 second response times for most queries
- 15-minute cache with optional real-time refresh
- 99.9% uptime SLA
🔒 Secure & Authenticated
- Bearer token authentication
- Rate limiting to protect API performance
- Secure HTTPS endpoints
🎯 Highly Customizable
- 23+ query parameters for precise filtering
- Sort by multiple criteria (percentage, positions, money flow, volatility)
- Combine parameters to create powerful queries
📚 Well Documented
- Comprehensive API reference with OpenAPI spec
- Detailed guides and examples
- Real-world use cases and trading strategies
Data Coverage
Our API tracks smart money across:
- 50+ Cryptocurrencies: BTC, ETH, SOL, and major altcoins
- 60+ Professional Traders: Consistently profitable traders on perpetual platforms
- $100M+ in Positions: Real institutional-scale capital flows
- Real-Time Updates: Data refreshed every 15 minutes
Quick Example
Here's what you can do with a single API call:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.0xathena.ai/smart-money/token-stats?position_type=LONG&min_positions=10&sort_by=percentage&limit=5"
This returns the top 5 tokens where smart money has the strongest LONG conviction (minimum 10 positions for quality).
Response:
{
"data": [
{
"token": "BTC",
"total_positions": 18,
"position_percentage": "61% LONG",
"money_percentage": "96% LONG",
"position": "LONG"
}
// ... 4 more tokens
]
}
Getting Started
Ready to dive in? Follow our guides:
- Quick Start - Get your first API call working in 5 minutes
- Authentication - Learn how to get and use API keys
- Core Concepts - Understand the data and metrics
- Common Use Cases - See real-world examples
- API Reference - Complete endpoint documentation (see sidebar)
Navigate to these guides using the sidebar on the left.
Need Help?
- Email: support@0xathena.ai
- GitHub: Report Issues
- Status: api.0xathena.ai/smart-money/test
Disclaimer: The information provided by Athena AI is for informational purposes only and should not be considered financial advice. Cryptocurrency investments carry significant risk. Always conduct your own research and consult with qualified financial advisors before making investment decisions. Athena AI is not responsible for any losses incurred from using this information.