Data & analysis

Polymarket Research

Try it

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

What it does

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.

The skill document

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:

FieldSource
Question, status, resolution dateSimmer SDK
YES/NO probabilitySimmer SDK (synced from Polymarket CLOB)
24h volumeSimmer SDK
Top holders per outcomePolymarket data API (free, no auth)
Edge analysis vs AI priceSimmer SDK context endpoint

Configuration

ParameterEnv varDefaultDescription
Search query(CLI arg)requiredTopic to search for
Min volumeSIMMER_RESEARCH_MIN_VOLUME10000Skip markets below this 24h volume
Max resultsSIMMER_RESEARCH_MAX_RESULTS5Markets to return
Top holdersSIMMER_RESEARCH_TOP_HOLDERS10Holders 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

Trade crypto, manage a multi-chain wallet, and query an AI analyst from one CLI.

by lowesyang162 installs109 stars

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván555 installs18 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai21 installs8 stars

Post videos, photos, text, and documents to 10 social platforms through a single REST API call.

by victorcavero14375 installs50 stars

More from simmer

Browse all skills

Trade Polymarket 5-minute BTC fast markets using Binance momentum signals through the Simmer SDK.

by simmer263 installs50 stars

Trade prediction markets through one SDK across Polymarket, Kalshi, and a virtual $SIM practice venue.

by simmer312 installs23 stars

Scan Polymarket temperature markets and trade with NOAA or Open-Meteo forecasts, with dry-run and real-money controls.

by Simmer.Markets215 installs5 stars

Copy top Polymarket whale positions in batch or in real time, with built-in rebalancing and per-trade caps.

by simmer123 installs4 stars

Scan Polymarket markets resolving in minutes, filter for 60/40+ splits, and back the favored side with a capped bet size.

by simmer92 installs

Turn a trading idea into an installable Simmer prediction-market skill

by simmer58 installs