polymarket-research
Skill56 starsChanged 10 days agoMITView on GitHub
Research any Polymarket topic — get market data, probabilities, volumes, and top holders in one snapshot. Read-only, no trading.
- Reads credentials
- Installs packages
In this repository28 other files it gives its agents.
- AGENTS.mdAGENTS.md
- kalshi-weather-traderSkill
- nansen-copytrader-overlaySkill
- polymarket-ai-divergenceSkill
- polymarket-btc-up-down-traderSkill
- polymarket-combo-builderSkill
- polymarket-copytradingSkill
- polymarket-dca-eval-traderSkill
- polymarket-elon-tweetsSkill
- polymarket-fast-loopSkill
- polymarket-fast-scalerSkill
- polymarket-market-makerSkill
- polymarket-mert-sniperSkill
- polymarket-mil-aircraft-trackerSkill
- polymarket-nothing-ever-happensSkill
- polymarket-signal-sniperSkill
- polymarket-soccer-shock-ladderSkill
- polymarket-wallet-xraySkill
- polymarket-weather-traderSkill
- polymarket-worldcup-copytraderSkill
- prediction-trade-journalSkill
- simmer-preflightSkill
- simmer-briefingSkill
- simmer-mcp-setupSkill
- simmer-skill-builderSkill
- simmerSkill
- simmer-wallet-setupSkill
- simmer-x402Skill
The file
Files
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 100000What 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 sharesTroubleshooting
- 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
- Holders API failure: top holders are skipped with an unavailable note, and research continues to the next market
- Timeout on holders: the Polymarket data API is occasionally slow; the skill retries once with a 10s timeout
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.