polymarket-skill-router

Polymarket Skill Router

Overview

This skill acts as a central decision engine to route developer and trading agent queries to the correct specialized Polymarket skill. In order to optimize context efficiency and prevent errors, agents must choose the most narrow, relevant skill.

Dependencies

None.

Routing Workflow

Evaluate the user's task and match it against the following decision tree:

graph TD
    A[User Polymarket Task] --> B{What is the task?}
    B -->|Public Info / Market Slugs / SDK Setup| C[polymarket-general]
    B -->|Place Limit/Market Orders, Cancel Orders| D[polymarket-order-execution]
    B -->|Real-Time WS Feeds / Best Bid & Ask| E[polymarket-websocket-sync]
    B -->|Gasless Proxy Wallet / Safe Approvals| F[polymarket-deposit-wallet-eip1271]
    B -->|Rate Limits / HTTP 429/425/503 / Retries| G[polymarket-api-rate-limits-errors]
    B -->|Polygon Contracts / web3.py / pUSD Balance| H[polymarket-onchain-contracts]

Specialized Skill Selection Details

1. polymarket-general

   • Use when: Initializing AsyncPublicClient / AsyncSecureClient, looking up a market slug to resolve token IDs, or querying basic tick sizes.

2. polymarket-order-execution

   • Use when: Placing GTC/GTD limit orders, FOK/FAK market orders, checking outcome balances, adjusting price to conform to minimum tick size, or canceling open orders.

3. polymarket-websocket-sync

   • Use when: Setting up real-time pricing feeds using MarketSpec, streaming wallet execution events via UserSpec, handling keepalive heartbeats, or implementing a REST fallback engine.

4. polymarket-deposit-wallet-eip1271

   • Use when: Deploys smart-contract Proxy/Safe deposit wallets, configuring Relayer or Builder API keys, registering EIP-1271 / Signature Type 3 trading approvals on-chain.

5. polymarket-api-rate-limits-errors

   • Use when: Writing request wrappers with exponential backoff, handling Cloudflare 429 errors, matching engine restart modes (425 post-only or 503 cancel-only), and troubleshooting CLOB error strings.

6. polymarket-onchain-contracts

   • Use when: Interacting directly on Polygon using web3.py, querying pUSD/USDC balances directly, reading/setting ERC20 allowances, querying the UMA Adapter or CTF Exchange addresses, and tuning EIP-1559 gas fees.

Common Mistakes

1. Routing to the Wrong Domain: Attempting to handle rate-limiting details inside on-chain contract code, or hardcoding addresses inside the general client setup.
2. Ignoring Pre-existing Code: Re-implementing CLI commands or order execution loops instead of referencing the central helper script (scripts/polymarket_client_helper.py).