polymarket

Polymarket — Sports Prediction Markets

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "polymarket" with this command: npx skills add aaaaqwq/claude-code-skills/aaaaqwq-claude-code-skills-polymarket

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

Prerequisites

Core commands (11 commands) work out of the box — no dependencies, no API keys.

CLI commands (30+ commands) require the Polymarket CLI binary:

pip install sports-skills[polymarket]

Or via Homebrew:

brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli brew install polymarket

Trading commands additionally require a configured wallet. Three options:

Option 1 — environment variable

export POLYMARKET_PRIVATE_KEY=0x...

Option 2 — Python SDK (per-session)

from sports_skills import polymarket polymarket.configure(private_key="0x...")

Option 3 — CLI config file (persists across sessions)

polymarket wallet import <private-key> polymarket approve set

If a CLI command returns "polymarket CLI not installed", install with pip install sports-skills[polymarket] .

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

  • cli_search_markets is a more powerful full-text search via the CLI binary. Use it when search_markets returns no results.

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

Workflow: Portfolio Analysis (requires CLI)

  • get_positions --address=<wallet> — open positions

  • get_portfolio_value --address=<wallet> — total value

  • get_trade_history --address=<wallet> --limit=20 — recent trades

  • get_activity --address=<wallet> — full activity feed

Workflow: Market Analytics (requires CLI)

  • get_holders --condition_id=<id> — who holds positions

  • get_open_interest --condition_id=<id> — total interest

  • get_volume --event_id=<id> — volume data

Workflow: Leaderboard (requires CLI)

  • get_leaderboard --period=week --order_by=pnl --limit=20

  • get_profile --address=<top_trader_address> — inspect top traders

Workflow: Trading (requires CLI + wallet)

  • get_balance --asset_type=collateral — check USDC balance

  • cli_search_markets --query="NBA" — find markets

  • get_market_details --market_id=<id> — get token_id

  • create_order --token_id=<id> --side=buy --price=0.55 --size=10

  • get_orders — verify order placed

  • cancel_order --order_id=<id> — cancel if needed

Commands Reference

Core Commands (no CLI needed)

Command Required Optional Description

get_sports_markets

limit, offset, sports_market_types, game_id, active, closed, order, ascending Browse 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

search_markets

query, sports_market_types, tag_id, limit Search by keyword

get_price_history

token_id interval, fidelity Historical prices

get_last_trade_price

token_id

Most recent trade

CLI Commands: Data & Analytics

Command Required Optional Description

get_leaderboard

period, order_by, limit Trader leaderboard

get_positions

address

Open positions

get_closed_positions

address

Closed positions

get_portfolio_value

address

Portfolio value

get_trade_history

address limit Trade history

get_activity

address

Activity feed

get_holders

condition_id

Market position holders

get_open_interest

condition_id

Open interest

get_volume

event_id

Volume data

get_traded

address

Markets traded

CLI Commands: Search, Tags & Discovery

Command Required Optional Description

cli_search_markets

query limit Full-text search (CLI)

get_tags

limit List all tags

get_tag

tag

Tag details

get_related_tags

tag

Related tags

CLI Commands: Comments & Profiles

Command Required Optional Description

get_comments

entity_type, entity_id

Comments on entity

get_comment

comment_id

Single comment

get_user_comments

address

Comments by user

get_profile

address

Public profile

CLI Commands: Sports Metadata

Command Required Optional Description

cli_sports_list

List sports

cli_sports_teams

league limit Teams by league

CLI Commands: CLOB Extras

Command Required Optional Description

get_tick_size

token_id

Minimum tick size

get_fee_rate

token_id

Fee rate

CLI Commands: Trading (requires wallet)

Command Required Optional Description

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_balance

asset_type, token_id Wallet balance

get_orders

market Open orders

get_user_trades

Your trades

CLI Commands: On-Chain (requires wallet)

Command Required Optional Description

ctf_split

condition_id, amount

Split USDC to YES/NO

ctf_merge

condition_id, amount

Merge YES/NO to USDC

ctf_redeem

condition_id

Redeem winning tokens

approve_check

address Check approvals

approve_set

Approve contracts

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

User: "Show me the Polymarket leaderboard"

  • Call get_leaderboard(period="week", order_by="pnl", limit=20)

  • Present traders with rank, username, PnL, and volume

User: "What positions does this wallet hold?"

  • Call get_positions(address="0x...")

  • Present positions with outcome, size, avg price, current value, PnL

User: "Buy 10 shares of YES on this market"

  • Call get_market_details(market_id="...") to get token_id

  • Call create_order(token_id="...", side="buy", price="0.55", size="10")

  • Call get_orders() to confirm

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.

  • If a CLI command returns "polymarket CLI not installed", the command requires the Rust binary. The original 11 commands work without the CLI.

  • If a trading command fails with an auth error, ensure a wallet is configured: polymarket wallet create && polymarket approve set .

  • Never fabricate odds or probabilities. If no market exists, state so.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

multi-search-engine

No summary provided by upstream source.

Repository SourceNeeds Review
633-aaaaqwq
Coding

feishu-automation

No summary provided by upstream source.

Repository SourceNeeds Review
238-aaaaqwq
Coding

web-scraping-automation

No summary provided by upstream source.

Repository SourceNeeds Review
209-aaaaqwq
Coding

memory-hygiene

No summary provided by upstream source.

Repository SourceNeeds Review
184-aaaaqwq