Agent skill

Polymarket

by 2025Emma in 2025Emma/vibe-coding-cn

Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real-time WebSocket data streaming.

MITAuto-check passedBackend & APIs

Install Polymarket

skills CLI
$ npx skills add 2025Emma/vibe-coding-cn --skill polymarket -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 2025Emma/vibe-coding-cn polymarket --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/2025Emma/vibe-coding-cn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/i18n/zh/skills/polymarket .claude/skills/polymarket && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
polymarket
GitHub stars
23k
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
495 words
Files
12 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real-time WebSocket data streaming.

  • Tasks that involve Realtime and WebSockets
  • SKILL.md covers When to Use This Skill, Quick Reference, Reference Files and Key Features, plus 4 more sections
  • Calls npm
  • Tasks that involve Stock and market analysis

What it does

Polymarket is an agent skill from 2025Emma/vibe-coding-cn. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `references/README.md`, `references/api.md` and `references/getting_started.md`).

It sits in Backend & APIs, covering Realtime and WebSockets, Stock and market analysis and Trading and backtesting. It works with Polymarket. The licence is MIT.

When your agent uses it

  • Tasks that involve Realtime and WebSockets
  • Tasks that involve Stock and market analysis
  • Tasks that involve Trading and backtesting

Example prompts

  • “/polymarket”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 9b42dd1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • polymarket.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Polymarket loads about 1.6k tokens when it runs, and up to ~128k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 495 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~128k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 2025Emma/vibe-coding-cn at commit 9b42dd1, republished under its MIT licence (© 2025Emma). 495 words, ~1,567 tokens.

Download SKILL.mdSave it as .claude/skills/polymarket/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
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:

bash
npm install @polymarket/real-time-data-client

Basic Usage:

typescript
import { RealTimeDataClient } from "@polymarket/real-time-data-client";

const onMessage = (message: Message): void => {
    console.log(message.topic, message.type, message.payload);
};

const onConnect = (client: RealTimeDataClient): void => {
    client.subscribe({
        subscriptions: [{
            topic: "activity",
            type: "trades"
        }]
    });
};

new RealTimeDataClient({ onMessage, onConnect }).connect();
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
typescript
client.subscribe({
    subscriptions: [{
        topic: "clob_user",
        type: "*",
        clob_auth: {
            key: "your-api-key",
            secret: "your-api-secret",
            passphrase: "your-passphrase"
        }
    }]
});
Common Use Cases

Monitor Specific Market:

typescript
client.subscribe({
    subscriptions: [{
        topic: "activity",
        type: "trades",
        filters: `{"market_slug":"btc-above-100k-2024"}`
    }]
});

Track Multiple Markets:

typescript
client.subscribe({
    subscriptions: [{
        topic: "clob_market",
        type: "price_change",
        filters: `["100","101","102"]`
    }]
});

Monitor Event Comments:

typescript
client.subscribe({
    subscriptions: [{
        topic: "comments",
        type: "*",
        filters: `{"parentEntityID":12345,"parentEntityType":"Event"}`
    }]
});

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

Show full SKILL.md (181 more words)Show less

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

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!

© 2025Emma, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (references) in i18n/zh/skills/polymarket of 2025Emma/vibe-coding-cn.

  • SKILL.md
  • references/README.md
  • references/api.md
  • references/getting_started.md
  • references/guides.md
  • references/index.md
  • references/learn.md
  • references/llms-full.md
  • references/llms.md
  • references/other.md
  • references/realtime-client.md
  • references/trading.md

Open the folder on GitHubat commit 9b42dd1

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in 2025Emma/vibe-coding-cn, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Polymarket next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Polymarket compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polymarket this skill2025Emma/vibe-coding-cn23k1 repos~1.6kAutomated safety check: PassMIT
Web3 PolymarketPolymarket/agent-skills1911 repos~2kAutomated safety check: PassNone
Polymarket Tennislivetennisapi/livetennisapi-mcp152—~3kAutomated safety check: PassMIT
Feedsalsk1992/CloddsBot2.9k—~1.8kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle875—~5.9kAutomated safety check: PassMIT
Binance Datatoollostleaf/binance-datatool148—~2.5kAutomated safety check: NotesBSD-3-Clause

Similar skills

  • Web3 Polymarket

    Polymarket/agent-skills

    Polymarket integration for prediction market trading on Polygon.

    191 GitHub starsUsed in 1 repo~2k tokens
    Backend & APIsAuto-check passed
  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Feeds

    alsk1992/CloddsBot

    Real-time market data feeds from 8 prediction market platforms

    2.9k GitHub stars~1.8k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    875 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Binance Datatool

    lostleaf/binance-datatool

    Manage Binance historical market data from data.binance.vision using the binance-datatool CLI.

    148 GitHub stars~2.5k tokensUpdated 5 mo ago
    Backend & APIsAuto-check: notes
  • Real-time quotes, K-line charts, order book, trade ticks, intraday capital flow, market sentiment temperature, trading session schedule, security lists, exchange rates, and IPO calendar for…

    270 GitHub starsUsed in 1 repo~1.6k tokens
    Business, Finance & HRAuto-check passed

More from 2025Emma/vibe-coding-cn

All 13 skills in this repo
  • Claude Cookbooks Reference

    2025Emma/vibe-coding-cn

    Reference of Claude API examples and guides covering tool use, vision, RAG, classification, summarization, text-to-SQL, prompt caching and agent patterns.

    23k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Proxychains Network Fallback

    2025Emma/vibe-coding-cn

    Retries failed network commands through proxychains4 and a local proxy when it sees timeouts, DNS failures or blocked access.

    23k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check: notes
  • Skill Authoring and Refactoring

    2025Emma/vibe-coding-cn

    Builds new skills from scattered docs, specs or code, and refactors existing skills for clear triggers, reliable activation and a quality checklist.

    23k GitHub starsUsed in 2 repos~2k tokens
    Auto-check passed
  • CCXT Crypto Exchange Library

    2025Emma/vibe-coding-cn

    Reference help for the CCXT library covering crypto exchange APIs, market data, trading and order management across 150+ exchanges in JavaScript, Python and PHP.

    23k GitHub starsUsed in 1 repo~4.4k tokens
    Auto-check passed
  • CoinGecko API Reference

    2025Emma/vibe-coding-cn

    CoinGecko API documentation - cryptocurrency market data API, price feeds, market cap, volume, historical data. Use when integrating CoinGecko API, building…

    23k GitHub starsUsed in 1 repo~646 tokens
    Auto-check passed
  • Hummingbot Trading Bot Reference

    2025Emma/vibe-coding-cn

    Reference documentation for building, configuring and debugging automated trading strategies, market making and exchange connectors with Hummingbot.

    23k GitHub starsUsed in 1 repo~998 tokens
    Auto-check passed

Works with

Questions about Polymarket

What does Polymarket do?

Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real-time WebSocket data streaming. Polymarket is an agent skill from 2025Emma/vibe-coding-cn. Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real-time WebSocket data streaming.

When should I use Polymarket?

Polymarket fits situations like: tasks that involve Realtime and WebSockets; tasks that involve Stock and market analysis; tasks that involve Trading and backtesting.

How do I install Polymarket in Claude Code?

Run `npx skills add 2025Emma/vibe-coding-cn --skill polymarket -a claude-code`. Or copy the skill folder (i18n/zh/skills/polymarket in 2025Emma/vibe-coding-cn) into .claude/skills/polymarket in your project. Claude Code loads it when a task matches its description.

How do I install Polymarket in Codex?

Run `npx skills add 2025Emma/vibe-coding-cn --skill polymarket -a codex`. Or copy the skill folder (i18n/zh/skills/polymarket in 2025Emma/vibe-coding-cn) into .agents/skills/polymarket in your project. Codex loads it when a task matches its description.

Can I use Polymarket in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 2025Emma/vibe-coding-cn --skill polymarket -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/polymarket, .gemini/skills/polymarket, .github/skills/polymarket and .opencode/skills/polymarket in your project.

What does Polymarket need to run?

Going by SKILL.md and its folder, Polymarket needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Polymarket access the network?

SKILL.md names 2 domains. As links in the text: polymarket.com and github.com. This is read from the text; nothing was executed.

Is Polymarket safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Polymarket use?

Polymarket is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Polymarket use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 127k tokens, read only when the agent opens those files.

What are the alternatives to Polymarket?

Skills that share tags, products or a category with Polymarket: Web3 Polymarket (Polymarket/agent-skills, 191 stars), Polymarket Tennis (livetennisapi/livetennisapi-mcp, 152 stars), Feeds (alsk1992/CloddsBot, 2.9k stars) and Digital Oracle (komako-workshop/digital-oracle, 875 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polymarket?

2025Emma (a GitHub user) maintains it in 2025Emma/vibe-coding-cn, which has 23,035 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on December 17, 2025.

Source: 2025Emma/vibe-coding-cn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.