dsh-polymarket-knowhow

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.

Why this plugin

	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	❌

Capabilities

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

Model tools (always registered)

• Discovery: polymarket_search, polymarket_events_list (offset + keyset pagination), polymarket_event_get, polymarket_markets_list, polymarket_market_get, polymarket_tags_list
• CLOB data: polymarket_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)
• Data API: polymarket_positions, polymarket_trades_public, polymarket_activity, polymarket_holders, polymarket_leaderboard, polymarket_open_interest, polymarket_live_volume, polymarket_portfolio_value
• Meta: polymarket_geoblock_check, polymarket_combo_markets, polymarket_knowledge

Opt-in tools (registered only when configured)

• trading.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.

Install

# From GitHub (pin a commit for reproducibility)
dsh plugin --profile my-profile add github:fashionmascherine-svg/dsh-polymarket-knowhow#<sha>

…