spartanlabsxyz/polymarket-research
skills/polymarket-research/SKILL.md
Research any Polymarket topic — get market data, probabilities, volumes, and top holders in one snapshot. Read-only, no trading.
$ install --global
skillsauthnpx skillsauth add spartanlabsxyz/simmer-sdk polymarket-researchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 25, 2026, 4:38 AM151.5s3 files scanned
SKILL.md
- name:
- polymarket-research
- description:
- Research any Polymarket topic — get market data, probabilities, volumes, and top holders in one snapshot. Read-only, no trading.
- author:
- Simmer (@simmer_markets)
- version:
- 1.0.0
- displayName:
- Polymarket Research
- difficulty:
- beginner
Polymarket Research
Get a structured research snapshot for any Polymarket topic. Returns market probabilities, volume across time windows, and the top holders (largest positions) per outcome. Read-only — no trades, no wallet needed.
This is a template. The default output is a research snapshot — remix it to feed into your own trading logic, dashboard, or analysis pipeline. The skill handles market discovery and data retrieval. Your agent decides what to do with the signal.
Setup
pip install simmer-sdk
export SIMMER_API_KEY="sk_live_..."
Quick start
python research.py "bitcoin price"
python research.py "us election" --top-holders 20
python research.py "weather" --min-volume 100000
What you get
For each matching market:
| Field | Source | |---|---| | Question, status, resolution date | Simmer SDK | | YES/NO probability | Simmer SDK (synced from Polymarket CLOB) | | 24h volume | Simmer SDK | | Top holders per outcome | Polymarket data API (free, no auth) | | Edge analysis vs AI price | Simmer SDK context endpoint |
Configuration
| Parameter | Env var | Default | Description |
|---|---|---|---|
| Search query | (CLI arg) | required | Topic to search for |
| Min volume | SIMMER_RESEARCH_MIN_VOLUME | 10000 | Skip markets below this 24h volume |
| Max results | SIMMER_RESEARCH_MAX_RESULTS | 5 | Markets to return |
| Top holders | SIMMER_RESEARCH_TOP_HOLDERS | 10 | Holders per outcome |
Example output
=== Bitcoin Price Markets ===
1. Will BTC hit $150k by end of 2026?
YES: 32.5% | NO: 67.5%
Volume (24h): $284,102
Resolves: 2026-12-31
Top holders (YES):
Gabagool22: 142,301 shares
xuanxuan008: 89,442 shares
marketing101: 67,221 shares
Top holders (NO):
0xe1d6...907: 203,112 shares
sharky6999: 156,004 shares
Troubleshooting
- No markets found: try broader search terms or lower
--min-volume - No top holders: market may be new or have low participation; the holders endpoint returns empty for very new markets
- Timeout on holders: the Polymarket data API is occasionally slow; the skill retries once with a 10s timeout
Related Skills
spartanlabsxyz/polymarket-worldcup-copytrader
data-ai
VerifiedTrustedCommunity
Copy the top World Cup traders on Polymarket — auto-curated daily by Simmer. No wallet list to configure; the skill sources leaders via PolyNode's slippage-adjusted copy-PnL screen. Regular mode (daily rebalance). Free tier.
45SKILL.mdUpdated Jun 11, 2026
spartanlabsxyz/mcp/tests/fixtures
tools
VerifiedTrustedCommunity
# Fixture Instruction-Only Skill This is a Tier-A instruction-only fixture used to verify that invoking an instruction-only skill returns its SKILL.md playbook instead of an error. UNIQUE_FIXTURE_MARKER_4815162342
45SKILL.mdUpdated Jun 10, 2026
spartanlabsxyz/polymarket-soccer-shock-ladder
development
VerifiedTrustedCommunity
Fade sharp in-play price shocks on Polymarket soccer markets with a laddered limit-buy strategy (Roan's FIFA-quant framework). Pro skill. Currently scoped to 2026 World Cup markets. Simmer's server detects shocks in real time and emits pre-sized signals; this skill places the recovery ladder and manages the exit.
45SKILL.mdUpdated Jun 8, 2026
spartanlabsxyz/polymarket-dca-eval-trader
development
VerifiedTrustedCommunity
Build and optionally execute a three-tranche Polymarket DCA plan with prop-firm-shaped evaluation envelope checks. Use when the user wants a Bubbles/Roya-style staged averaging template for one thesis, with paper mode by default and explicit live opt-in.
45SKILL.mdUpdated May 31, 2026