prediction-arbitrage-scout
Scout price discrepancies between Polymarket and Kalshi for discovery and comparison. Read-only; no execution.
How do I install this agent skill?
npx skills add https://github.com/velcrafting/codex-skills --skill prediction-arbitrage-scoutIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The prediction-arbitrage-scout skill identifies price discrepancies between Polymarket and Kalshi. It fetches market data from the official public APIs of these platforms, performs calculations using standard Python libraries (pandas, requests), and generates reports in CSV and Markdown formats. The skill is read-only regarding market actions and does not include any automated trading or execution capabilities.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerwarn
4/5 files flagged
What does this agent skill do?
Prediction Arbitrage Scout (Polymarket ↔ Kalshi)
Read-only scouting tool that identifies potential price discrepancies between Polymarket and Kalshi prediction markets.
Purpose
Surface candidate markets where pricing diverges across Polymarket and Kalshi.
This skill is intended for discovery, research, and prioritization, not automated trading or execution.
Non-Goals
- No trade execution
- No guarantees of profitability
- No slippage, depth, or liquidity modeling
- No position sizing or risk management
Outputs from this skill must be validated against Kalshi orderbooks and market rules before any action.
Overview
Workflow:
- Fetch current public market prices from Polymarket
- Fetch open public markets from Kalshi
- Match events using fuzzy string similarity
- Compute theoretical price discrepancies after basic fees
- Generate CSV and Markdown reports for review
Results are ranked by headline price discrepancy, not tradable edge.
Prerequisites
Tools:
- Read
- Write
- Bash (python)
- Glob
- Grep
- WebFetch
Environment:
- Python 3.x
Packages:
- requests
- pandas
Install: pip install requests pandas
Instructions
Step 1: Fetch Polymarket Data Command: python {baseDir}/scripts/fetch_polymarket.py
Output:
- polymarket_data.json
Step 2: Fetch Kalshi Data Command: python {baseDir}/scripts/fetch_kalshi.py
Output:
- kalshi_data.json
Step 3: Detect Price Discrepancies Command: python {baseDir}/scripts/detect_arbitrage.py
Notes:
- Uses fuzzy string similarity (default threshold: 0.7)
- Compares YES/NO prices across platforms
- Estimates theoretical spread after basic fees
Output:
- arbitrage_opportunities.csv
Step 4: Generate Summary Report Command: python {baseDir}/scripts/generate_report.py
Output:
- arbitrage_report.md
Outputs
- polymarket_data.json: Raw Polymarket market data
- kalshi_data.json: Raw Kalshi market data
- arbitrage_opportunities.csv: Ranked discrepancy list
- arbitrage_report.md: Summary report for review
Error Handling
Polymarket API Error:
- Verify Polymarket API availability
- Retry after a short delay
Kalshi API Error:
- Verify public endpoint availability
- Some endpoints may require auth; this skill uses public data only
No Matching Events Found:
- Increase fuzzy match threshold
- Manually map high-value series
Insufficient Price Data:
- Ensure both YES and NO prices exist on both platforms
Interpretation Guidance
- Treat all outputs as signals, not decisions
- Validate market resolution rules
- Check liquidity and orderbook depth
- Consider timing and volatility
- Prefer manually mapped events over fuzzy matches for action
Resources
- Polymarket fetcher: {baseDir}/scripts/fetch_polymarket.py
- Kalshi fetcher: {baseDir}/scripts/fetch_kalshi.py
- Discrepancy analyzer: {baseDir}/scripts/detect_arbitrage.py
- Report generator: {baseDir}/scripts/generate_report.py
Usage
Run the full scouting pipeline: python {baseDir}/scripts/fetch_polymarket.py python {baseDir}/scripts/fetch_kalshi.py python {baseDir}/scripts/detect_arbitrage.py python {baseDir}/scripts/generate_report.py
This skill may be invoked to execute the full workflow automatically.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/velcrafting/codex-skills/prediction-arbitrage-scout">View prediction-arbitrage-scout on skillZs</a>