Polymarket cli

Skill ra1nty/polymarket-cli/skills/polymarket-cli

Use the polymarket-cli command for read-only Polymarket market discovery, market/token resolution, price snapshots, history, trades, and JSON-safe scripting.From its SKILL.md

Install

npx -y skills add ra1nty/polymarket-cli --skill polymarket-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 3 commands, including `uv tool install polymarket-cli` and 2 more.

SKILL.md

1.7 KB, 376 tokens by cl100k_base, as published. Nobody here has run it

Using `polymarket-cli`

Use this skill when an agent needs public, read-only Polymarket data from this package without calling Gamma, CLOB, or Data API endpoints directly.

Install the published CLI:

uv tool install polymarket-cli
polymarket-cli --help

For one-off execution without installing:

uvx polymarket-cli --help

When to use `polymarket-cli`

Discover markets by keyword, liquidity, volume, tags, or date windows.
Resolve a market slug or id into a conditionId or outcome token_id.
Pull spot pricing with book, midpoint, or price.
Pull recent public trades for a market condition.
Pull token price history and locally aggregate it into OHLC or summaries.
Produce scriptable JSON output for another tool or agent step.

Command patterns

polymarket-cli search bitcoin --limit 5
polymarket-cli list --active-only --sort liquidity --min-liquidity 10000
polymarket-cli market --slug <market-slug> --json
polymarket-cli book --slug <market-slug> --outcome Yes
polymarket-cli history --slug <market-slug> --window 6h --format summary --json
polymarket-cli trades --condition-id <condition-id> --json

Working rules

Prefer polymarket-cli in docs, prompts, and automation.
Prefer --json whenever another step will parse the result.
Use explicit selectors: --slug, --id, --token-id, --condition-id.
Keep usage read-only. This package does not place orders, manage wallets, or use private/authenticated APIs.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.