How do I install the Polymarket skill?

Run npx skillmds@latest add hanzoskill/polymarket 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. 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?

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

Polymarket by hanzoskill — Agent Skill

Name: Polymarket
Author: hanzoskill

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".

hanzoskill cc8273b 4 files · 11.5 KB Updated Sep 17, 2026

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: polymarketdescription: 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 MarketsQuery 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 categorypolymarket events --tag=sportspolymarket events --tag=cryptopolymarket events --tag=politics# Get specific market detailspolymarket market will-bitcoin-reach-100k```The CLI is at `polymarket.mjs` in this skill folder. Run with:```bashnode /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 OddsPrices = Probabilities:- 0.65 (65¢) = 65% chance of "Yes"- Volume = total $ traded- Liquidity = available $ in orderbook## Individual Match BettingPolymarket has individual match markets for soccer, NFL, NBA, and more.```bash# Soccer - use "FC" suffix for team namespolymarket search "Arsenal FC"polymarket search "Manchester United FC"polymarket search "Liverpool FC"# NFL/NBA - team name workspolymarket 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 ReferenceThe 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 categoriesBase 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