polymarket-cli 0.2.0

Production-oriented read-only CLI wrapper around Polymarket public Gamma + CLOB APIs

polymarket-cli

Read-only CLI for public Polymarket Gamma, CLOB, and Data API lookups.

This package stays intentionally narrow: public, unauthenticated reads only. It does not place orders, manage wallets, sign anything, or depend on private APIs.

The published Pypi package is polymarket-cli.

What It Covers

• Market discovery via search and list
• Market detail lookup via market
• Order book and spot pricing via book, midpoint, and price
• Recent public trades via trades
• Public token price history via history

Install

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

For one-off execution:

uvx polymarket-cli --help

If your uv tool bin directory is not on PATH, either run uv tool update-shell or call the binary directly from $(uv tool dir --bin).

Agent Skill Installation

Install the packaged skill with npx skills:

OpenClaw

npx skills add ra1nty/polymarket-cli -a openclaw

Claude Code

npx skills add ra1nty/polymarket-cli -a claude-code

After installation, use the public command surface in agent prompts and automation:

polymarket-cli search bitcoin --limit 5
polymarket-cli market --slug <market-slug> --json

Usage

polymarket-cli search bitcoin --limit 5
polymarket-cli list --active-only --sort volume24hr --limit 20
polymarket-cli market --slug btc-updown-5m-1774165800
polymarket-cli book --slug btc-updown-5m-1774165800 --outcome Down
polymarket-cli price --slug btc-updown-5m-1774165800
polymarket-cli history --slug btc-updown-5m-1774165800 --window 6h --format summary --json
polymarket-cli trades --slug btc-updown-5m-1774165800 --limit 20

Useful flags:

• --json is available on every command.
• --hydrate resolves search/list rows to full market detail before local ranking or filtering.
• --with-odds implies hydration and includes current outcome prices.
• --with-market implies hydration and embeds the resolved market payload in JSON output.
• Market selectors are explicit: --slug, --id, --token-id, --condition-id.

Supported history intervals: max, all, 1m, 1h, 6h, 1d, 1w.