Quick Start

From zero to necromancer in five steps. Get RevenAI running and start detecting resurrections.

Core Concepts

The fundamental building blocks of RevenAI's necromantic intelligence system.

🎯 Resurrection Score

Every token in the graveyard is assigned a Resurrection Score from 0 to 100. This score represents the AI's confidence that the token will experience a significant price recovery.

// Resurrection Score Ranges
const SCORE_RANGES = {
  DEAD:         "0-20",    // No signs of life
  DORMANT:      "21-40",   // Faint whispers detected
  STIRRING:     "41-60",   // Notable activity brewing
  AWAKENING:    "61-80",   // Strong resurrection signals
  RESURRECTING: "81-100",  // Rise from the grave imminent
};

🪦 Death Classification

Tokens in the graveyard are classified into three states based on their activity level and score:

📡 Signal Types

RevenAI tracks five core signal types that contribute to the Resurrection Score:

• RESURRECT Multi-factor resurrection signal — the strongest indicator that a dead token is coming back.
• WHALE_WAKE Large wallet accumulation detected. Smart money is moving into a dormant token.
• BUZZ_SPIKE Sudden increase in X mentions and engagement after a prolonged silence period.
• GRAVE_EXIT Token is being removed from "dead" watchlists — a contrarian bullish signal.
• DEATH_WATCH Token is entering critical zone — may die permanently or stage a dramatic comeback.

Graveyard Scanner

The all-seeing eye that watches over the cryptographic dead. Continuously scanning for signs of life in the graveyard.

The Graveyard Scanner is RevenAI's core monitoring engine. It tracks thousands of tokens that have experienced significant price declines, volume drops, and social media abandonment — then watches for any anomalies that might signal a resurrection.

🔍 How Scanning Works

// Initialize the Graveyard Scanner
const scanner = new GraveyardScanner({
  depth: "deep",          // How far back to scan
  chains: ["ethereum", "solana", "base"],
  minDeathAge: 30,        // Days since "death"
  sensitivity: "paranoid"  // Miss nothing
});

// Start watching the graveyard
scanner.watch((event) => {
  if (event.type === "STIR_DETECTED") {
    console.log(`🧟 Movement detected: ${event.token}`);
    console.log(`   Score: ${event.resurrectionScore}/100`);
  }
});JavaScript

📊 Scanner Metrics

X Buzz Oracle

Listening to the whispers of the dead across X. The Oracle decodes sentiment shifts before they become trends.

The X Buzz Oracle connects to X's firehose and applies RevenAI's proprietary NLP models to detect early narrative shifts, sentiment reversals, and emerging buzz around previously dead tokens.

🔮 Oracle Query

// Query the X Buzz Oracle
const oracle = await revenai.buzzOracle({
  token: "$PEPE",
  timeframe: "7d",
  includeKOL: true,      // Track key opinion leaders
  sentimentDepth: "deep" // Full emotional analysis
});

console.log(oracle.buzzLevel);     // "RISING_WHISPER"
console.log(oracle.sentimentShift); // +34.7% (bearish → curious)
console.log(oracle.kolMentions);     // 12 new KOL mentionsJavaScript

Resurrection Alerts

Never miss a rising from the dead. Configure real-time alerts for the signals that matter to you.

🔔 Setting Up Alerts

// Configure resurrection alerts
const alert = await revenai.createAlert({
  name: "Memecoin Gravewatch",
  conditions: {
    minScore: 65,                  // Minimum resurrection score
    signals: ["RESURRECT", "WHALE_WAKE"],
    chains: ["solana", "base"],
    categories: ["memecoin"]
  },
  delivery: {
    webhook: "https://your-api.com/alerts",
    priority: "critical"
  }
});

console.log(`🧟 Alert active: ${alert.id}`);JavaScript

📋 Alert Conditions

• minScore — Minimum Resurrection Score to trigger (0–100)
• signals — Array of signal types to watch for
• chains — Blockchain networks to monitor
• categories — Token categories: memecoin, defi, nft, l2, gaming
• buzzThreshold — Minimum X buzz level change to trigger

Pump Prediction

The dark art of predicting when the dead will rise — and how high they'll climb.

RevenAI's Pump Prediction engine combines on-chain analytics, social sentiment, and historical resurrection patterns to estimate the probability and potential magnitude of a token's comeback.

🧠 Prediction Model

// Get pump prediction for a token
const prediction = await revenai.predictPump({
  token: "$BONK",
  timeframe: "72h",
  confidence: "high"
});

// Response
{
  token: "$BONK",
  resurrectionScore: 78,
  pumpProbability: 0.73,
  estimatedGain: "120-340%",
  confidence: "HIGH",
  signals: ["WHALE_WAKE", "BUZZ_SPIKE"],
  riskLevel: "MODERATE",
  necromancerNote: "The bones are warm. Multiple whale wallets accumulating. X buzz rising from the whisper phase."
}JavaScript

REST API

Programmatic access to the graveyard. Integrate RevenAI into your bots, dashboards, and trading systems.

📡 Endpoints

💻 Example Request

# Fetch graveyard data
curl -X GET "https://api.revenai.xyz/v1/graveyard" \
  -H "Authorization: Bearer rvn_your_api_key" \
  -H "Content-Type: application/json"

# Response
{
  "graves": [
    {
      "token": "$DOGE",
      "chain": "ethereum",
      "resurrectionScore": 72,
      "classification": "RESURRECTING",
      "signals": ["WHALE_WAKE", "BUZZ_SPIKE"],
      "lastActivity": "2025-01-15T08:30:00Z"
    }
  ],
  "total": 12847,
  "page": 1
}cURL

WebSocket

Real-time connection to the graveyard. Receive resurrection events as they happen — no polling required.

⚡ Connection

// Connect to the RevenAI WebSocket
const ws = new WebSocket("wss://ws.revenai.xyz/v1/stream");

ws.onopen = () => {
  // Authenticate
  ws.send(JSON.stringify({
    type: "auth",
    token: "rvn_your_api_key"
  }));

  // Subscribe to resurrection events
  ws.send(JSON.stringify({
    type: "subscribe",
    channels: ["resurrections", "whale_wakes", "buzz_spikes"],
    minScore: 50
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(`🧟 ${data.signal}: ${data.token} (Score: ${data.score})`);
};JavaScript

📢 Event Types

• resurrection — Token crossed the resurrection threshold
• whale_wake — Large wallet activity on a graveyard token
• buzz_spike — Sudden X mention increase
• score_change — Resurrection Score changed significantly
• death_watch — Token entering critical zone

Webhooks

Push-based delivery for resurrection events. RevenAI calls your endpoint when the dead start moving.

🔗 Webhook Setup

# Register a webhook endpoint
curl -X POST "https://api.revenai.xyz/v1/webhooks" \
  -H "Authorization: Bearer rvn_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/revenai-hook",
    "events": ["resurrection", "whale_wake"],
    "secret": "your_webhook_secret",
    "minScore": 60
  }'cURL

📦 Webhook Payload

// Incoming webhook payload
{
  "id": "evt_rvn_8x7k2m",
  "type": "resurrection",
  "timestamp": "2025-01-15T08:30:00Z",
  "data": {
    "token": "$SHIB",
    "chain": "ethereum",
    "resurrectionScore": 84,
    "previousScore": 31,
    "classification": "RESURRECTING",
    "signals": ["RESURRECT", "WHALE_WAKE", "BUZZ_SPIKE"],
    "necromancerNote": "From the grave it rises. Three convergent signals. The bones sing."
  }
}JSON