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

Workflow Nodes Overview

Our platform provides 7 types of workflow nodes that can be connected to create automated trading strategies. Each node performs a specific function and passes data to the next node in the workflow.

Available Node Types:
1. Trigger - Start workflow execution
2. Rating Filter - Filter coins by Rating score
3. Profit/Loss - Check position profitability
4. Virtual Trade - Paper trading (testing)
5. Wallet Trade - On-chain wallet trading
6. Exchange Trade - CEX trading (Binance, etc.)
7. Telegram Bot - Send notifications

1. Trigger Node

The entry point of every workflow. Defines which trading pairs to monitor and when to execute the workflow.

Configuration:
Trading Pairs: Select 1-20 coins
Schedule: Set execution time (Days 0-6, Hours 0-23)

Example:
Input: [BTCUSDT, ETHUSDT]
Output: Trigger pair: BTCUSDT, Trigger pair: ETHUSDT

2. Rating Filter Node

Filters trading pairs based on Rating score thresholds. Only coins meeting the condition will pass to the next node.

Configuration:
Operator: <= or >=
Rating Threshold: 0-500+

Example:
Condition: Rating <= 55
Input: [BTCUSDT, ETHUSDT, SOLUSDT]
Ratings: BTC=45, ETH=72, SOL=38
Output: Matched (2): BTCUSDT, SOLUSDT

3. Profit/Loss Node

Checks the profitability of open positions. Useful for setting take-profit or stop-loss conditions.

Configuration:
Price Type: Entry Price or Current Price
Operator: <= (loss) or >= (profit)
Percentage: Target profit/loss %

Example:
Condition: P&L >= 50%
Positions: BTC +5.5%, ETH +60%, SOL +80%
Output: Matched (2): ETHUSDT, SOLUSDT

4. Virtual Transaction Node

Executes paper trading (simulated trades) for testing strategies without risking real funds. Perfect for backtesting and strategy validation.

Configuration:
Action: open / buy / sell
Amount: USDT amount or all
Label: Node name for tracking

Example:
Action: buy, Amount: 100
Input: [BTCUSDT, ETHUSDT]
Output: Virtual BUY BTCUSDT 0.0011 @ 95000 = 100 USDT

5. Wallet Transaction Node

Executes real on-chain trades using connected wallet. Supports DEX trading with customizable gas and slippage settings.

Configuration:
Action: open / buy / sell
Amount: USDT amount or all
Wallet Address: Your wallet address
Slippage Tolerance: 0.1-5%
Gas Price: Auto or custom

Safety Features:
Balance validation, Slippage protection, Gas optimization, Transaction confirmation, Error handling

6. Exchange Transaction Node

Executes real trades on centralized exchanges (CEX) like Binance, OKX, etc. Supports spot trading with API key authentication.

Configuration:
Action: open / buy / sell
Amount: USDT amount or all
Exchange: Select exchange (Binance, OKX, etc.)
API Key: Your exchange API key
API Secret: Your exchange API secret
Label: Node name for tracking

Supported Exchanges:
Binance, OKX, Bybit, Gate.io, KuCoin

Safety Features:
Balance validation, Order confirmation, Error handling, Position tracking, Trade history logging

Example:
Action: buy, Amount: 100
Exchange: Binance
Input: [BTCUSDT]
Output: Exchange BUY BTCUSDT 0.0011 @ 95000 = 100 USDT, Rating: 450, Order ID: 12345678

7. Telegram Bot Node

Sends notifications to Telegram chat. Supports dynamic content using placeholders from previous nodes.

Configuration:
Bot Token: Your Telegram bot token (from @BotFather)
Chat ID: Your chat/channel ID (from @userinfobot)
Message: Notification text (supports HTML and placeholders)

Placeholder Examples:
[#1.pairs] - All trading pairs
[#2.matchedCount] - Matched count
[#2.matchedPairs] - Matched symbols
[#3.summary] - Trade summary