How do I install the Polymarket skill?

Run npx skillmds@latest add dvcrn/polymarket-5 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Polymarket safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Polymarket?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Polymarket free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Polymarket?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Polymarket by dvcrn — Agent Skill

Name: Polymarket
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

Polymarket

Query Polymarket prediction market odds and events via CLI. Search for markets, get current prices, list events by category. Supports sports betting (NFL, NBA, soccer/EPL, Champions League), politics, crypto, elections, geopolitics. Real money markets = more accurate than polls. No API key required. Use when asked about odds, probabilities, predictions, or "what are the chances of X".

dvcrn Updated Sep 9, 2026 32 repo stars

File contents

Polymarket Prediction Markets

Query real-time odds from Polymarket, the world's largest prediction market.

Quick Start

# Search for markets (instant via /public-search API)
polymarket search "Arsenal FC"
polymarket search "Super Bowl"
polymarket search "Bitcoin"
polymarket search "Trump"

# Browse by category
polymarket events --tag=sports
polymarket events --tag=crypto
polymarket events --tag=politics

# Get specific market details
polymarket market will-bitcoin-reach-100k

The CLI is at polymarket.mjs in this skill folder. Run with:

node /path/to/skill/polymarket.mjs <command>

Commands

Command	Description
`search <query>`	Search markets by keyword (recommended)
`events [options]`	List active events
`market <slug>`	Get market details by slug
`tags`	List available categories
`price <token_id>`	Get current price for a token
`book <token_id>`	Get orderbook depth

Event Options

--tag=<slug> - Filter by category (crypto, politics, sports, etc.)
--limit=<n> - Maximum results (default: 20)

Understanding Odds

Prices = Probabilities:

0.65 (65¢) = 65% chance of "Yes"
Volume = total $ traded
Liquidity = available $ in orderbook

Individual Match Betting

Polymarket has individual match markets for soccer, NFL, NBA, and more.

# Soccer - use "FC" suffix for team names
polymarket search "Arsenal FC"
polymarket search "Manchester United FC"
polymarket search "Liverpool FC"

# NFL/NBA - team name works
polymarket search "Patriots"
polymarket search "Chiefs"
polymarket search "Lakers"

Market types available:

Moneyline: Win/Draw/Lose percentages
Spreads: e.g., Arsenal -1.5
Totals: Over/Under 2.5 goals
BTTS: Both Teams to Score

Common Categories

Tag	Markets
`sports`	NFL, NBA, soccer, tennis, etc.
`politics`	Elections, legislation, appointments
`crypto`	Price targets, ETFs, regulations
`business`	IPOs, acquisitions, earnings
`tech`	Product launches, AI developments

API Reference

The CLI uses these public endpoints (no auth required):

Search: GET /public-search?q=<query> - keyword search
Events: GET /events?active=true&closed=false - list events
Markets: GET /markets?slug=<slug> - market details
Tags: GET /tags - available categories

Base URL: https://gamma-api.polymarket.com

Notes

Real money markets tend to be more accurate than polls/pundits
Odds update in real-time as people trade
Markets resolve to $1.00 (correct) or $0.00 (incorrect)

---name: polymarket-5description: Query Polymarket prediction market odds and events via CLI. Search for markets, get current prices, list events by category. Supports sports betting (NFL, NBA, soccer/EPL, Champions League), politics, crypto, elections, geopolitics. Real money markets = more accurate than polls. No API key required. Use when asked about odds, probabilities, predictions, or "what are the chances of X".--- # Polymarket Prediction Markets Query real-time odds from Polymarket, the world's largest prediction market. ## Quick Start ```bash # Search for markets (instant via /public-search API) polymarket search "Arsenal FC" polymarket search "Super Bowl" polymarket search "Bitcoin" polymarket search "Trump" # Browse by category polymarket events --tag=sports polymarket events --tag=crypto polymarket events --tag=politics # Get specific market details polymarket market will-bitcoin-reach-100k ``` The CLI is at `polymarket.mjs` in this skill folder. Run with: ```bash node /path/to/skill/polymarket.mjs <command> ``` ## Commands | Command | Description | |---------|-------------| | `search <query>` | Search markets by keyword (recommended) | | `events [options]` | List active events | | `market <slug>` | Get market details by slug | | `tags` | List available categories | | `price <token_id>` | Get current price for a token | | `book <token_id>` | Get orderbook depth | ## Event Options - `--tag=<slug>` - Filter by category (crypto, politics, sports, etc.) - `--limit=<n>` - Maximum results (default: 20) ## Understanding Odds Prices = Probabilities: - 0.65 (65¢) = 65% chance of "Yes" - Volume = total $ traded - Liquidity = available $ in orderbook ## Individual Match Betting Polymarket has individual match markets for soccer, NFL, NBA, and more. ```bash # Soccer - use "FC" suffix for team names polymarket search "Arsenal FC" polymarket search "Manchester United FC" polymarket search "Liverpool FC" # NFL/NBA - team name works polymarket search "Patriots" polymarket search "Chiefs" polymarket search "Lakers" ``` **Market types available:** - **Moneyline**: Win/Draw/Lose percentages - **Spreads**: e.g., Arsenal -1.5 - **Totals**: Over/Under 2.5 goals - **BTTS**: Both Teams to Score ## Common Categories | Tag | Markets | |-----|---------| | `sports` | NFL, NBA, soccer, tennis, etc. | | `politics` | Elections, legislation, appointments | | `crypto` | Price targets, ETFs, regulations | | `business` | IPOs, acquisitions, earnings | | `tech` | Product launches, AI developments | ## API Reference The CLI uses these public endpoints (no auth required): - **Search**: `GET /public-search?q=<query>` - keyword search - **Events**: `GET /events?active=true&closed=false` - list events - **Markets**: `GET /markets?slug=<slug>` - market details - **Tags**: `GET /tags` - available categories Base URL: `https://gamma-api.polymarket.com` ## Notes - Real money markets tend to be more accurate than polls/pundits - Odds update in real-time as people trade - Markets resolve to $1.00 (correct) or $0.00 (incorrect)

Frequently asked questions