SkillsAdd

cyl19970726/poly-sdk · Archived

polymarket-knowledge

Polymarket CLOB API knowledge base for order management, WebSocket events, and trading operations. Use when working with order lifecycle (place, fill, cancel), debugging WebSocket USER_TRADE/USER_ORDER events, understanding API field mappings, or implementing trading logic.

Installation

$ npx skills add cyl19970726/poly-sdk --skill polymarket-knowledge
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

grimoire-polymarket Similar · more installs
franalgaba/grimoire

Queries Polymarket market data and CLOB state, and manages CLOB orders via the Grimoire venue C…

11.9K installs
polymarket Similar · more installs
machina-sports/sports-skills

Polymarket sports prediction markets — read-only live odds, prices, order books, events, series…

1.2K installs
polymarket-api Similar · more installs
agentmc15/polymarket-trader

Deep integration guide for Polymarket's CLOB API, Gamma API, and on-chain data. Use when buildi…

962 installs
web3-polymarket Similar · more installs
polymarket/agent-skills

Polymarket integration for prediction market trading on Polygon. Covers authentication (L1 EIP-…

536 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

polymarket-plugin Similar name
okx/plugin-store

Trade prediction markets on Polymarket - buy outcome tokens (YES/NO and categorical markets), c…

490 installs
polymarket-analyzer Similar name
mjunaidca/polymarket-skills

Use this skill whenever the user wants to find trading opportunities, detect arbitrage, analyze…

474 installs
polymarket Similar name
2025emma/vibe-coding-cn

Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real…

432 installs
polymarket-prediction-market Similar name
axwelbrand-byte/arbibot

Understand Polymarket prediction markets for sports and esports betting. Use when working with …

387 installs
nansen-polymarket-deep-dive Similar name
nansen-ai/nansen-cli

Deep dive on a Polymarket market — OHLCV, orderbook, top holders, positions, trades, and PnL le…

374 installs
nansen-polymarket-trader-profile Similar name
nansen-ai/nansen-cli

What is a Polymarket trader betting on? Trades by address, PnL breakdown, and market context. U…

367 installs
More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 1.3K
License LICENSE
Default branch copy-trading
Open issues 12
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,365 B
  • docs SUMMARY.md 302 B

History

  1. First recorded snapshot · 32 installs

SKILL.md

Polymarket Knowledge

Overview

Comprehensive reference for Polymarket CLOB API integration, focusing on order management and real-time event handling.

Quick Reference

Order Types

Type Behavior Use Case
GTC Good Till Cancelled Maker orders, liquidity provision
GTD Good Till Date Time-limited orders
FOK Fill Or Kill Must fill completely or cancel
FAK Fill And Kill Fill what you can, cancel rest

Order Requirements

  • Minimum order value: $1 USDC
  • Minimum shares: 5
  • Tick size: 0.01 (prices must be 0.01, 0.02, ... 0.99)

Order State Machine

See [references/order-state-machine.md](references/order-state-machine.md) for complete state diagram and transitions.

States: PENDING → OPEN → PARTIALLY_FILLED → FILLED/CANCELLED/EXPIRED

API Status Mapping:

  • live → OPEN
  • matched (partial) → PARTIALLY_FILLED
  • matched (full) → FILLED
  • delayed → PENDING
  • cancelled → CANCELLED
  • expired → EXPIRED

WebSocket Events

See [references/websocket-events.md](references/websocket-events.md) for field mappings and examples.

Key Endpoints:

  • Market: wss://ws-subscriptions-clob.polymarket.com/ws/market
  • User: wss://ws-subscriptions-clob.polymarket.com/ws/user (authenticated)

USERORDER Event Types: PLACEMENT, UPDATE, CANCELLATION USERTRADE Statuses: MATCHED, MINED, CONFIRMED, RETRYING, FAILED

Common Pitfalls

  1. Wrong field names: API uses matchedamount not matchedsize, sizematched not matchedsize
  2. Wrong endpoint: USER events require /ws/user, not /ws/market
  3. USDC type: Polymarket uses USDC.e (bridged), not native USDC

Resources

  • [references/order-state-machine.md](references/order-state-machine.md) - State transitions and validation
  • [references/websocket-events.md](references/websocket-events.md) - WebSocket field mappings
  • [references/api-field-mappings.md](references/api-field-mappings.md) - API response field reference