Alpha Leaderboard

• Polymarket tab — Switches the table to chain=polymarket. Wallets show a PM badge; explorer links go to Polygonscan.
• Rank by / Show / Min trades — Same as other chains. Polymarket requests use looser API defaults: min_tokens=2, min_closed=0, min_buy_vol=1000 (see API Reference table).
• Columns — Headers match DEX; Tokens counts distinct outcomes/CLOB legs the indexer attributes to each wallet.

• Chains → Polymarket — When checked, your account can receive Polymarket pipeline signals. Uncheck to turn off PM delivery only.
• Signal types → PM convergence P0 / P1 — Toggle pm_convergence_bet_p0 and pm_convergence_bet_p1 independently of DEX convergence.
• Convergence min wallets / window / min trade size — Apply to PM as well: they control how many distinct bettors must hit the same outcome and within what horizon, and the per-trade USD floor.
• Quality gates (trader score, win rate, closed positions, holding period) — Filter which ranked wallets can count toward a signal; same idea as DEX.
• Token liquidity & holder filters — DEX-oriented; Polymarket convergence does not use these in the detector.
• Cooldown — Applies per outcome key (CLOB + chain), same idea as “per token” on DEX.
• Market enrichment (question/outcome) — the detector fills market.question/market.outcome_label via Postgres first (secret POLYMARKET_PG_SECRET, default pg_ds1_config), then falls back to DynamoDB mappings/items. If enrichment can’t resolve, the UI falls back to the CLOB id prefix.

• PM signals show a market line when enrichment returns question / outcome.
• View on Polymarket → uses cta.slug or cta.item_id from the payload.
• Open a wallet from the Polymarket tab: the positions table labels the first column Outcome (CLOB) instead of Token.

• GET /leaderboard?chain=polymarket — Ranked bettor pool.
• GET /trader?wallet=...&chain=polymarket — Profile and positions by CLOB id.
• PUT /config — Include polymarket in chains and PM types in signal_types as in the config body table above.

Whale-move and sell-signal types are DEX-only today; enabling them does not create Polymarket whale/sell alerts.

# Top 25 wallets on Base (default: sorted by realized PnL, bots filtered)
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/leaderboard?limit=25&chain=base"

# Top 50 wallets on Solana sorted by composite trader score
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/leaderboard?rank_by=trader_score&chain=solana&limit=50"

# Polymarket smart-money leaderboard (notification pipeline index)
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/leaderboard?chain=polymarket&limit=25"

# Page 2 of results (wallets 21-40)
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/leaderboard?limit=20&offset=20&chain=base"

# Latest 20 signals
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/notifications?limit=20"

# Personalized: ML-reranked + enriched with wallet positions
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/notifications?wallet_id=0x7a3f...9e2d&limit=20"

# Only sell signals on Base
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/notifications?type=sell_signal&chain=base&limit=10"

# Poll for new signals since last check
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/notifications?since=2026-03-23T10:00:00Z&limit=50"

{
  "wallet_id": "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
  "count": 3,
  "notifications": [
    {
      // Polymarket signal — ML-reranked, wallet holds this outcome
      "signal_type": "pm_convergence",
      "chain": "polymarket",
      "headline": "5 top bettors converged on YES",
      "market": { "question": "Will BTC hit $100K?", "outcome_label": "Yes", ... },
      "relevance_rank": 1,            // ML-predicted relevance (lower = more relevant)
      "personal": {                      // Wallet holds this outcome
        "holds_token": true,
        "your_bet": "Yes",
        "avg_cost_basis_usd": 0.35,
        "remaining_shares": 142.5,
        "unrealized_pnl_pct": 57.1,
        "relevance": "validates_your_bet"
      },
      "why": { "personal": "You hold 142 shares of Yes at $0.35 avg - top traders just validated your bet" },
      ...
    },
    {
      // DEX signal — wallet holds this token
      "signal_type": "convergence",
      "chain": "base",
      "headline": "5 top traders bought $TOSHI",
      "personal": {                      // Wallet holds this token
        "holds_token": true,
        "position_size_usd": 2450.00,
        "net_position_usd": 1950.00,
        "avg_entry_price_usd": 0.000650,
        "unrealized_pnl_pct": 24.9,
        "direction": "BUY",
        "relevance": "validates_your_position"
      },
      "why": { "personal": "You hold $1,950 of $TOSHI - top traders just validated your position" },
      ...
    },
    {
      // Signal where wallet has no position
      "signal_type": "pm_convergence",
      "chain": "polymarket",
      "relevance_rank": 3,
      "personal": { "holds_token": false },
      ...
    }
  ]
}

curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/config"

# Set daily budget to 30 and enable only P0 signals
curl -X PUT \
  -H "Authorization: Bearer mbd-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "daily_budget": 30,
    "priority_filter": "P0",
    "chains": ["base", "ethereum"]
  }' \
  "https://api.mbd.xyz/v3/alpha/config"

# Tighten quality gates
curl -X PUT \
  -H "Authorization: Bearer mbd-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "min_trader_score": 0.2,
    "min_trigger_win_rate": 0.5,
    "min_trigger_closed": 3
  }' \
  "https://api.mbd.xyz/v3/alpha/config"

# Full profile for a wallet on Base
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/trader?wallet=0x7a3f...9e2d&chain=base"

# First page of Solana convergence signals
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/signals?chain=solana&type=convergence_p0&limit=20"

# Next page using cursor
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/signals?cursor=eyJjdXN0b21lci..."

# Base chain signal performance over last 14 days
curl -H "Authorization: Bearer mbd-your-api-key-here" \
  "https://api.mbd.xyz/v3/alpha/signals/performance?chain=base&days=14"