Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add SpartanLabsXyz/simmer-sdk --skill polymarket-researchgit clone --depth 1 https://github.com/SpartanLabsXyz/simmer-sdkWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/spartanlabsxyz/simmer-sdk/polymarket-research)<a href="https://agentmods.dev/skills/spartanlabsxyz/simmer-sdk/polymarket-research"><img src="https://agentmods.dev/badge/skills/spartanlabsxyz/simmer-sdk/polymarket-research/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/spartanlabsxyz/simmer-sdk/polymarket-research"><img src="https://agentmods.dev/badge/skills/spartanlabsxyz/simmer-sdk/polymarket-research.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00034 | $0.00661 |
| Opus 5 | $0.00017 | $0.00331 |
| Sonnet 5 | $0.00007 | $0.00132 |
| Haiku 4.5 | $0.00003 | $0.00066 |
Grade A, and why
polymarket-research scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.
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
What ships with it
2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 12d ago First seen · 78 lines · 34 tokens per session scan A 1384295c304d
polymarket-research is a skill published in the GitHub repository SpartanLabsXyz/simmer-sdk (48 stars, last pushed yesterday), licensed MIT. It adds 34 tokens to every session and 661 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
moonpay-scout
Prediction market arbitrage & alpha scout. Searches Polymarket and Kalshi for the same event, runs cross-platform arb math (including fees), and ranks opportunities by profitability. Use when asked to "find arb", "scout markets", "find edge", or scan a specific topic across prediction markets.
find-fade-setup
Find and evaluate a fade (mean-reversion) setup on prediction markets with oddsrail: candidates, overshoot signal, book, walked cost, resolution criteria, Kelly size, dry-run order.
check-cross-venue-edge
Decide whether a Polymarket vs Kalshi price difference is a real edge or a settlement mismatch: comparevenues, settlementaudit, quotecost on both legs, resolution criteria.
settle-resolved
Turn resolved and hedged Polymarket positions back into USDC, gasless, through the operator's relayer key, with a dry-run read-back first.
daily-review
Daily review of open prediction-market exposure with oddsrail: positions, resting orders, fills, markets closing soon, builder attribution.
polymarket
Query Polymarket: markets, prices, orderbooks, history.