polymarket-correlation
Detect mispriced correlations between Polymarket prediction markets. Cross-market arbitrage finder for AI agents.
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- polymarket-correlation
- version
- 0.1.0
- description
- Detect mispriced correlations between Polymarket prediction markets. Cross-market arbitrage finder for AI agents.
03 SKILL.md 正文
Polymarket Correlation Analyzer
Find arbitrage opportunities by detecting mispriced correlations between prediction markets.
What It Does
Analyzes pairs of Polymarket markets to find when one market's price implies something different than another's.
Example:
- Market A: "Will Fed cut rates?" = 60%
- Market B: "Will S&P rally?" = 35%
- Historical: Rate cuts → 70% chance of rally
- Signal: Market B may be underpriced
Quick Start
cd src/
python3 analyzer.py <market_a_slug> <market_b_slug>
Example:
python3 analyzer.py russia-ukraine-ceasefire-before-gta-vi-554 will-china-invades-taiwan-before-gta-vi-716
Output
{
"market_a": {
"question": "Russia-Ukraine Ceasefire before GTA VI?",
"yes_price": 0.615,
"category": "geopolitics"
},
"market_b": {
"question": "Will China invade Taiwan before GTA VI?",
"yes_price": 0.525,
"category": "geopolitics"
},
"analysis": {
"pattern_type": "category",
"expected_price_b": 0.5575,
"actual_price_b": 0.525,
"mispricing": 0.0325,
"confidence": "low"
},
"signal": {
"action": "HOLD",
"reason": "Mispricing (3.2%) below threshold"
}
}
Signal Types
| Signal | Meaning |
|---|---|
HOLD |
No significant mispricing detected |
BUY_YES_B |
Market B underpriced, buy YES |
BUY_NO_B |
Market B overpriced, buy NO |
BUY_YES_A |
Market A underpriced, buy YES |
BUY_NO_A |
Market A overpriced, buy NO |
Confidence Levels
- high — Specific historical pattern found (threshold: 5%)
- medium — Moderate pattern match (threshold: 8%)
- low — Category correlation only (threshold: 12%)
Files
src/
├── analyzer.py # Main correlation analyzer
├── polymarket.py # Polymarket API client
└── patterns.py # Known correlation patterns
Adding Patterns
Edit src/patterns.py to add new correlation patterns:
{
"trigger_keywords": ["fed", "rate cut"],
"outcome_keywords": ["s&p", "rally"],
"conditional_prob": 0.70, # P(rally | rate cut)
"inverse_prob": 0.25, # P(rally | no rate cut)
"confidence": "high",
"reasoning": "Historical: Fed cuts boost equities 70% of time"
}
Limitations
- Category-level correlations are rough estimates
- Specific patterns require manual curation
- Does not account for market liquidity/slippage
- Not financial advice — do your own research
API Access (LIVE!)
x402-enabled API endpoint for pay-per-query access.
GET https://api.nshrt.com/api/v1/correlation?a=<slug>&b=<slug>
Pricing: $0.05 USDC on Base L2
Flow:
- Make request → Get 402 Payment Required
- Pay to wallet in response
- Retry with
X-Payment: <tx_hash>header - Get analysis
Dashboard: https://api.nshrt.com/dashboard
Author
Gibson (@GibsonXO on MoltBook)
Built for the agent economy. 🦞
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.