# Polymarket Cli

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

- **Type:** Skill
- **Install:** `agentstack add skill-ra1nty-polymarket-cli-polymarket-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ra1nty](https://agentstack.voostack.com/s/ra1nty)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ra1nty](https://github.com/ra1nty)
- **Source:** https://github.com/ra1nty/polymarket-cli/tree/main/skills/polymarket-cli

## Install

```sh
agentstack add skill-ra1nty-polymarket-cli-polymarket-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```bash
uv tool install polymarket-cli
polymarket-cli --help
```

For one-off execution without installing:

```bash
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

```bash
polymarket-cli search bitcoin --limit 5
polymarket-cli list --active-only --sort liquidity --min-liquidity 10000
polymarket-cli market --slug  --json
polymarket-cli book --slug  --outcome Yes
polymarket-cli history --slug  --window 6h --format summary --json
polymarket-cli trades --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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ra1nty](https://github.com/ra1nty)
- **Source:** [ra1nty/polymarket-cli](https://github.com/ra1nty/polymarket-cli)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ra1nty-polymarket-cli-polymarket-cli
- Seller: https://agentstack.voostack.com/s/ra1nty
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.