polymarket-research SKILL.md skillA

polymarket-research from spartanlabsxyz/simmer-sdk is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add spartanlabsxyz/simmer-sdk/polymarket-research@v1.0.1

Pins v1.0.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
spartanlabsxyz/simmer-sdk
Path
skills/polymarket-research/SKILL.md
Versions recorded
2
Latest version
v1.0.1, committed Nov 3, 2026
First version recorded
May 24, 2026
Size
2,601 bytes
Repository stars
56
License
MIT

Research any Polymarket topic — get market data, probabilities, volumes, and top holders in one snapshot. Read-only, no trading.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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

```bash
pip install simmer-sdk
export SIMMER_API_KEY="sk_live_..."
```

## Quick start

```bash
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 |
|---|---|---|---|
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add spartanlabsxyz/simmer-sdk/polymarket-research@sha256:9860506512d0c49f

The line at the top of this page pins the label v1.0.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ougkobeezl2s6vdv.svg)](https://markdownregistry.com/a/art_ougkobeezl2s6vdv)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between May 24, 2026 and Nov 3, 2026, about one every 163 days.

versioncommittedcommitsizeaudit
v1.0.1 latest2026-11-03 6398a98 2,601 BA view · diff
v1.0.02026-05-24 4d6096e 2,482 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2601 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

spartanlabsxyz/simmer-sdk · 56 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ougkobeezl2s6vdv
GET https://markdownregistry.com/api/v1/resolve?ref=spartanlabsxyz/simmer-sdk/polymarket-research
GET https://markdownregistry.com/api/v1/blob/9860506512d0c49fe513773e4973f2c748b894d7e13ed6d058b54bae528082b8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from spartanlabsxyz/simmer-sdk

AGENTS.md AGENTS.md file
spartanlabsxyz/simmer-sdk · AGENTS.md
git:20261024.7402abd · audit A · 56 stars
simmer-preflight SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/bundled-skills/preflight/SKILL.md · Pre-trade readiness check for autonomous agents. One call returns wallet identity, venue status, spendable balance…
v0.3.7 · audit A · 56 stars
simmer-briefing SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/bundled-skills/simmer-briefing/SKILL.md · Daily check-in pattern for Simmer agents. One API call returns portfolio, risk alerts, and opportunities across all…
v0.1.4 · audit A · 56 stars
simmer-mcp-setup SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/bundled-skills/simmer-mcp-setup/SKILL.md · One-shot bootstrap for the Simmer MCP server. Detects your agent runtime (Claude Code / Cursor / OpenClaw / Hermes /…
v0.3.6 · audit B · 56 stars
simmer-wallet-setup SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/bundled-skills/simmer-wallet-setup/SKILL.md · Self-custody wallet setup for Simmer agents. Bring your own key, import a funded Polymarket wallet, or connect an…
v0.4.1 · audit C · 56 stars
simmer SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/bundled-skills/simmer/SKILL.md · The prediction market interface for AI agents. Trade Polymarket and Kalshi through one API with self-custody wallets…
v1.25.4 · audit A · 56 stars
autoresearch-finalize SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/skills/autoresearch-finalize/SKILL.md · Finalize an autoresearch session into clean, reviewable branches. Use when asked to "finalize autoresearch", "clean up…
git:20260519.7e96819 · audit A · 56 stars
simmer-autoresearch SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/skills/autoresearch/SKILL.md · Set up and run autonomous experiment loops to optimize Simmer trading skills. Mutates skill code + config, measures…
git:20260519.7e96819 · audit A · 56 stars
fixtures SKILL.md skill
spartanlabsxyz/simmer-sdk · mcp/tests/fixtures/SKILL.md
git:20260608.a29a3be · audit C · 56 stars
backtest-demo-favorites SKILL.md skill
spartanlabsxyz/simmer-sdk · simmer_sdk/backtest/demo/backtest-demo-favorites/SKILL.md · Tiny demo skill bundled with `simmer backtest --demo`. Buys YES on liquid favorites to exercise the full backtest…
v1.0.0 · audit A · 56 stars
kalshi-weather-trader SKILL.md skill
spartanlabsxyz/simmer-sdk · skills/kalshi-weather-trader/SKILL.md · Trade Kalshi temperature markets, automate Kalshi weather bets, or check NOAA forecasts using the Simmer SDK and DFlow…
v1.0.14 · audit A · 56 stars
nansen-copytrader-overlay SKILL.md skill
spartanlabsxyz/simmer-sdk · skills/nansen-copytrader-overlay/SKILL.md · Rank Polymarket copytrading leaders using Nansen as a data layer — pnl-by-market for the target market is the primary…
v0.2.2 · audit A · 56 stars

Every file in spartanlabsxyz/simmer-sdk

Browse by kind, by grade A, or by owner.