Polymarket cli

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

Lightweight cli-based Polymarket marketdata-only agent skills.

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.

One thing 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.

What its author says it does

Copied from the file, not written here

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

SKILL.md

1.7 KB, 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.