Getting Started with Athena AI Smart Money API

Welcome to the Athena AI Smart Money API! This guide will help you get up and running with our API in just a few minutes.

Quick Start Steps

Step 1: Try the Demo (No Auth Required)

Want to see what our API returns before getting an API key? Try our demo endpoint:

curl "https://api.0xathena.ai/smart-money/demo-token-stats?limit=5"

This returns sample data that shows the exact structure of our API responses. Perfect for testing your integration!

Step 2: Get Your API Key

Contact our team at support@0xathena.ai to request an API key.

All API endpoints require authentication using a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

:::

Step 3: Make Your First Request

Let's start with a simple request to get token sentiment data:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.0xathena.ai/smart-money/token-stats?limit=5"

This will return the top 5 tokens by smart money positioning:

{
  "data": [
    {
      "token": "BTC",
      "total_positions": 18,
      "position_percentage": "61% LONG",
      "money_percentage": "96% LONG",
      "position": "LONG"
    },
    {
      "token": "ETH",
      "total_positions": 24,
      "position_percentage": "54% LONG",
      "money_percentage": "88% LONG",
      "position": "LONG"
    }
    // ... more tokens
  ],
  "meta": {
    "total_count": 44,
    "returned_count": 5
  },
  "timestamp": "2025-01-28T19:45:32.123Z"
}

Step 4: Understand the Response

Each token in the response includes:

token: The token symbol
total_positions: Number of smart money positions
position_percentage: Distribution by position count
money_percentage: Distribution by notional value
position: Overall direction (LONG, SHORT, or NEUTRAL)

Success! You've made your first API call. Now explore advanced features like filtering, sorting, and enrichment parameters.

:::

Rate Limits

100 requests per minute per API key
10,000 requests per day per API key

Next Steps

Explore the following guides in the sidebar:

Core Concepts - Understand the metrics and data
Use Cases - See real-world trading examples
Parameter Chaining Guide - Master advanced queries
API Reference - View complete endpoint documentation (see Reference section)

Need Help?

Contact our support team at support@0xathena.ai or visit our GitHub repository.

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.

Links: Website · GitHub · Support