polymarket_skill

Overview

This skill provides comprehensive guidance for building with Polymarket, covering prediction markets, REST API trading, market data, and real-time WebSocket streaming. It helps you connect, subscribe, authenticate, and process live market events for production applications. Use it to implement trading strategies, monitor markets, and integrate Polymarket data into apps or LLMs. The content emphasizes practical setup, subscription patterns, and operational best practices.

How this skill works

The skill explains how to query Polymarket REST endpoints for market discovery, order placement, and portfolio management, and how to consume the real-time-data WebSocket client for live events. It details topic-based subscriptions (activity, comments, rfq, crypto_prices, clob_user, clob_market), filter usage, and authentication for private streams. Examples and patterns show subscription setup, initial data dumps on connect, message handling, and reconnection strategies. Reference guides cover API specifics, trading flows, and TypeScript client usage.

When to use it

• Building apps that surface prediction markets or resolutions
• Implementing trading bots or automated strategies
• Monitoring live trades, orderbook changes, and RFQ activity
• Streaming crypto prices or market comments to dashboards
• Integrating Polymarket data into analytics or LLM pipelines

Best practices

• Subscribe from onConnect and request initial data dumps to bootstrap state
• Apply filters and avoid broad wildcards to reduce data volume
• Implement reconnection and backoff logic; handle auth failures gracefully
• Process high-frequency messages asynchronously and validate payloads
• Unsubscribe from unused topics and batch updates where possible

Example use cases

• Real-time market dashboard that shows completed trades, last prices, and orderbook snapshots
• Automated trading agent that listens to price_change and trades topics to execute strategies
• Social monitoring tool that tracks event comments and reactions for sentiment signals
• Portfolio tracker that uses clob_user authenticated streams to reflect user orders and trades
• LLM-powered predictions that augment model inputs with live crypto price feeds and market events