Pkedge

PKEdge — Polymarket Intelligence Skill

Overview

PKEdge is an OpenClaw skill that monitors Polymarket prediction markets, spots mispricings between crowd probabilities and real-world evidence, tracks whale positioning from top-50 leaderboard wallets, and detects fresh wallet insider signals. It operates in four modes: SCAN, DEEP DIVE, WHALE WATCH, and INSIDER WATCH.

Intel only. Never recommends trading. Always appends "Not financial advice. DYOR."

Schedule:

• 8:00 AM ET — Daily SCAN digest (Trader + Free channels)
• 8:05 AM ET — Morning Whale Watch, 48h lookback (Trader only)
• 8:10 AM ET — Morning Insider Watch, 48h lookback (Trader only)
• 4:00 PM ET — Afternoon Whale Watch, 24h lookback (Trader only)
• 4:05 PM ET — Afternoon Insider Watch, 24h lookback (Trader only)
• Every 30 min — Real-time consensus alert when 3+ whales enter the same market
• Every 30 min — Real-time insider alert when fresh wallet drops >$50K on one market

Install

1. cd into the skill folder and run npm install
2. Create a .env file with your Telegram credentials:
   • PKEDGE_TELEGRAM_TOKEN_FREE — bot token for the free channel
   • PKEDGE_TELEGRAM_CHAT_FREE — chat ID for the free channel
   • PKEDGE_TELEGRAM_TOKEN_TRADER — bot token for the trader channel
   • PKEDGE_TELEGRAM_CHAT_TRADER — chat ID for the trader channel
3. Run node cron.js to start scheduled jobs, or configure launchd to run on boot

Trigger Phrases

Claude activates this skill when the user says anything matching these patterns:

SCAN mode

• "pkedge scan"
• "run the pkedge scan"
• "prediction market scan"
• "polymarket scan"
• "what markets are flagged today"
• "pkedge morning digest"

DEEP DIVE mode

• "pkedge deep dive [question or topic]"
• "analyze this market: [question]"
• "pkedge analyze: [question]"
• "what does pkedge think about [topic]"
• "is [market question] mispriced"
• "/deepdive [question]"

WHALE WATCH mode

• "pkedge whale watch"
• "whale watch"
• "what are the whales doing"
• "polymarket whale positions"
• "pkedge whales"

INSIDER WATCH mode

• "pkedge insider watch"
• "insider watch"
• "fresh wallet alert"
• "any insider activity"
• "pkedge insiders"
• "suspicious wallets"
• "new money polymarket"

File Locations

~/Projects/pkedge/
  fetch.js      — all Polymarket API calls (no auth required)
  analyze.js    — scoring, flagging, conviction logic
  formatter.js  — Telegram message templates
  deliver.js    — sends to Telegram channels
  cron.js       — scheduled runner

Mode: SCAN

Purpose: Fetch the top 200 active Polymarket markets by volume, flag anomalies, rank them, deliver the digest.

Step-by-step:

1. Call fetchActiveMarkets() from fetch.js

   • Returns normalized market objects with yesPrice, noPrice, volume, volume24hr, endDate
   • Filters to markets with >$10K all-time volume

2. Call runScanFlags(markets) from analyze.js

   • Applies 5 flags: VOLUME_SURGE, SPREAD_ANOMALY, VOLUME_SPIKE, EXTREME_LOW/HIGH, RESOLVING_SOON
   • Each flag carries a point value; scanScore is the sum
   • Returns flagged markets sorted by score descending

3. For the top 5 flagged markets, call web search on each question to check for recent news

   • Search: "[market question]" news today
   • Note any breaking news, resolution events, or catalysts
   • Add this context to the evidence for each market

4. Call formatScanDigest(flaggedMarkets, 5) from formatter.js for Trader channel

5. Call formatScanPreview(flaggedMarkets[0]) from formatter.js for Free channel

6. Deliver via deliver.js sendToTrader() and sendToFree()

Output shape:

🔍 PKEdge Morning Scan — Mon, Mar 9, 2026
_5 markets flagged from top 200 by volume_
──────────────────────
1. *Will the Fed cut rates at the March 2026 meeting?*
   🔥 HIGH  Crowd: YES 23.1%  |  24h Vol: $142K  |  Score: 7
   👀 Volume spike: 4.2x average daily volume — unusual activity
   ⏰ Resolves in 3.2 days
...

Mode: DEEP DIVE

Purpose: Full analysis of a single market. Claude reasons over crowd probability vs. real-world evidence, assesses fair value, and outputs a structured Crowd vs. Reality report.

Step-by-step:

1. Parse the market question from the user input

2. Call searchMarkets(query) from fetch.js to find the matching Polymarket market

   • If multiple results, pick the one with the highest volume
   • If zero results, tell the user no matching market was found on Polymarket

3. Fetch enriched market data:

   • fetchPriceHistory(market.id, '1d') — get price history with daily candles (note: '1d' sets candle granularity, not lookback window; the API returns available history for the market)
   • fetchBookDepth(market.clobTokenIds[0]) — get order book depth (YES token)
   • Compute price velocity from history: (most recent price − price from ~24h prior) in percentage points

4. Call analyzeMarket(market, bookDepth) from analyze.js

   • Returns analysis object with flags, spread note, resolution note, volume note

5. Web search × 3 to gather evidence:

   • Search 1: "[market question]" news [current month year]
   • Search 2: [core topic] forecast prediction [current year]
   • Search 3: [core topic] expert analysis probability
   • Synthesize key findings into 3–5 bullet points (each max 1 sentence)

6. Estimate fair value:

   • Based on web search evidence, base rates, and any quantitative anchors found
   • Express as a probability range: e.g., "52–60% YES"
   • Use the midpoint for conviction calculation

7. Call computeConviction(crowdPct, fairPct) from analyze.js

   • Returns { delta, direction, conviction: HIGH/MEDIUM/LOW, label }

8. Call formatDeepDive(analysis, conviction, evidenceLines) from formatter.js

9. Deliver via sendToTrader() (Deep Dive is Trader-only)

Output shape:

🧠 PKEdge Deep Dive
_Mar 9, 2026_
──────────────────────
*Will the Fed cut rates at the March 2026 meeting?*

CROWD PRICE
YES: 23.1%  |  NO: 76.9%

MARKET DATA
⏰ Resolves in 3.2 days
💰 All-time: $2.1M  |  24h: $142K
👀 Spread: 1.2¢ (bid 0.229 / ask 0.241)
✅ Order book: DEEP ($340K within 10¢)

EVIDENCE
✅ Fed funds futures pricing ~18% probability of March cut as of today
✅ Powell speech last week signaled patience — no urgency to cut
✅ February CPI came in at 2.9%, above 2% target
✅ No emergency FOMC meeting called — standard meeting format
✅ Metaculus consensus: 15-22% YES

──────────────────────
PKEDGE ASSESSMENT
🔥 Conviction: HIGH
Direction: NO underpriced
Delta: 18 percentage points from crowd
_Crowd is 18 pts away from fair value — strong signal_

`Not financial advice. DYOR. Prediction markets carry risk.`

Mode: WHALE WATCH

Purpose: Monitor top-50 Polymarket traders by all-time profit for new positions. Detect consensus (3+ whales entering the same market) and fire real-time alerts.

Runs twice daily:

• 8:05 AM ET — 48h lookback window. Catches anything that moved overnight or over the weekend.
• 4:00 PM ET — 24h lookback window. Covers the full trading day.

Step-by-step:

1. Call fetchLeaderboard(50) from fetch.js

   • Returns top 50 wallets by all-time profit
   • Each entry has: address, name (if set), pnl, volume

2. Extract all wallet addresses and call fetchMultiWalletPositions(addresses)

   • This loops through all 50 wallets with a 150ms delay between calls
   • Returns a Map of address → positions[]

3. Call buildWhaleReport(leaderboard, walletPositions, windowHours) from analyze.js

   • Morning run (8:05 AM): pass 48 as windowHours — covers overnight + weekend
   • Afternoon run (4:00 PM): pass 24 as windowHours — covers the trading day
   • Filters to positions opened within the window with >$1K value
   • Detects consensus: 3+ whales in the same market
   • Sorts by position size and consensus count

4. Call formatWhaleWatch(report) from formatter.js

5. Deliver via sendToTrader()

6. For any consensus markets not yet alerted today:

   • Call formatWhaleAlert(consensusMarket, latestPosition) from formatter.js
   • Deliver as an immediate alert (separate message, not part of digest)
   • Mark as alerted in the dedup set

Output shape:

🐋 PKEdge Whale Watch — Mon, Mar 9, 2026
_Top 50 traders scanned | Last 24h_
──────────────────────
🔥 CONSENSUS DETECTED (1 market)

1. *Will the Fed cut rates at the March 2026 meeting?*
   🐋x4 whales  |  💰$48K combined  |  Direction: *NO*
   _PredictWiz, 0x4f2a…1b3c, MarketMaker99 +1 more_

──────────────────────
NEW POSITIONS (6 total)

🐋 *PredictWiz*  →  NO
   _Will the Fed cut rates at the March 2026 meeting?_
   $22K @ 77¢  |  2h ago
...