playbooks

home / skills / openclaw / skills / polymarket

polymarket skill

/skills/mvanhorn/polymarket

This skill queries Polymarket to fetch trending markets, search events, and monitor odds via Gamma API for quick market insights.

npx playbooks add skill openclaw/skills --skill polymarket

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
1.4 KB
---
name: polymarket
description: Query Polymarket prediction markets - check odds, trending markets, search events, track prices.
homepage: https://polymarket.com
metadata: {"clawdbot":{"emoji":"📊"}}
---

# Polymarket

Query [Polymarket](https://polymarket.com) prediction markets. Check odds, find trending markets, search events.

## Commands

```bash
# Trending/active markets
python3 {baseDir}/scripts/polymarket.py trending

# Search markets
python3 {baseDir}/scripts/polymarket.py search "trump"
python3 {baseDir}/scripts/polymarket.py search "bitcoin"

# Get specific market by slug
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"

# Get markets by category
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
```

## Example Chat Usage

- "What are the odds Trump wins 2028?"
- "Trending on Polymarket?"
- "Search Polymarket for Bitcoin"
- "What's the spread on the Fed rate decision?"
- "Any interesting crypto markets?"

## Output

Markets show:
- Question/title
- Current odds (Yes/No prices)
- Volume
- End date

## API

Uses the public Gamma API (no auth required for reading):
- Base URL: `https://gamma-api.polymarket.com`
- Docs: https://docs.polymarket.com

## Note

This is read-only. Trading requires wallet authentication (not implemented).

Overview

This skill lets you query Polymarket prediction markets to check odds, find trending markets, search events, and track prices. It provides a read-only interface to fetch market titles, Yes/No prices, volume, and end dates. Designed for quick lookup and monitoring without any trading or wallet integration.

How this skill works

The skill calls Polymarket's public Gamma API to retrieve market data and formats results for easy reading. Commands support fetching trending/active markets, searching by keyword, retrieving a market by slug, and listing markets by category. Responses include question/title, current odds (Yes/No), trading volume, and market end date.

When to use it

  • Get current odds for a specific political, crypto, or sports event.
  • Monitor trending or high-volume markets on Polymarket.
  • Search for markets related to a person, asset, or topic.
  • Quickly check the settlement or end date for a market.
  • Ingest market snapshots for research or reporting (read-only).

Best practices

  • Use concise keywords when searching to reduce irrelevant matches.
  • Fetch trending first to discover high-liquidity markets worth tracking.
  • Store returned slugs for reproducible lookups and automation.
  • Respect rate limits of the public Gamma API and cache frequent queries.
  • Remember this skill is read-only; trading requires separate wallet authentication.

Example use cases

  • Ask for trending markets to spot sudden shifts in public sentiment.
  • Search for "bitcoin" to see current crypto-related prediction odds.
  • Retrieve the market for a specific event slug to get exact prices and end date.
  • Check the spread on a Fed decision market before writing an analysis piece.
  • Build a dashboard that polls several market slugs for time-series price tracking.

FAQ

Does this skill allow placing trades?

No. The skill is read-only and does not support wallet authentication or trading.

Which API does the skill use?

It uses Polymarket's public Gamma API (no auth required for read operations).

What market fields are returned?

Typical responses include the question/title, Yes/No prices (odds), volume, and end date.