Platform Documentation

What is Rating?

Our Rating system is a comprehensive security risk assessment score calculated using big data analysis, AI prediction models, whale tracking, community sentiment, and multiple advanced indicators. Unlike simple price-based metrics, our Rating evaluates the overall market safety level from the coin's inception date, helping you identify the best times to buy and sell.

Rating Score Range: 0 - 1000

Lower Score = Safer Entry Point
Higher Score = Higher Risk / Exit Signal

Advanced Calculation Factors:
✓ Full historical data (from coin creation date)
✓ AI/ML prediction models (deep learning)
✓ Whale wallet tracking & large transactions
✓ Community sentiment analysis (social media)
✓ On-chain metrics (active addresses, transactions)
✓ Market cycle positioning (bull/bear phases)
✓ Trading volume patterns & liquidity depth
✓ Volatility indicators & risk metrics
✓ Long-term moving averages (200-day, 365-day)
✓ Exchange flow analysis (inflow/outflow)
✓ Developer activity & project fundamentals
✓ Correlation with BTC & market dominance

Rating Zones Explained

We divide the Rating score into distinct zones, each representing a different risk level and recommended action. These zones are based on extensive backtesting with real market data.

🟢 EXTREME BOTTOM (0-35)
   Very rare opportunity
   Historical bottom zone
   Maximum safety for entry
   Action: Aggressive buying

🟢 BOTTOM-FISHING ZONE (35-55)
   Excellent entry opportunity
   Low risk, high potential
   Patience required (rare)
   Action: Strong buy

🟡 NEUTRAL ZONE (55-135)
   Central observation area
   Hold existing positions
   Wait and observe market
   Action: Hold & monitor

🟠 SELL ZONE (135-480)
   Market overheating
   Take profit recommended
   Reduce position size
   Action: Sell gradually

🔴 EXTREME OVERVALUATION (>480)
   Market severely overvalued
   High crash risk imminent
   No operations recommended
   Action: Consider shorting

API Overview

Our platform provides RESTful APIs for accessing real-time Rating scores (0-1000), historical data from coin creation date, AI predictions, whale tracking, community sentiment, and comprehensive market analysis. Obtain an API key from your dashboard after registration and include it in the Authorization header.

Base URL: https://yourdomain.com/api

Authentication: Bearer Token
Header: Authorization: Bearer YOUR_API_KEY

Rating Range: 0-1000
Data Coverage: From coin creation date
Rating Updates: Real-time (AI updated hourly)
Whale Tracking: Real-time monitoring
Community Sentiment: Updated every 15 minutes

Supported Symbols (20):
BTCUSDT, ETHUSDT, SOLUSDT, BNBUSDT,
XRPUSDT, DOGEUSDT, TRXUSDT, ADAUSDT,
SUIUSDT, XLMUSDT, LINKUSDT, HBARUSDT,
SHIBUSDT, DOTUSDT, AAVEUSDT, BCHUSDT,
ENAUSDT, LTCUSDT, PEPEUSDT, UNIUSDT

Get Risk Ratings

Retrieve current Rating scores (0-1000) combining AI predictions, whale tracking, community sentiment, and 12+ advanced indicators. Real-time updates ensure you always have the latest market intelligence.

// Get rating for a specific coin
GET /api/ratings/{symbol}

// Example: Get BTC rating
GET /api/ratings/BTCUSDT

// Response:
{
  "symbol": "BTCUSDT",
  "date": "2024-11-22",
  "rating": 650,
  "price": 98234.50,
  "zone": "neutral",
  "recommendation": "hold",
  "aiPrediction": "bullish",
  "aiConfidence": 0.87,
  "whaleActivity": "accumulating",
  "whaleNetFlow": "+1250 BTC",
  "communitySentiment": 0.72,
  "onChainScore": 0.81
}

// Get ratings for all coins
GET /api/ratings

// Response:
{
  "data": [
    {
      "symbol": "BTCUSDT",
      "rating": 650,
      "price": 98234.50,
      "zone": "neutral",
      "recommendation": "hold",
      "aiPrediction": "bullish",
      "whaleActivity": "accumulating"
    },
    ...
  ],
  "timestamp": "2024-11-22T10:15:00Z",
  "totalCoins": 20
}

Historical Data

Access historical price and Rating data for backtesting and analysis. Data includes daily OHLCV, Rating scores, whale activity, and AI predictions from coin creation date.

// Get historical data
GET /api/historical/{symbol}?days=30

// Example: Get 30 days of BTC data
GET /api/historical/BTCUSDT?days=30

// Response:
{
  "symbol": "BTCUSDT",
  "period": "30 days",
  "data": [
    {
      "date": "2024-11-22",
      "open": 97500.00,
      "high": 98500.00,
      "low": 97000.00,
      "close": 98234.50,
      "volume": 12345678,
      "rating": 650,
      "zone": "neutral",
      "whaleActivity": "neutral",
      "aiPrediction": "bullish"
    },
    ...
  ]
}

// Get full historical data (from coin creation)
GET /api/historical/{symbol}?all=true

Risk Zones Query

Query which coins are currently in specific risk zones. Perfect for automated trading systems to identify buy/sell opportunities based on Rating thresholds.

// Get coins in specific zone
GET /api/zones/{zone}

// Example: Get coins in buy zone
GET /api/zones/buy

// Response:
{
  "zone": "buy",
  "description": "Buy Zone",
  "threshold": "Rating 350-550",
  "recommendation": "Strong buy",
  "coins": [
    {
      "symbol": "BTCUSDT",
      "rating": 450,
      "price": 85234.50,
      "change24h": -5.2,
      "whaleActivity": "accumulating",
      "aiPrediction": "bullish"
    },
    {
      "symbol": "ETHUSDT",
      "rating": 480,
      "price": 2856.78,
      "change24h": -4.8,
      "whaleActivity": "buying",
      "aiPrediction": "bullish"
    }
  ],
  "count": 2
}

// Available zones:
GET /api/zones/bottom      // Rating 0-350
GET /api/zones/buy         // Rating 350-550
GET /api/zones/neutral     // Rating 550-1350
GET /api/zones/sell        // Rating 1350-4800
GET /api/zones/extreme     // Rating > 4800

Error Codes

• 400 Bad Request - Invalid parameters or malformed request
• 401 Unauthorized - Invalid or missing API key
• 403 Forbidden - API key doesn't have required permissions
• 404 Not Found - Symbol or endpoint doesn't exist
• 429 Too Many Requests - Rate limit exceeded
• 500 Server Error - Internal server error, contact support