MemeScout API

Returns current radar signals (active tokens on radar).

Query Parameters

Response

{
  "success": true,
  "timestamp": "2026-01-28T15:00:00Z",
  "count": 12,
  "signals": [
    {
      "address": "ABC123...",
      "name": "TokenName",
      "symbol": "TKN",
      "radar_score": 82,
      "market_cap": 148000,
      "liquidity": 12400,
      "volume_5m": 22100,
      "volume_15m": 41800,
      "volume_1h": 85000,
      "buys": 24,
      "sells": 9,
      "price": 0.000148,
      "age_minutes": 42,
      "trigger_reason": "High volume + strong buy pressure",
      "risk_level": "Low",
      "risk_score": 250,
      "first_seen": "2026-01-28T14:18:00Z",
      "last_seen": "2026-01-28T15:00:00Z",
      "is_new": true,
      "is_returning": false,
      "is_recovered": false,
      "is_dropped": false,
      "data_source": "live",
      "top_10_holders_pct": 42.5,
      "creator_holds_pct": 3.2,
      "lp_burned": true,
      "lp_locked": false,
      "mint_authority_revoked": true,
      "freeze_authority_revoked": true,
      "is_mutable": false,
      "top3_holders_pct": 18.1,
      "lp_health_score": 72,
      "volume_consistency": 85,
      "wallet_risk_score": 68,
      "time_to_peak_estimate": "fast"
    }
  ]
}

Returns detailed data for a specific token by its address.

Response

{
  "success": true,
  "token": {
    "address": "ABC123...",
    "name": "TokenName",
    "symbol": "TKN",
    "website": "https://...",
    "twitter": "@handle",
    "image": "https://...",
    "current": {
      "price": 0.000148,
      "market_cap": 148000,
      "liquidity": 12400,
      "volume_5m": 22100,
      "volume_15m": 41800,
      "volume_1h": 85000,
      "buys": 24,
      "sells": 9,
      "holders": 156,
      "radar_score": 82,
      "data_source": "live"
    },
    "radar": {
      "first_seen": "2026-01-28T14:18:00Z",
      "first_call_mc": 95000,
      "peak_mc": 180000,
      "trigger_reason": "High volume + strong buy pressure"
    },
    "risk": {
      "level": "Low",
      "score": 250,
      "lp_warning": null,
      "top_10_holders_pct": 42.5,
      "creator_holds_pct": 3.2,
      "lp_burned": true,
      "lp_locked": false,
      "mint_authority_revoked": true,
      "freeze_authority_revoked": true,
      "is_mutable": false,
      "top3_holders_pct": 18.1
    },
    "intelligence": {
      "lp_health_score": 72,
      "volume_consistency": 85,
      "wallet_risk_score": 68,
      "time_to_peak_estimate": "fast"
    }
  }
}

Returns historical radar calls with performance metrics. Query by date or last N days.

Query Parameters

Response

{
  "success": true,
  "timestamp": "2026-01-28T15:00:00Z",
  "period": {
    "start": "2026-01-21",
    "end": "2026-01-28"
  },
  "total_calls": 156,
  "calls": [
    {
      "address": "ABC123...",
      "name": "PepeGPT",
      "symbol": "PGPT",
      "image": "https://...",
      "call_date": "2026-01-28",
      "first_seen": "2026-01-28T14:18:00Z",
      "first_call_mc": 95000,
      "peak_mc": 285000,
      "multiplier": 3.0,
      "radar_score": 82,
      "trigger_reason": "High volume + strong buy pressure",
      "risk_level": "Low",
      "risk_score": 250
    }
  ]
}

Connection

Connect to the WebSocket endpoint for real-time radar signals. Authenticate using your API key as a query parameter.

Events

signal_new Payload

{
  "event": "signal_new",
  "timestamp": 1707928800000,
  "data": {
    "address": "ABC123...",
    "name": "PepeGPT",
    "symbol": "PGPT",
    "radar_score": 82,
    "market_cap": 148000,
    "liquidity": 12400,
    "volume_5m": 22100,
    "volume_1h": 85000,
    "buys": 24,
    "sells": 9,
    "price": 0.000148,
    "holders": 156,
    "age_minutes": 0,
    "trigger_reason": "High volume + strong buy pressure",
    "risk_level": "Low",
    "risk_score": 250,
    "lp_health_score": 72,
    "volume_consistency": 85,
    "wallet_risk_score": 68,
    "time_to_peak_estimate": "fast",
    "first_seen": "2026-02-14T12:00:00Z",
    "data_source": "live"
  }
}

Connection Example — JavaScript (with auto-reconnect)

const WS_URL = "wss://hctbncqmdygeymmtqjmj.supabase.co/functions/v1/ws?api-key=smr_your_key";
const MAX_BACKOFF_MS = 30_000;

function connect(attempt = 0) {
  const ws = new WebSocket(WS_URL);

  ws.onopen = () => {
    console.log("Connected to MemeScout Radar");
    attempt = 0; // reset backoff on success
    // Snapshot is sent automatically — no need to request it
  };

  ws.onmessage = (event) => {
    const msg = JSON.parse(event.data);
    switch (msg.event) {
      case "snapshot":
        console.log(`Snapshot: ${msg.data.count} active signals`);
        msg.data.signals.forEach(s => console.log(`  ${s.symbol} | Score: ${s.radar_score}`));
        break;
      case "signal_new":
        console.log("New signal:", msg.data.symbol, "Score:", msg.data.radar_score);
        break;
      case "signal_update":
        console.log("Updated:", msg.data.symbol, "→ Score:", msg.data.radar_score);
        break;
      case "signal_removed":
        console.log("Removed:", msg.data.address);
        break;
      case "ping":
        ws.send(JSON.stringify({ event: "pong" }));
        break;
    }
  };

  ws.onclose = (e) => {
    const delay = Math.min(1000 * 2 ** attempt, MAX_BACKOFF_MS);
    console.warn(`Disconnected (${e.code}: ${e.reason}). Reconnecting in ${delay}ms...`);
    setTimeout(() => connect(attempt + 1), delay);
  };

  ws.onerror = (err) => {
    console.error("WebSocket error:", err);
    ws.close(); // triggers onclose → reconnect
  };
}

connect();

Connection Example — Python (with auto-reconnect)

import asyncio
import websockets
import json

WS_URL = "wss://hctbncqmdygeymmtqjmj.supabase.co/functions/v1/ws?api-key=smr_your_key"
MAX_BACKOFF = 30

async def on_signal(data):
    print(f"New: {data['symbol']} | Score: {data['radar_score']} | MC: ${data['market_cap']:,}")

async def listen():
    attempt = 0
    while True:
        try:
            async with websockets.connect(WS_URL) as ws:
                print("Connected to MemeScout Radar")
                attempt = 0  # reset on success
                async for raw in ws:
                    msg = json.loads(raw)
                    if msg["event"] == "snapshot":
                        print(f"Snapshot: {len(msg['data']['signals'])} active signals")
                        for s in msg["data"]["signals"]:
                            print(f"  {s['symbol']} | Score: {s['radar_score']}")
                    elif msg["event"] == "signal_new":
                        await on_signal(msg["data"])
                    elif msg["event"] == "signal_update":
                        await on_signal(msg["data"])  # same full payload
                    elif msg["event"] == "ping":
                        await ws.send(json.dumps({"event": "pong"}))
        except Exception as e:
            delay = min(2 ** attempt, MAX_BACKOFF)
            print(f"Disconnected ({e}). Reconnecting in {delay}s...")
            await asyncio.sleep(delay)
            attempt += 1

asyncio.run(listen())