AgentSkillsCN

pm-alpha

Polymarket 预测市场 CLI。查询市场、价格、事件、订单簿、交易。当用户希望与 Polymarket 数据互动时，可使用此功能。

SKILL.md
--- frontmatter
name: pm-alpha
description: "Polymarket prediction market CLI. Query markets, prices, events, orderbooks, trades. Use when user wants to interact with Polymarket data."
homepage: https://github.com/yongkangc/pm-alpha
metadata: {"clawdhub":{"emoji":"📊"}}

pm-alpha

Polymarket prediction market CLI skill for OpenClaw agents.

Prerequisites

Install CLI

bash
cd ~/.openclaw/workspace/skills/pm-alpha
uv tool install .

Or for development:

bash
uv pip install -e .

Commands

List Markets

bash
# List active markets by volume
polymarket markets

# Include closed markets
polymarket markets --closed

# Limit results
polymarket markets -n 10

# Output as JSON
polymarket markets --json

# Output as markdown table
polymarket markets -m

Get Market Details

bash
# By ID
polymarket market 12345

# By slug
polymarket market bitcoin-price-above-100k

Search Markets

bash
# Keyword search
polymarket search "bitcoin"

# Include closed
polymarket search "election" --closed

# With JSON output
polymarket search "crypto" --json

Trending Markets

bash
# By 24h volume
polymarket trending

# Top 10
polymarket trending -n 10

Events

bash
# List events (groups of related markets)
polymarket events

# Get event details
polymarket event 12345
polymarket event event-slug

Prices

bash
# Current price for a token
polymarket price <token-id>

# Price history
polymarket history <token-id>
polymarket history <token-id> --interval 1d
polymarket history <token-id> --interval max

Orderbook

bash
# Get orderbook for a token
polymarket book <token-id>

Trades

bash
# Recent trades for a market (uses condition ID)
polymarket trades <condition-id>

Raw API Calls

bash
# Gamma API (market discovery)
polymarket raw /markets --api gamma

# CLOB API (prices/trading)
polymarket raw /price --api clob --params "token_id=123"

Output Formats

Most commands support:

  • •Default: Rich colored terminal output with tables
  • •--json: Raw JSON for parsing
  • •--markdown, -m: Markdown table format

API Reference

  • •Gamma API (https://gamma-api.polymarket.com): Market discovery, metadata, events
  • •CLOB API (https://clob.polymarket.com): Prices, orderbooks, trading

See https://docs.polymarket.com/ for full documentation.

Examples

Find markets about Bitcoin:

bash
polymarket search "bitcoin" -n 10

Get details on a specific market:

bash
polymarket market 12345

Check current price:

bash
polymarket price <token-id>

View orderbook depth:

bash
polymarket book <token-id>

Export trending markets as markdown:

bash
polymarket trending -n 20 -m

Notes

  • •No authentication required for read-only operations
  • •Trade data may require authentication
  • •Token IDs are found in market details (use polymarket market <id> --json)
  • •This skill is read-only (no trading functionality)