# polymarket

This skill searches Polymarket markets, checks positions, and helps place or cancel CLOB V2 orders from a Privy EOA wallet.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 237 installs · ★ 33 repo stars
- Author: starchild
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/polymarket/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/starchild-polymarket

## What it does

The skill works with Polymarket prediction markets through CLOB V2. It can find events, return YES and NO token IDs with current prices, and show balances, positions, open orders, and recent trades. An order is prepared as an EIP-712 payload, signed through `wallet_sign_typed_data`, then submitted by a script.

The package includes `search.py`, `status.py`, `prepare_order.py`, `post_order.py`, `cancel.py`, `close_positions.py`, `setup.py`, and `auth.py`. Before the first order, the wallet needs USDC.e on Polygon; `setup.py` wraps it into pUSD and sets the required approvals. Without USDC.e on Polygon and the pUSD setup, the first order will fail. Authentication uses `POLY_API_KEY`, `POLY_SECRET`, `POLY_PASSPHRASE`, and `POLY_WALLET`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill polymarket -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/polymarket/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/polymarket/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill polymarket -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/polymarket/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill polymarket -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/polymarket/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills polymarket
```

2. **Manually: put the files in place**
- File: `.github/skills/polymarket/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill polymarket -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path polymarket
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/polymarket/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill polymarket -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/polymarket/SKILL.md

## When to use it
- find a market from a short keyword
- inspect balances, positions, and open orders
- prepare and submit a BUY or SELL order
- cancel one order or cancel every order
- build SELL orders for current positions

## Example prompts
- Search for markets using the short keyword `ceasefire` and show the YES and NO tokens.
- Prepare a purchase of token `7892825...50228` at price `0.65` with size `10`, then ask me to sign it.
- Show my positions and open orders, then close the position for the selected token.

## Similar
- [polymarket-live-executor](https://affpapa.org/en/nevibecode/skills/polymarket-live-executor.md) — skill · 170 installs
- [grimoire-polymarket](https://affpapa.org/en/nevibecode/skills/grimoire-polymarket.md) — skill · 11900 installs
- [Polymarket Data by PolymarketScan](https://affpapa.org/en/nevibecode/mcp/polymarket-data-by-polymarketscan.md) — MCP server · 39483 installs
- [polymarket-analyzer](https://affpapa.org/en/nevibecode/skills/polymarket-analyzer.md) — skill · 494 installs
- [web3-polymarket](https://affpapa.org/en/nevibecode/skills/web3-polymarket.md) — skill · 611 installs
- [polymarket-copy-trading-bot](https://affpapa.org/en/nevibecode/skills/polymarket-copy-trading-bot.md) — skill · 812 installs

## Other versions with the same name
- [polymarket · nousresearch](https://affpapa.org/en/nevibecode/skills/hermes-agent-teknium-polymarket.md) — 282 installs
- [polymarket · machina-sports](https://affpapa.org/en/nevibecode/skills/polymarket.md) — 1400 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
