home / skills / openclaw / skills / polymarket-trader

polymarket-trader skill

safe

/skills/zbruceli/unifai-trading-suite/skills/polymarket-trader

This skill retrieves trending, crypto, politics, and other Polymarket markets and prices to help you make informed predictions.

npx playbooks add skill openclaw/skills --skill polymarket-trader

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

Files (2)

SKILL.md

2.7 KB

---
name: polymarket-trader
description: Query Polymarket prediction markets - trending events, crypto, politics, sports, and search
homepage: https://polymarket.com
user-invocable: true
metadata: {"moltbot":{"emoji":"🔮","requires":{"env":["UNIFAI_AGENT_API_KEY","GOOGLE_API_KEY"]},"primaryEnv":"UNIFAI_AGENT_API_KEY"}}
---

# Polymarket Trader

Query Polymarket, the leading decentralized prediction market on Polygon blockchain.

## About Polymarket

Polymarket is a decentralized prediction market platform where users can trade on the outcomes of real-world events. It operates on the Polygon blockchain using USDC.e for settlements.

## Commands

### Trending Events
```bash
python3 {baseDir}/scripts/polymarket.py trending
```
Get currently trending prediction events.

### Crypto Markets
```bash
python3 {baseDir}/scripts/polymarket.py crypto
```
Get cryptocurrency-related prediction markets.

### Politics Markets
```bash
python3 {baseDir}/scripts/polymarket.py politics
```
Get political prediction markets.

### Search Markets
```bash
python3 {baseDir}/scripts/polymarket.py search "<query>"
```
Search markets by keyword.

### Category Markets
```bash
python3 {baseDir}/scripts/polymarket.py category <name>
```
Get markets by category (trending, new, politics, crypto, tech, culture, sports, world, economy).

## Output Format

Results include:
- Event/market title
- YES/NO prices (probability)
- Trading volume
- Liquidity
- End date

## Categories

| Category | Description |
|----------|-------------|
| trending | Most popular markets |
| new | Recently created markets |
| politics | Political events and elections |
| crypto | Cryptocurrency predictions |
| tech | Technology sector events |
| culture | Entertainment and culture |
| sports | Sports outcomes |
| world | Global events |
| economy | Economic indicators |

## Example Usage

**User**: "What's trending on Polymarket?"

**Assistant**: I'll fetch the trending events from Polymarket.

```bash
python3 {baseDir}/scripts/polymarket.py trending
```

**User**: "Search for Bitcoin markets"

**Assistant**: Let me search Polymarket for Bitcoin-related markets.

```bash
python3 {baseDir}/scripts/polymarket.py search "bitcoin"
```

## Requirements

- `UNIFAI_AGENT_API_KEY` - UnifAI SDK key for Polymarket tools
- `GOOGLE_API_KEY` - Gemini API key for LLM processing

## API Information

- **Data Source**: UnifAI Polymarket tools (toolkit ID: 127)
- **Available Tools**: search, getEventsByCategory, getPrices, getOrderBooks
- **Rate Limits**: UnifAI API rate limits apply

## Notes

- This tool is read-only (trading requires wallet authentication)
- Prices shown as decimals (0.75 = 75% probability)
- Markets settle on Polygon blockchain
- USDC.e used for trading
- Not available in restricted jurisdictions

Overview

This skill queries Polymarket, a decentralized prediction market on Polygon, to surface trending events, category-specific markets, and search results. It returns market titles, YES/NO prices as probabilities, trading volume, liquidity, and end dates. The skill is read-only and designed for monitoring markets, research, and idea discovery. Trading is not supported by this tool and requires a wallet and authentication.

How this skill works

The skill calls UnifAI Polymarket tools to fetch events, prices, and order book data. You can request trending, category filters (crypto, politics, sports, etc.), or free-text searches to locate markets. Results are normalized to show probability decimals, volume, liquidity, and settlement details. API rate limits and required environment keys apply.

When to use it

Monitor which prediction markets are currently trending or gaining attention
Find crypto, politics, sports, or economy markets by category
Search for markets related to a specific topic or keyword
Collect market probability snapshots for research or reporting
Check market end dates and liquidity before considering participation (offline)

Best practices

Use category or trending commands to quickly surface high-activity markets
Supply precise keywords for the search command to reduce irrelevant results
Treat returned probabilities as informational — this skill is read-only
Watch volume and liquidity to assess market depth before acting
Respect API rate limits and keep environment API keys secure

Example use cases

Fetch currently trending Polymarket events to include in a daily newsletter
Search for Bitcoin or Ethereum-related markets to track crypto sentiment
List political markets ahead of an election to monitor shifting probabilities
Pull sports markets and their end dates to align with event schedules
Query economy or world categories for macro research inputs

FAQ

Can this skill place trades on Polymarket?

No. The skill is read-only and only returns market data. Trading requires a wallet and separate authenticated tools.

What output format does the skill provide?

Results include market title, YES/NO prices as decimal probabilities, trading volume, liquidity, and end date.

What keys or credentials are required?

You must set UNIFAI_AGENT_API_KEY for Polymarket tools and GOOGLE_API_KEY for LLM processing where applicable.