Returns all tracked tokens with current price, wallet count, and dump score.

{
  "tokens": [
    {
      "symbol": "WLD",
      "name": "Worldcoin",
      "chain": "ethereum",
      "price_usd": 0.326,
      "wallet_count": 3,
      "transactions_7d": 10,
      "dump_score": 72,
      "dump_level": "CRITICAL"
    }
  ],
  "count": 58
}

Full token data including dump score signals, recent transactions, upcoming unlocks, and tracked wallets (wallets hidden on free tier).

History limits by tier: Free = 7 days, Pro = 90 days, API/Enterprise = 365 days

{
  "token": {"symbol": "ARB", "price_usd": 0.10, ...},
  "dump_score": {
    "score": 45,
    "level": "HIGH",
    "signals": [
      {"signal": "LARGE_UNLOCK", "weight": 22, "detail": "5.2% unlocking in 30d"},
      {"signal": "MODERATE_OUTFLOW", "weight": 12, "detail": "15 transfers out"}
    ]
  },
  "transactions": [...],
  "upcoming_unlocks": [...],
  "tracked_wallets": [...]
}

All tokens ranked by dump risk score (0-100). Higher = more likely to dump. Signals breakdown only available on paid tiers.

{
  "rankings": [
    {"symbol": "WLD", "score": 72, "level": "CRITICAL", "signals": [...]},
    {"symbol": "ARB", "score": 45, "level": "HIGH", "signals": [...]},
    {"symbol": "TIA", "score": 38, "level": "MEDIUM", "signals": [...]}
  ]
}

All insider sells detected in the last 24 hours (Pro) or 7 days (API/Enterprise).

{
  "alerts": [
    {
      "symbol": "WLD",
      "wallet_label": "TFH Reserve",
      "tx_type": "sell",
      "amount": 5000000,
      "usd_value": 1630000,
      "to_address": "0x28c6...",
      "detected_at": "2026-03-21T03:45:00"
    }
  ]
}

Register a URL to receive instant alerts. Events: sell, critical (sell + unlock combo).

# Create webhook
curl -X POST https://dumpwatch.xyz/api/v1/webhooks \
  -H "X-API-Key: dw_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yourapp.com/webhook", "events": "sell,critical"}'

# Response includes a signing secret
{
  "webhook": {
    "id": 1,
    "url": "https://yourapp.com/webhook",
    "events": "sell,critical",
    "secret": "whsec_abc123..."
  }
}

Webhook Payload

# Your endpoint will receive POST requests like:
{
  "event": "insider_sell",
  "severity": "CRITICAL",
  "timestamp": "2026-03-21T03:45:00",
  "data": {
    "symbol": "WLD",
    "wallet_label": "TFH Reserve",
    "amount": 5000000,
    "amount_usd": 1630000,
    "exchange": "Binance",
    "tx_hash": "0xabc...",
    "dump_score": {"score": 85, "level": "CRITICAL", "signals": [...]},
    "dashboard_url": "https://dumpwatch.xyz/token/WLD"
  }
}

# Verify signature:
# X-DumpWatch-Signature: sha256=hmac(secret, body)

Returns all webhooks registered under your API key.

Delete a webhook by ID.