Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/0xW1re/solvedocs/llms.txt

Use this file to discover all available pages before exploring further.

Alpha Leak exposes a live signal feed and a set of REST endpoints. This guide covers connecting to both — from opening the SSE stream to interpreting your first signal payload.

​
Base URL

All endpoints are available at your hosted instance URL. Replace your-instance throughout this guide with the host you’ve been given. 
https://your-instance/api
1

Connect to the live feed

The primary interface is a Server-Sent Events stream that pushes signals, graduations, and anti-signals in real time as they occur on-chain. This is the fastest way to consume Alpha Leak data — no polling required.
const es = new EventSource('https://your-instance/api/live/feed');

es.addEventListener('signal', (event) => {
  const data = JSON.parse(event.data);

  if (data.type === 'genesis_signal') {
    // New token scored highly in its first 60 seconds
    console.log('Genesis:', data.data.symbol, `score: ${data.data.genesisScore}`);

  } else if (data.type === 'anti_signal') {
    // Active token flagged — adversarial conditions detected
    console.warn('Anti-signal:', data.data.tokenMint, data.data.reasons);

  } else {
    // Standard tracked-wallet signal
    console.log('Signal:', data.data.tokenMint, data.data.action);
  }
});

es.addEventListener('graduation', (event) => {
  const token = JSON.parse(event.data);
  console.log(`${token.symbol} graduated — ${token.volume} SOL total volume`);
});

es.onerror = () => {
  // SSE clients reconnect automatically — no manual handling required
};
The stream sends a heartbeat event every 15 seconds to keep connections alive through proxies and load balancers.
2

Fetch recent data on load

Before the live stream has delivered events, use the /api/live/recent endpoint to populate your initial state:
const res = await fetch('https://your-instance/api/live/recent?limit=20');
const { signals, graduations, largeTrades } = await res.json();

// signals      — recent buy/sell signals with ML scores
// graduations  — recently graduated tokens
// largeTrades  — recent trades >= 1.0 SOL
This endpoint is designed to be called once on page load, with the SSE stream taking over from that point forward.
3

Understand signal types

Alpha Leak emits three types of signals on the live feed.signal — a tracked wallet (one the system has built a quality profile for) has made a significant buy. The payload includes the wallet’s alpha score, ML probability score, token state, buy rank, velocity data, and creator risk.genesis_signal — a newly created token scored highly across the genesis model’s 75-feature vector during its first 60 seconds of life. No tracked wallet needed — this is purely based on launch dynamics.anti_signal — a token with recent buy signals has triggered 2 or more adversarial detection rules simultaneously (for example, coordinated bundle + high bot buyer percentage). Any system acting on the original signal should treat this as an exit cue.
4

Query historical data

All historical signal, wallet, and token data is available via REST:
// Signals with ML scores — paginated
const signals = await fetch('/api/signals?min_ml_score=0.80&limit=50').then(r => r.json());

// Tracked wallets with alpha scores
const wallets = await fetch('/api/wallets?min_alpha=70&active_only=true').then(r => r.json());

// Token data including lifecycle state and risk scores
const tokens = await fetch('/api/tokens?graduated=false').then(r => r.json());

// Current pipeline stats and market regime
const stats = await fetch('/api/stats').then(r => r.json());
Full parameter reference for each endpoint is in the API Reference.
5

Interpret a signal payload

Here is a full buy signal payload with annotations:
{
  "type": "signal",
  "data": {
    "tokenMint": "So11...",         // Token being bought
    "wallet": "ABC1...",            // Wallet that triggered the signal
    "action": "buy",
    "solAmount": 0.5,               // Size of this specific buy
    "buyRank": 4,                   // This wallet was the 4th buyer on this token
    "curvePct": 0.12,               // Bonding curve is 12% filled
    "curveSol": 8.3,                // 8.3 SOL currently in the curve
    "buysLast60s": 12,              // 12 buys on this token in the last 60 seconds
    "buysLast300s": 34,             // 34 buys in the last 5 minutes
    "walletStats": {
      "alphaScore": 84,             // Wallet quality score (0–100)
      "graduationRate": 0.41,       // 41% of tokens this wallet bought graduated
      "winRate": 0.68,              // 68% of positions closed in profit
      "captureEfficiency": 0.72     // Captures 72% of available peak return on average
    },
    "tokenState": {
      "lifecycleState": "momentum", // Token lifecycle classification
      "riskScore": 18,              // Token-level risk score (low = safer)
      "bundleConfidence": 0.12,     // Low bundle confidence — looks organic
      "creatorRiskScore": 24        // Creator has a solid track record
    }
  }
}
A high-quality signal combines several indicators: a high alphaScore (80+), a low buyRank (early entry), rising velocity in buysLast60s, a low riskScore, a low bundleConfidence, and a lifecycleState of momentum or early_accumulation. Signals that meet all of these criteria are the ones the live trader acts on with the highest position sizes.

Build docs developers (and LLMs) love

Get started for freeTalk to us