Polymarket
Wire an agent to Polymarket sports markets—events, prices, order books, and optional CLOB trading—via documented commands and parameters.
Overview
Polymarket is an agent skill for the Build phase that documents Polymarket sports-market API commands for discovery, pricing, order books, and optional wallet-backed trading.
Install
npx skills add https://github.com/machina-sports/sports-skills --skill polymarketWhat is this skill?
- Core read commands: sports config, today’s events, search_markets, market/event details, CLOB prices, order book, price
- Browse and filter flows: get_sports_markets, get_sports_events, get_series with pagination and market-type filters
- Trading commands gated on py_clob_client plus wallet: configure, create_order, market_order
- Explicit required vs optional parameters per command table for agent tool calling
- League-oriented discovery via sport codes (nba, epl, nfl, bun, fl1, etc.)
- Core command table covers discovery, pricing, and history without extra dependencies
- Trading commands require py_clob_client plus wallet configuration
- Documents sport league codes including nba, epl, nfl, bun, and fl1
Adoption & trust: 664 installs on skills.sh; 134 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are building a sports-market agent or script but keep guessing Polymarket command names, filters, and which calls require a configured wallet.
Who is it for?
Indie developers prototyping sports odds dashboards, market scanners, or agent tools that read Polymarket data and may later add trading.
Skip if: Non-technical bettors seeking picks, or teams that need licensed gambling compliance/legal review instead of API wiring.
When should I use this skill?
User asks to query Polymarket sports markets, prices, events, order books, or to place/configure trading against the CLOB.
What do I get? / Deliverables
Your agent uses a consistent command vocabulary for events, markets, prices, and—when configured—order placement against the CLOB.
- Correctly parameterized API/command invocations for read or trade flows
- Structured market, event, price, or order-book responses for downstream app logic
Recommended Skills
Journey fit
The skill is an API command reference for building or operating integrations against Polymarket, which sits in Build → integrations. It documents external API/MCP-style commands (markets, CLOB, wallet configure) rather than UI, SEO, or infra monitoring.
How it compares
An integration reference skill for Polymarket sports APIs—not a general finance MCP server or analytics warehouse connector.
Common Questions / FAQ
Who is polymarket for?
Solo builders and agent authors integrating Polymarket sports markets into apps, bots, or internal research tools who need exact command and parameter shapes.
When should I use polymarket?
Use it during Build integrations when implementing get_todays_events, search_markets, get_order_book, or trading flows after configure—with sport codes and token_ids from live markets.
Is polymarket safe to install?
Trading commands involve wallets and private keys; review the Security Audits panel on this Prism page, never paste production keys into chats, and scope agent permissions narrowly.
SKILL.md
READMESKILL.md - Polymarket
# Polymarket — API Reference ## Core Commands (no dependencies needed) | Command | Required | Optional | Description | |---|---|---|---| | `get_sports_config` | | | Available sport codes (nba, epl, nfl, bun, fl1, etc.) | | `get_todays_events` | sport | limit | Today's events for a league — sorted by start date | | `search_markets` | | query, sport, sports_market_types, tag_id, limit | Find markets by sport, keyword, and type | | `get_sports_markets` | | limit, offset, sports_market_types, game_id, active, closed, order, ascending | Browse all sports markets | | `get_sports_events` | | limit, offset, active, closed, order, ascending, series_id | Browse sports events | | `get_series` | | limit, offset | List series (leagues) | | `get_market_details` | | market_id, slug | Single market details | | `get_event_details` | | event_id, slug | Single event details | | `get_market_prices` | | token_id, token_ids | Current CLOB prices | | `get_order_book` | token_id | | Full order book | | `get_sports_market_types` | | | Valid market types | | `get_price_history` | token_id | interval, fidelity | Historical prices | | `get_last_trade_price` | token_id | | Most recent trade | ## Trading Commands (requires py_clob_client + wallet) | Command | Required | Optional | Description | |---|---|---|---| | `configure` | | private_key, signature_type | Configure wallet | | `create_order` | token_id, side, price, size | order_type | Place limit order | | `market_order` | token_id, side, amount | | Place market order | | `cancel_order` | order_id | | Cancel order | | `cancel_all_orders` | | | Cancel all orders | | `get_orders` | | market | Open orders | | `get_user_trades` | | | Your trades | ## Sport Codes (Common) | Code | League | Code | League | |---|---|---|---| | `nba` | NBA | `epl` | English Premier League | | `nfl` | NFL | `bun` | Bundesliga | | `nhl` | NHL | `lal` | La Liga | | `mlb` | MLB | `fl1` | Ligue 1 | | `wnba` | WNBA | `sea` | Serie A | | `cfb` | College Football | `ucl` | Champions League | | `cbb` | College Basketball | `uel` | Europa League | | `atp` | ATP Tennis | `mls` | MLS | | `wta` | WTA Tennis | `fifwc` | FIFA World Cup 2026 | Run `get_sports_config()` for the full list of 120+ sport codes. ## Price Format Prices on Polymarket are probabilities on a 0-1 scale: - Price of `0.65` = 65% implied probability - No conversion needed - `token_id` (CLOB) is required for price/orderbook endpoints — use `get_market_details` to get `clobTokenIds` from a `market_id` See `references/api.md` and `references/commands.md` for extended documentation. # Polymarket APIs - **Gamma API** (gamma-api.polymarket.com): Market metadata, events, series. Public, no auth. Used by core commands. - **CLOB API** (clob.polymarket.com): Prices, order books, trades. Public reads, no auth. Used by core commands. - **py_clob_client** (Python SDK): Trading operations (create/cancel orders, view trades). Requires `pip install sports-skills[polymarket]` and a wallet private key. No CLI binary needed. # Valid Commands & Common Mistakes ## CRITICAL: Always use the `sport` parameter For single-game markets, ALWAYS pass `sport='<code>'` to `search_markets` and `get_todays_events`. ``` WRONG: search_markets(query="Leeds") → 0 results RIGHT: search_markets(sport='epl', query='Leeds') → returns all Leeds markets ``` ## Core Commands (no dependencies needed) These work out of the box: - `get_sports_config` — **list all available sport codes** (nba, epl, nfl, bun, etc.) - `get_todays_events` — **today's events for a specific sport** (requires `sport` param) - `search_markets` — **find markets by sport, keyword, and type** (use `sport` param for single-game markets) - `get_sports_markets` — browse all sports markets (sorted by volume) - `get_sports_events` — browse sports events (sorted by volume) - `get_series` — list series (leagues) - `get_market_details` — single market details (by market_id or slug) - `get_event_details` — single event detai