How do I install the Polymarket skill?

Run npx skillmds add tools-only/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. Capability flags: 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. This skill is licensed under MIT.

Who published Polymarket?

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

Polymarket by tools-only — Agent Skill

Name: Polymarket
Rating: 4.666666666666667 (3 reviews)
Author: tools-only

Polymarket

Polymarket sports prediction markets — live odds, prices, order books, events, series, and market search. No auth required. Covers NFL, NBA, MLB, soccer, tennis, cricket, MMA, esports. Supports moneyline, spreads, totals, and player props. Use when: user asks about sports betting odds, prediction markets, win probabilities, market sentiment, or "who is favored to win" questions. Don't use when: user asks about actual match results, scores, or statistics — use football-data or fastf1 instead. Don't use for historical match data. Don't use for news — use sports-news instead. Don't confuse with Kalshi — Polymarket focuses on crypto-native prediction markets with deeper sports coverage; Kalshi is a US-regulated exchange with different market structure.

tools-only c27bff7 3 files · 8.2 KB Updated Sep 8, 2026 7 repo stars

File contents

Polymarket — Sports Prediction Markets

Quick Start

Prefer the CLI — it avoids Python import path issues:

sports-skills polymarket get_sports_markets --limit=20
sports-skills polymarket search_markets --query="NBA Finals"

Python SDK (alternative):

from sports_skills import polymarket

markets = polymarket.get_sports_markets(limit=20)
prices = polymarket.get_market_prices(token_id="abc123")

Important Notes

Prices are probabilities. A price of 0.65 means 65% implied probability. No conversion needed.
token_id vs market_id: Price and orderbook endpoints require the CLOB token_id, not the Gamma market_id. Always call get_market_details first to get clobTokenIds.
search_markets matches event titles, not sport categories. Use specific league names ("Premier League", "Champions League"), not generic terms ("soccer", "football").
Before complex fetches, run the parameter validator: bash scripts/validate_params.sh <command> [args]

For detailed reference data, see the files in the references/ directory.

Workflows

Workflow: Live Odds Check

search_markets --query="<league/event name>"
get_market_details --market_id=<id> to get CLOB token IDs.
get_market_prices --token_id=<id>
Present probabilities.

Workflow: Event Overview

get_sports_events --active=true
Pick event, then get_event_details --event_id=<id>.
For each market, get prices.

Workflow: Price Trend Analysis

Find market via search_markets.
get_market_details for token_id.
get_price_history --token_id=<id> --interval=1w
Present price movement.

Examples

User: "Who's favored to win the NBA Finals?"

Call search_markets(query="NBA Finals", sports_market_types="moneyline")
Get token_id from the market details
Call get_market_prices(token_id="...") for current odds
Present teams with implied probabilities (price = probability)

User: "Who will win the Premier League?"

Call search_markets(query="English Premier League") -- use full league name
Sort results by Yes outcome price descending
Present teams with implied probabilities (price = probability)

User: "Show me Champions League odds"

Call search_markets(query="Champions League")
Present top contenders with prices, volume, and liquidity

Error Handling & Fallbacks

If search returns 0 results, try full league names ("English Premier League" not "EPL", "Champions League" not "CL"). search_markets matches event titles.
If get_market_prices fails, you likely used market_id instead of token_id. Always call get_market_details first to get CLOB token_id.
If prices seem stale, check get_last_trade_price for the most recent trade. Low-liquidity markets may have wide spreads.
Never fabricate odds or probabilities. If no market exists, state so.

---name: polymarketdescription: Polymarket sports prediction markets — live odds, prices, order books, events, series, and market search. No auth required. Covers NFL, NBA, MLB, soccer, tennis, cricket, MMA, esports. Supports moneyline, spreads, totals, and player props. Use when: user asks about sports betting odds, prediction markets, win probabilities, market sentiment, or "who is favored to win" questions. Don't use when: user asks about actual match results, scores, or statistics — use football-data or fastf1 instead. Don't use for historical match data. Don't use for news — use sports-news instead. Don't confuse with Kalshi — Polymarket focuses on crypto-native prediction markets with deeper sports coverage; Kalshi is a US-regulated exchange with different market structure.license: MIT---# Polymarket — Sports Prediction Markets## Quick StartPrefer the CLI — it avoids Python import path issues:```bashsports-skills polymarket get_sports_markets --limit=20sports-skills polymarket search_markets --query="NBA Finals"```Python SDK (alternative):```pythonfrom sports_skills import polymarketmarkets = polymarket.get_sports_markets(limit=20)prices = polymarket.get_market_prices(token_id="abc123")```## Important Notes- **Prices are probabilities.** A price of 0.65 means 65% implied probability. No conversion needed.- **`token_id` vs `market_id`:** Price and orderbook endpoints require the CLOB `token_id`, not the Gamma `market_id`. Always call `get_market_details` first to get `clobTokenIds`.- **`search_markets` matches event titles**, not sport categories. Use specific league names ("Premier League", "Champions League"), not generic terms ("soccer", "football").- Before complex fetches, run the parameter validator: `bash scripts/validate_params.sh <command> [args]`*For detailed reference data, see the files in the `references/` directory.*## Workflows### Workflow: Live Odds Check1. `search_markets --query="<league/event name>"`2. `get_market_details --market_id=<id>` to get CLOB token IDs.3. `get_market_prices --token_id=<id>`4. Present probabilities.### Workflow: Event Overview1. `get_sports_events --active=true`2. Pick event, then `get_event_details --event_id=<id>`.3. For each market, get prices.### Workflow: Price Trend Analysis1. Find market via `search_markets`.2. `get_market_details` for token_id.3. `get_price_history --token_id=<id> --interval=1w`4. Present price movement.## ExamplesUser: "Who's favored to win the NBA Finals?"1. Call `search_markets(query="NBA Finals", sports_market_types="moneyline")`2. Get `token_id` from the market details3. Call `get_market_prices(token_id="...")` for current odds4. Present teams with implied probabilities (price = probability)User: "Who will win the Premier League?"1. Call `search_markets(query="English Premier League")` -- use full league name2. Sort results by Yes outcome price descending3. Present teams with implied probabilities (price = probability)User: "Show me Champions League odds"1. Call `search_markets(query="Champions League")`2. Present top contenders with prices, volume, and liquidity## Error Handling & Fallbacks- If search returns 0 results, try full league names ("English Premier League" not "EPL", "Champions League" not "CL"). search_markets matches event titles.- If `get_market_prices` fails, you likely used `market_id` instead of `token_id`. Always call `get_market_details` first to get CLOB `token_id`.- If prices seem stale, check `get_last_trade_price` for the most recent trade. Low-liquidity markets may have wide spreads.- **Never fabricate odds or probabilities.** If no market exists, state so.

Frequently asked questions