Polymarket
Purpose
Read public Polymarket market data with no key and no account: search and list markets, fetch one market, pull price history, snapshot a public order book, and list or fetch events. Reach for this when the user wants prediction-market odds, event discovery, or price context. This connector cannot trade, place orders, or touch positions.
Tooling
All commands go through bin/polymarket.py. No auth, no environment flags:
bin/polymarket.py markets --limit 25 # list markets
bin/polymarket.py markets --search "bitcoin" # search markets
bin/polymarket.py markets --active --order volume24hr # active, sorted by 24h volume
bin/polymarket.py market-get --condition-id COND_ID # one market by condition id
bin/polymarket.py market-get --slug fed-decision-in-october # one market by slug
bin/polymarket.py prices --condition-id COND_ID --interval 1d # price history
bin/polymarket.py orderbook --token-id TOKEN_ID # public order-book snapshot
bin/polymarket.py events --limit 25 # list events
bin/polymarket.py events --slug fed-decision-in-october # one event by slug
Market objects carry outcomes, outcomePrices, and clobTokenIds (the Yes/No token ids, needed for orderbook), plus bestBid, bestAsk, lastTradePrice, spread, and oneDayPriceChange for quick pricing without extra calls.
Auth
- Provider id: none. The Gamma API is public and requires no key.
- This connector never touches the credential helper and never handles a secret. There is nothing to collect and nothing to store.
- Allowed hosts:
gamma-api.polymarket.com, clob.polymarket.com
- Status check:
bin/polymarket.py events --limit 1 (a successful response proves reachability)
Operating Rules
- Trading is intentionally out of scope. No order placement, no positions, no signed calls ship in this connector. Market data informs; money movement needs a separate, explicit build.
- Order books are public snapshots. The CLI pulls them from the CLOB REST endpoint (
clob.polymarket.com/book), top 10 levels each side. Not a live stream.
- The Gamma API is public but still rate-limited; keep request volume modest and reuse results instead of re-polling.
- Two things stayed unverified. The
/markets/slug/{slug} path never appeared in the docs I read, so use --condition-id if it errors. The price-history interval values (1h, 6h, 1d, 1w, max) come from community docs, not the official reference; the API errors on values it does not support.
Files
- SKILL.md
- bin/polymarket.py
Maturity
Draft: written from Polymarket's public Gamma docs; not yet live-tested end-to-end.
1---2name: "polymarket"3description: "Read-only Polymarket market data: events, markets, prices, order books. No trading, no key needed. Trigger phrases: polymarket, prediction markets, market odds, event prices."4metadata:5 source: https://skillmd.com/skills/anil-matcha/polymarket6 includeInPrompt: true7tagline: "Read-only prediction market data: events, markets, prices, order books. No trading, no API key needed."8catalog_auth: "none, public API"9catalog_hosts: ["gamma-api.polymarket.com"]10---1112# Polymarket1314## Purpose15Read public Polymarket market data with no key and no account: search and list markets, fetch one market, pull price history, snapshot a public order book, and list or fetch events. Reach for this when the user wants prediction-market odds, event discovery, or price context. This connector cannot trade, place orders, or touch positions.1617## Tooling18All commands go through `bin/polymarket.py`. No auth, no environment flags:1920```bash21bin/polymarket.py markets --limit 25 # list markets22bin/polymarket.py markets --search "bitcoin" # search markets23bin/polymarket.py markets --active --order volume24hr # active, sorted by 24h volume24bin/polymarket.py market-get --condition-id COND_ID # one market by condition id25bin/polymarket.py market-get --slug fed-decision-in-october # one market by slug26bin/polymarket.py prices --condition-id COND_ID --interval 1d # price history27bin/polymarket.py orderbook --token-id TOKEN_ID # public order-book snapshot28bin/polymarket.py events --limit 25 # list events29bin/polymarket.py events --slug fed-decision-in-october # one event by slug30```3132Market objects carry `outcomes`, `outcomePrices`, and `clobTokenIds` (the Yes/No token ids, needed for `orderbook`), plus `bestBid`, `bestAsk`, `lastTradePrice`, `spread`, and `oneDayPriceChange` for quick pricing without extra calls.3334## Auth35- Provider id: none. The Gamma API is public and requires no key.36- This connector never touches the credential helper and never handles a secret. There is nothing to collect and nothing to store.37- Allowed hosts: `gamma-api.polymarket.com`, `clob.polymarket.com`38- Status check: `bin/polymarket.py events --limit 1` (a successful response proves reachability)3940## Operating Rules411. **Trading is intentionally out of scope.** No order placement, no positions, no signed calls ship in this connector. Market data informs; money movement needs a separate, explicit build.422. Order books are public snapshots. The CLI pulls them from the CLOB REST endpoint (`clob.polymarket.com/book`), top 10 levels each side. Not a live stream.433. The Gamma API is public but still rate-limited; keep request volume modest and reuse results instead of re-polling.444. Two things stayed unverified. The `/markets/slug/{slug}` path never appeared in the docs I read, so use `--condition-id` if it errors. The price-history `interval` values (`1h`, `6h`, `1d`, `1w`, `max`) come from community docs, not the official reference; the API errors on values it does not support.4546## Files47- SKILL.md48- bin/polymarket.py4950## Maturity51Draft: written from Polymarket's public Gamma docs; not yet live-tested end-to-end.