dsh-polymarket-knowhow
DeepSeek Harness 插件：完整覆盖 Polymarket API——市场数据工具、经过身份验证的交易工具、WebSocket 流服务，以及内置的 Polymarket 知识技能
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:fashionmascherine-svg/dsh-polymarket-knowhow#b7f8d8ee78c6a5a02682e4775c2c997b38b90fc4Polymarket Knowhow 以 dsh-polymarket-knowhow 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness plugin that gives your agent complete, verified Polymarket superpowers: live market-data tools across every Polymarket API (Gamma, CLOB, Data API, Perps, Combos/RFQ, Bridge), opt-in authenticated trading tools, a WebSocket market-stream service, and a bundled knowhow skill distilled from the official docs — so the model never hallucinates endpoints, parameters or auth flows.
Built on the knowledge base of atompilot/polymarket-skill (MIT) and re-verified against the current official OpenAPI specs and live API responses.
| This plugin | Raw docs / MCP servers | |
|---|---|---|
Works offline for knowhow (bundled skill + polymarket_knowledge tool) | ✅ | ❌ |
| Live tools with typed schemas and bounded output | ✅ | partial |
| Covers auth flow end-to-end (L1 EIP-712 → L2 HMAC → builder headers) | ✅ | partial |
| New 2026 surfaces: Perps (56 ops) and Combos/RFQ | ✅ documented + read tools | scattered |
Endpoint drift corrected (volume24hr sorts, flat batch payloads, geoblock host, contract moves) | ✅ live-verified | ❌ |
Four independent Cordis rows (disable any of them by id in a later patch layer):
| Row id | Provides |
|---|---|
polymarket-service | ctx.polymarket service: one configured client per Polymarket API (Gamma, CLOB, Data, Perps, RFQ, Bridge, Relayer) with timeout/retry/geoblock-aware HTTP |
polymarket-tools | ~22 always-on market-data tools + opt-in account/trading tools + Perps tools + polymarket_knowledge |
polymarket-skills | Embedded runtime skill polymarket (16 knowledge modules as resources) via ctx.skills |
polymarket-stream | Optional market-channel WebSocket bridge emitting polymarket/market-event Cordis events |
polymarket_search, polymarket_events_list (offset + keyset pagination), polymarket_event_get, polymarket_markets_list, polymarket_market_get, polymarket_tags_listpolymarket_orderbook (single/batch), polymarket_price (single/batch), polymarket_quote (mid+spread+last in one call), polymarket_price_history, polymarket_token_info (tick size, neg-risk, token→market resolution)polymarket_positions, polymarket_trades_public, polymarket_activity, polymarket_holders, polymarket_leaderboard, polymarket_open_interest, polymarket_live_volume, polymarket_portfolio_valuepolymarket_geoblock_check, polymarket_combo_markets, polymarket_knowledgetrading.enabled + L2 credentials → polymarket_account_orders, polymarket_account_trades, polymarket_cancel_orders, polymarket_balance_allowance, polymarket_heartbeat, polymarket_api_keys, polymarket_place_order*perps.enabled + perps credentials → polymarket_perps_market_data, polymarket_perps_account* Order placement signs through the official @polymarket/clob-client SDK when it is resolvable (see Trading setup). Everything else uses zero-dependency Node crypto.
# From GitHub (pin a commit for reproducibility)
dsh plugin --profile my-profile add github:fashionmascherine-svg/dsh-polymarket-knowhow#<sha>
# From a local checkout
dsh plugin --profile my-profile add ./dsh-polymarket-knowhow
# From a tarball
pnpm pack && dsh plugin --profile my-profile add ./dsh-polymarket-knowhow-0.2.0.tgz
The package ships a self-contained prepare build. A git install fetches sources, so pnpm ≥10 asks you to allow the build once — copy the package key pnpm prints into your profile's pnpm-workspace.yaml:
allowBuilds:
dsh-polymarket-knowhow: true
Then boot: dsh --profile my-profile. All four rows activate; only safe read-only tools are visible unless you enable trading/perps.
The same repository is also a Claude Code plugin. It bundles:
polymarket skill — the 15 knowledge modules under skills/polymarket/references/ (generated from knowledge/, single source of truth);scripts/mcp-server.mjs) exposing the live market-data tools (search, events, orderbook, prices, quote, price history, positions, trades, leaderboard, open interest, perps market data, …). Trading/account tools are never exposed — the server is built with credentials resolution disabled and a denylist guard on top.Install from this repo's bundled marketplace:
/plugin marketplace add fashionmascherine-svg/dsh-polymarket-knowhow
/plugin install polymarket-knowhow@fashionmascherine-svg-polymarket
Or attach just the MCP server to any MCP client:
claude mcp add polymarket-knowhow -- node /path/to/dsh-polymarket-knowhow/scripts/mcp-server.mjs
The prebuilt lib/ is committed, so both paths work out of the box; after touching src/ run npm run build and commit the rebuilt lib/. After editing knowledge/*.md regenerate the skill copies with npm run sync:claude-skill.
Defaults are sensible (public endpoints, no credentials, trading off). Override any field from your profile's cordis.patch.yml:
- id: polymarket-service
config:
timeoutMs: 20000
maxRetries: 3
trading:
enabled: true
# Explicit creds… (or leave empty to read POLY_API_KEY / POLY_SECRET /
# POLY_PASSPHRASE / POLY_ADDRESS from the environment)
apiKey: ''
secret: ''
passphrase: ''
address: '' # funder/proxy wallet address
signatureType: 2 # 0 EOA · 1 POLY_PROXY · 2 GNOSIS_SAFE
perps:
enabled: false # reads POLYMARKET_PROXY / POLYMARKET_SECRET env
stream:
enabled: false
assetIds: [] # CLOB token ids to subscribe at startup
skills: true # register the embedded knowhow skill
- id: polymarket-stream
disabled: false # rows can be toggled individually
py-clob-client: ClobClient(host, key=pk, chain_id=137).create_or_derive_api_creds(), or@polymarket/clob-client into the profile and use its createOrDeriveApiKey().POLY_* environment variables.POLY_PRIVATE_KEY:dsh plugin --profile my-profile add @polymarket/clob-client
Read-only account tools (orders, trades, cancels, balances, heartbeat) work without the SDK — they sign requests with Node's built-in HMAC (L2 headers POLY_ADDRESS/SIGNATURE/TIMESTAMP/API_KEY/PASSPHRASE).
⚠️ Trading is real money. Heartbeats cancel all open orders after a >10s lapse; FOK/FAK BUY
amountis dollars, SELL is shares. Readknowledge/order-patterns.mdfirst.
export const inject = ['polymarket']
export function apply(ctx) {
const { gamma, clob, dataApi } = ctx.polymarket
const events = await ctx.polymarket.gamma.listEvents({ active: true, limit: 10 })
const book = await clob.getBook(tokenId)
ctx.on('polymarket/market-event', (event) => { /* stream.enabled */ })
}
SKILL.md (entry) · api-endpoints (full verified inventory) · authentication · order-patterns · market-data · websocket · concepts · ctf-operations · fees · bridge · gasless · error-codes · rate-limits · geoblock · perps · combos-rfq
Load via the skill tool (name: polymarket) or directly with polymarket_knowledge (topic or free-text search).
volume_24hr → 422), flat batch payloads (params wrapper returns []), /live-volume?id= (not ?event=), geoblock living on polymarket.com/api/geoblock, and moved exchange contract addresses.tests/unit (28 tests): hardcoded HMAC golden vectors, retry/Retry-After/error mapping over a local server, tool execution over stubbed fetch incl. cancel happy paths and failure propagation.tests/live (11 tests): production smoke tests against Gamma/CLOB/Data-API/Perps.npm test # unit suite (builds first)
npm run test:live # hits the real APIs, read-only
├── cordis.patch.yml # bundle patch: 4 plugin rows
├── src/
│ ├── http.ts # fetch + retry + geoblock error mapping
│ ├── config.ts # Schemastery schema + credential resolution
│ ├── gamma.ts # Gamma client ├── data.ts # Data API client
│ ├── clob.ts # CLOB client + L2 HMAC signing
│ ├── perps.ts # Perps client ├── extras.ts # Bridge/RFQ/Relayer/geoblock
│ ├── signing.ts # optional official-SDK order signing
│ ├── service.ts # PolymarketService (ctx.polymarket)
│ ├── tools.ts # all model tools
│ ├── skills.ts # runtime skill registration
│ └── stream.ts # WebSocket bridge
├── knowledge/ # 16 markdown modules (the "knowhow")
└── tests/{unit,live}/
See CLAUDE.md for agent-oriented development guidance.
MIT — see LICENSE and THIRD_PARTY_NOTICES.md.
Knowledge modules adapted from atompilot/polymarket-skill (MIT © atompilot), extended and corrected against current official documentation.