polymarket
Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real-time WebSocket data streaming. Build applications with Polymarket services, monitor live trades, and integrate market predictions.
By 2025emma · 433 installs
npx skills add 2025emma/vibe-coding-cn --skill polymarket
Source repository · Upstream listing
TRANSLATED CONTENT:
name: polymarket
description: Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real time WebSocket data streaming. Build applications with Polymarket services, monitor live trades, and integrate market predictions.
Polymarket Comprehensive Skill
Complete assistance with Polymarket development covering the full platform (API, trading, market data) and the real time data streaming client (WebSocket subscriptions for live market activity).
When to Use This Skill
This skill should be triggered when:
Platform & API:
Working with Polymarket prediction markets
Using Polymarket API for market data
Implementing trading strategies
Building applications with Polymarket services
Learning Polymarket best practices
Real Time Data Streaming:
Connecting to Polymarket's WebSocket service
Building prediction market monitoring tools
Processing live trades, orders, and market updates
Monitoring market comments and social reactions
Tracking RFQ (Request for Quote) activity
Integrating crypto price feeds
Quick Reference
Real Time Data Client Setup
Installation:
Basic Usage:
Supported WebSocket Topics
1. Activity ( activity )
trades Completed trades
orders matched Order matching events
Filters: {"event slug":"string"} OR {"market slug":"string"}
2. Comments ( comments )
comment created , comment removed
reaction created , reaction removed
Filters: {"parentEntityID":number,"parentEntityType":"Event"}
3. RFQ ( rfq )
Request/Quote lifecycle events
No filters, no auth required
4. Crypto Prices ( crypto prices , crypto prices chainlink )
update Real time price feeds
Filters: {"symbol":"BTC"} (optional)
5. CLOB User ( clob user ) ⚠️ Requires Auth
order User's order updates
trade User's trade executions
6. CLOB Market ( clob market )
price change Price movements
agg orderbook Aggregated order book
last trade price Latest prices
market created , market resolved
Authentication for User Data
Common Use Cases
Monitor Specific Market:
Track Multiple Markets:
Monitor Event Comments:
Reference Files
This skill includes comprehensive documentation in references/ :
Platform Documentation:
api.md Polymarket API documentation
getting started.md Getting started guide
guides.md Development guides
learn.md Learning resources
trading.md Trading documentation
other.md Additional resources
Real Time Client:
README.md WebSocket client API and examples
llms.md LLM integration guide
llms full.md Complete LLM documentation
Use view to read specific reference files for detailed information.
Key Features
Platform Capabilities:
✅ Prediction market creation and resolution
✅ Trading API (REST & WebSocket)
✅ Market data queries
✅ User portfolio management
✅ Event and market discovery
Real Time Streaming:
✅ WebSocket based persistent connections
✅ Topic based subscriptions
✅ Dynamic subscription management
✅ Filter support for targeted data
✅ User authentication for private data
✅ TypeScript with full type safety
✅ Initial data dumps on connection
Best Practices
WebSocket Connection Management
Use onConnect callback for subscriptions
Implement reconnection logic for production
Clean up with disconnect() when done
Handle authentication errors gracefully
Subscription Strategy
Use wildcards ( " " ) sparingly
Apply filters to reduce data volume
Unsubscribe from unused streams
Process messages asynchronously
Performance
Consider batching high frequency data
Use filters to minimize client processing
Validate message payloads before use
Requirements
Node.js : 14+ recommended
TypeScript : Optional but recommended
Package Manager : npm or yarn
Resources
Official Links
Polymarket Platform : https://polymarket.com
Real Time Client Repo : https://github.com/Polymarket/real time data client
API Documentation : See references/api.md
Working with This Skill
For Beginners:
Start with getting started.md for foundational concepts.
For API Integration:
Use api.md and trading.md for REST API details.
For Real Time Data:
Use README.md for WebSocket client implementation.
For LLM Integration:
Use llms.md and llms full.md for AI/ML use cases.
Notes
Real Time Client is TypeScript/JavaScript (not Python)
Some WebSocket topics require authentication
Use filters to manage message volume effectively
All timestamps are Unix timestamps
Market IDs are strings (e.g., "100", "101")
Platform documentation covers both REST API and WebSocket usage
This comprehensive skill combines Polymarket platform expertise with real time data streaming capabilities!