| name | dpro-polymarket |
| description | Polymarket prediction market trading and data skill. Use this skill whenever the user wants to query, trade, or manage positions on Polymarket — including searching prediction markets, getting YES/NO prices, viewing order books, placing buy/sell orders, checking balances and positions, managing open orders, or setting up Polymarket accounts. Trigger for phrases like "polymarket", "prediction market", "buy yes", "buy no", "market odds", "dpro-pm", or any request involving Polymarket trading or data. |
| compatibility | Requires Node.js 18+, network access to Polymarket APIs (clob.polymarket.com, gamma-api.polymarket.com). Run `npm install` in the skill directory before first use. |
dpro-polymarket
Polymarket prediction market skill — query markets, manage accounts, and trade YES/NO shares.
Quick Start
dpro-pm search <query> Search prediction markets
dpro-pm quote <slug> YES/NO prices for a market
dpro-pm book <token-id> Order book depth
dpro-pm trending Trending markets
dpro-pm event <slug> Event with all markets
dpro-pm account ls List configured accounts
dpro-pm account add <privateKey> [alias] Add account (encrypts key)
dpro-pm account remove <alias> Remove account
dpro-pm account show Show default account
dpro-pm balance USDC.e balance
dpro-pm positions Open positions
dpro-pm orders Open orders
dpro-pm history Trade history
dpro-pm buy <slug> yes <amount> [<price>] Buy YES shares (limit or market)
dpro-pm buy <slug> no <amount> [<price>] Buy NO shares
dpro-pm sell <slug> yes <amount> [<price>] Sell YES shares
dpro-pm sell <slug> no <amount> [<price>] Sell NO shares
dpro-pm cancel <orderId> Cancel an order
dpro-pm cancel-all [<conditionId>] Cancel all open orders
Entry Point
The skill is invoked via scripts/entry.mjs which exports runPolymarketSkill(rawInput, runtimeContext).
import { runPolymarketSkill } from './scripts/entry.mjs';
const result = await runPolymarketSkill('dpro-pm search bitcoin', {});
console.log(result);
Command Reference
Market Data (no auth required)
| Command | Description |
|---|
search <query> | Search markets by keyword |
quote <slug> | YES/NO prices, volume, liquidity |
book <token-id> | Full order book (top 10 levels) |
trending | Trending markets by volume |
event <slug> | Event info with all sub-markets |
Account Management
| Command | Description |
|---|
account add <privateKey> [alias] | Add account (encrypts private key with password) |
account add-readonly <address> [alias] | Add read-only account (no trading) |
account ls | List all configured accounts |
account remove <alias> | Remove account |
account show | Show default account info |
account set-default <alias> | Set default account |
Account Queries (requires account)
| Command | Description |
|---|
balance | USDC.e balance |
positions | Open positions with P&L |
orders | Open orders |
history [--limit N] | Recent trade history |
Trading (requires API account)
| Command | Description |
|---|
buy <slug> yes|no <amount> [<price>] | Buy outcome shares |
sell <slug> yes|no <amount> [<price>] | Sell outcome shares |
cancel <orderId> | Cancel a specific order |
cancel-all [<conditionId>] | Cancel all orders (optional: for one market) |
Order types:
- With
<price>: limit GTC order (rests on book until filled or cancelled)
- Without
<price>: market order (FOK — fill entirely or cancel)
Flags:
--type gtc|gtd|fok|fak — override order type--expires <timestamp> — expiry for GTD orders (unix seconds)--account <alias> — use specific account (default: default account)--password <pwd> — account password (or set env DPRO_PM_PASSWORD)--json — output raw JSON
Account Setup
Polymarket uses two-layer authentication:
- L1 (wallet): EIP-712 signature with your private key → derives API credentials
- L2 (HMAC): API key + secret + passphrase → signs trading requests
The account add command handles both:
- Encrypts the private key with your password
- On first trade, derives API credentials automatically and stores them
Setup workflow:
1. Get private key from Polymarket (polymarket.com/settings → export key)
2. dpro-pm account add <0x-private-key> myaccount --password <yourpassword>
3. dpro-pm balance ← verifies connection
4. dpro-pm buy will-bitcoin-hit-100k yes 10 0.65
Important:
- Signature type 2 (GNOSIS_SAFE proxy) is used by default — correct for Polymarket.com accounts
- The funder address is the proxy wallet address visible at polymarket.com/settings
- If you exported your key via MetaMask (not Polymarket), use
--sig-type 0 (EOA)
Market Identifiers
Polymarket markets can be referenced by:
- Slug:
will-bitcoin-hit-100k-in-2024 (human-readable, used in URLs)
- Condition ID:
0x1234... (hex, unique per market)
- Token ID: long integer string (per outcome — YES and NO have different IDs)
For quote, buy, sell: use slug or condition ID (skill resolves to token IDs automatically)
For book: use token ID directly
API Endpoints
| API | Base URL | Auth |
|---|
| CLOB | https://clob.polymarket.com | L2 for trades |
| Gamma | https://gamma-api.polymarket.com | None |
| Data | https://data-api.polymarket.com | None |
Contract Addresses (Polygon)
| Contract | Address |
|---|
| USDC.e | 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 |
| CTF | 0x4D97DCd97eC945f40cF65F87097ACe5EA0476045 |
| CTF Exchange | 0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E |
| Neg Risk CTF Exchange | 0xC5d563A36AE78145C45a50134d48A1215220f80a |
Safety Policy
- Read operations (search, quote, book, trending): always safe, no confirmation needed
- Account setup (account add): confirm private key is being encrypted before storage
- Trading (buy/sell): always show order summary and require confirmation before submitting
- Show: market name, outcome, amount, price (or estimated market price), estimated cost
- Confirm explicitly before calling POST /orders
- Cancel: confirm before cancelling unless user says "just cancel"
Reference Files
Load on demand:
references/markets.md — Gamma API details, market/event structure, search paramsreferences/trading.md — Order types, signing, tick sizes, negative risk marketsreferences/auth.md — L1/L2 auth details, credential lifecycle, signature types
