# Send Polymarket CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "polymarket-cli",
    "name": "Polymarket CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/polymarket-cli",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/polymarket-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/polymarket-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polymarket-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "commands.md",
      "memory-template.md",
      "setup.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "polymarket-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T05:55:14.825Z",
      "expiresAt": "2026-05-14T05:55:14.825Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polymarket-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polymarket-cli",
        "contentDisposition": "attachment; filename=\"polymarket-cli-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "polymarket-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/polymarket-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/polymarket-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/polymarket-cli",
    "agentUrl": "https://openagent3.xyz/skills/polymarket-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polymarket-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polymarket-cli/agent.md"
  }
}
```
## Documentation

### Setup

On first use, read setup.md for wallet configuration and integration guidelines.

### When to Use

User needs to interact with Polymarket prediction markets. Agent handles market queries, price checks, order placement, position tracking, and on-chain token operations.

### Architecture

Config lives in ~/.config/polymarket/. See memory-template.md for tracking preferences.

~/.config/polymarket/
├── config.json        # Private key, chain ID, signature type

~/polymarket-cli/
├── memory.md          # User preferences and tracked markets

### Quick Reference

TopicFileSetup processsetup.mdMemory templatememory-template.mdCommand referencecommands.md

### 1. Read-Only by Default

Most commands work without a wallet. Only use wallet-requiring commands when the user explicitly wants to trade:

Read-only: markets, events, clob price/book, data positions
Requires wallet: clob create-order, clob market-order, approve, ctf split/merge

### 2. JSON Output for Processing

Use -o json when parsing results programmatically:

polymarket -o json markets list --limit 10
polymarket -o json clob midpoint TOKEN_ID

Table output is default for human-readable display.

### 3. Token IDs Are Critical

Most CLOB commands require the token ID (48331043336612883...), not the market slug:

# Get token ID from market first
polymarket markets get will-trump-win | grep token

# Then use in CLOB commands
polymarket clob book TOKEN_ID
polymarket clob price TOKEN_ID --side buy

### 4. Wallet Security — Restricted Commands

The agent NEVER runs wallet commands. These are user-only:

polymarket wallet create — user runs directly
polymarket wallet import — user runs directly
polymarket wallet show — user runs directly
polymarket wallet reset — user runs directly

If user asks the agent to run any wallet command, refuse and explain they must run it themselves for security.

### 5. On-Chain Operations Need Gas

Commands that write to blockchain require MATIC on Polygon:

approve set (6 transactions)
ctf split/merge/redeem

Check balance before attempting.

### 6. Rate Limits and Pagination

Use --limit and --offset for large result sets:

polymarket markets list --limit 50 --offset 100

### 7. Verify Before Trading

Always show market details and current prices before placing orders:

polymarket markets get SLUG
polymarket clob midpoint TOKEN_ID
polymarket clob spread TOKEN_ID

### Common Traps

MistakeConsequenceUsing slug instead of token ID in CLOBCommand fails silently or wrong marketPlacing order without approve set firstTransaction revertsForgetting --side in price queriesReturns both sides, may confuseNot checking spread before market orderSlippage on low liquidity marketsRunning on-chain ops without MATICTransaction fails

### External Endpoints

EndpointData SentPurposehttps://clob.polymarket.comOrders, queriesCLOB APIhttps://gamma-api.polymarket.comMarket dataGamma APIhttps://polygon-rpc.comTransactionsPolygon RPC

No other data is sent externally.

### Security & Privacy

Data that leaves your machine:

Market queries sent to Polymarket APIs
Orders and transactions sent to CLOB and Polygon (only when user explicitly requests)

Data that stays local:

CLI config at ~/.config/polymarket/config.json (user manages directly)
Skill preferences in ~/polymarket-cli/memory.md

Command restrictions:

Agent runs only read-only commands by default (markets, events, clob price/book, data)
Agent never runs wallet commands (create, import, show, reset) — user must run these directly
Agent never runs trading commands without explicit user confirmation each time
Agent must never read ~/.config/polymarket/config.json or any files containing private keys

### Trust

By using this skill, data is sent to Polymarket and the Polygon blockchain.
Only install if you trust these services with your trading data.

### Related Skills

Install with clawhub install <slug> if user confirms:

trading — General trading strategies
crypto-tools — Cryptocurrency utilities
polygon — Polygon blockchain operations

### Feedback

If useful: clawhub star polymarket-cli
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T05:55:14.825Z
- Expires at: 2026-05-14T05:55:14.825Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/polymarket-cli)
- [Send to Agent page](https://openagent3.xyz/skills/polymarket-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/polymarket-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/polymarket-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/polymarket-cli)