# Query and Manage Polymarket Markets

Polymarket research often requires several CLI commands across market discovery, CLOB data, and authenticated reads. This skill gives Claude, Codex, and Claude Code a focused Grimoire CLI surface for those workflows.

## Install

```bash
npx skillstore add franalgaba/grimoire-polymarket
```

## Metadata

- Status: approved
- Slug: franalgaba-grimoire-polymarket
- Skillstore revision: r1
- Version status: missing
- Tree hash: bd9ef8fc46410e6f9eee3c0e4b468c217a2561f352a125fa59850bd9a91af766
- Author: franalgaba
- GitHub username: franalgaba
- License: MIT
- Repository: https://github.com/franalgaba/grimoire/tree/main/skills/grimoire-polymarket/
- Ref: 30c73eac2afe762f6aa9c4553158769369d47351
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, env\_access
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/franalgaba-grimoire-polymarket
- Manifest: https://skillstore.pages.dev/api/skills/franalgaba-grimoire-polymarket/manifest

## Capabilities

- Runs Grimoire Polymarket info and status checks through the venue adapter.
- Searches markets by query, slug, event, category, sport, league, and status.
- Retrieves CLOB book, midpoint, price, trades, orders, and balance information.
- Uses the official Polymarket CLI through a restricted wrapper surface.
- Documents authenticated order and cancellation operation names for supported custom flows.

## Use Cases

- Research Active Markets: Find open Polymarket markets by topic, event, category, sport, or league before deeper analysis.
- Inspect CLOB Liquidity: Review books, midpoints, spreads, prices, trades, and balances for a known token or condition.
- Standardize Agent Workflows: Route Claude, Codex, or Claude Code through the same Grimoire Polymarket command surface.

## Prompt Templates

### Find Topic Markets

```
Find active open Polymarket markets about bitcoin. Summarize the top results with status, event names, and end dates.
```

### Check CLOB Data

```
Check the order book, midpoint, and price for token id <token_id>. Explain liquidity and any missing data.
```

### Compare League Markets

```
Compare open and active sports markets for league <league>. Highlight tradable markets and key differences across events.
```

### Review Open Orders

```
Using my configured environment credentials, inspect my open orders for market <condition_id>. Do not place or cancel orders without confirmation.
```

## Limitations

- Requires the Grimoire CLI or official Polymarket CLI to be installed.
- Authenticated operations require private key or API credentials in environment variables.
- It does not provide investment advice or predict market outcomes.
- It does not expose blocked wallet, bridge, approve, setup, upgrade, or shell groups.

## Best Practices

- Use read-only market discovery before any authenticated order workflow.
- Store Polymarket credentials in environment variables, not in prompts or shared logs.
- Request explicit user confirmation before any order placement or cancellation.

## Anti Patterns

- Pasting private keys or API secrets into chat messages.
- Running no-install package commands without checking the package source and version.
- Treating market summaries as financial or betting advice.

## Security Audit

- Audited at: 2026-07-05T15:56:51.762\+00:00
- Summary: The external-command alerts are mostly Markdown backtick false positives, but several Grimoire, npx, bun, and brew invocations are real command surfaces. The skill also requires Polymarket private keys or API credentials and supports authenticated order workflows, so users need strong warnings and confirmation controls. No prompt injection attempt was found in SKILL.md.

## Stats

- Views: 225
- Downloads: 8
- Favorites: 0
- Popularity score: 0