ChainGPT Polymarket Skill
You read live Polymarket prediction-market data on behalf of the user, and can build limit orders that the user's own wallet signs. The plugin never holds a key or signs.
This skill is the on-chain counterpart of ChainGPT's Foresight AI / PredictFi product surface — same domain (event-outcome markets), but live mainnet data rather than ChainGPT-curated commentary.
What this skill can do today
| Tool |
Purpose |
chaingpt_pm_markets |
Discover markets sorted by 24h volume, with full-text search |
chaingpt_pm_market |
Detail on one market by slug or condition id — outcomes, prices, token ids, volume |
chaingpt_pm_orderbook |
L2 orderbook for one outcome token |
chaingpt_pm_trades |
Recent fills on one outcome token |
chaingpt_pm_place_order_payload |
EIP-712 typed data for a limit order (needs acknowledgeMainnet: true) |
chaingpt_pm_submit_signed_order |
Post the signed order to the CLOB (needs the user's POLY_CLOB_* API credentials) |
Workflow: "what is the market saying about X?"
chaingpt_pm_markets search="<topic>" limit=5
│ (pick the most-liquid relevant one)
▼
chaingpt_pm_market slug="<from above>"
│ (read YES + NO token ids and current implied probabilities)
▼
chaingpt_pm_orderbook tokenId="<yes-token-id>"
│ (confirm there's actual depth at the touch — odds without size are vibes)
▼
chaingpt_pm_trades tokenId="<yes-token-id>"
│ (last 20 fills tell you which side is paying up)
Surfacing what matters
When summarizing a market, lead with:
- The question itself
- Current implied probability (
outcomePrices[0] for YES)
- 24h volume (is anyone actually trading this?)
- Days to resolution
- Top-of-book spread + depth (is the price tradeable in size?)
A YES price of 75% with $50 of size at the touch and $5/day volume is meaningless. A YES price of 75% with $50k at the touch and $1M/day volume is a real consensus.
Workflow: placing an order
Polymarket orders are real-money trades on Polygon mainnet. Confirm the market, the outcome token, side, price, size and wallet with the user first.
chaingpt_pm_place_order_payload with maker, tokenId, side, price, size, acknowledgeMainnet: true. It reads the token's live book for the signing domain (CTF / Neg-Risk / v2 exchange), tick size and minimum size, and refuses prices off the tick.
- Proxy or Safe wallet:
maker = the proxy, signer = the EOA, signatureType 1 or 2.
- Deposit wallet:
maker = the deposit wallet, signer = its owner EOA, signatureType 3.
- The user signs the returned typed data in their wallet (
eth_signTypedData_v4).
chaingpt_pm_submit_signed_order with the order object exactly as returned and the signature. GTD orders also pass orderType: "GTD".
What this skill does NOT do (yet)
- Cancel orders — use Polymarket's site or client.
- Resolve a held position (redeem after market closes) — same.
- Multi-outcome markets (categorical, not just YES/NO) — currently surfaced as outcome arrays, but UX is YES/NO-biased; will improve.
When to combine with other skills
- For ChainGPT's commentary layer (PredictFi / Foresight AI summary), check the existing
chaingpt_news_fetch filtered to "Prediction" categories.
- For wallet-level USDC balance on Polygon before betting —
chaingpt_wallet_balances chains=["polygon"].
- For risk-checking the Polymarket exchange contract or USDC.e —
chaingpt_risk_contract_source + chaingpt_risk_token.
Credit accounting
All Polymarket reads cost 0 ChainGPT credits — Gamma + CLOB APIs are free. The credit funnel for this skill comes from the upstream research + news calls users make around prediction-market decisions.
1---2name: polymarket3description: "Read live Polymarket prediction-market data via the ChainGPT plugin and build limit orders for the user's wallet to sign. Markets list / market details / orderbook / recent trades / EIP-712 CLOB orders on Polygon mainnet. Ties into ChainGPT's Foresight AI / PredictFi surface. Triggers: polymarket, prediction market, betting odds, election odds, will X happen, Foresight AI."4metadata:5 source: https://skillmd.com/skills/jiayaoqijia/polymarket6---78# ChainGPT Polymarket Skill910You read live Polymarket prediction-market data on behalf of the user, and can build limit orders that the user's own wallet signs. The plugin never holds a key or signs.1112This skill is the on-chain counterpart of ChainGPT's **Foresight AI / PredictFi** product surface — same domain (event-outcome markets), but live mainnet data rather than ChainGPT-curated commentary.1314## What this skill can do today1516| Tool | Purpose |17|---|---|18| `chaingpt_pm_markets` | Discover markets sorted by 24h volume, with full-text search |19| `chaingpt_pm_market` | Detail on one market by slug or condition id — outcomes, prices, token ids, volume |20| `chaingpt_pm_orderbook` | L2 orderbook for one outcome token |21| `chaingpt_pm_trades` | Recent fills on one outcome token |22| `chaingpt_pm_place_order_payload` | EIP-712 typed data for a limit order (needs `acknowledgeMainnet: true`) |23| `chaingpt_pm_submit_signed_order` | Post the signed order to the CLOB (needs the user's `POLY_CLOB_*` API credentials) |2425## Workflow: "what is the market saying about X?"2627```text28chaingpt_pm_markets search="<topic>" limit=529 │ (pick the most-liquid relevant one)30 ▼31chaingpt_pm_market slug="<from above>"32 │ (read YES + NO token ids and current implied probabilities)33 ▼34chaingpt_pm_orderbook tokenId="<yes-token-id>"35 │ (confirm there's actual depth at the touch — odds without size are vibes)36 ▼37chaingpt_pm_trades tokenId="<yes-token-id>"38 │ (last 20 fills tell you which side is paying up)39```4041## Surfacing what matters4243When summarizing a market, lead with:441. The question itself452. Current implied probability (`outcomePrices[0]` for YES)463. 24h volume (is anyone actually trading this?)474. Days to resolution485. Top-of-book spread + depth (is the price tradeable in size?)4950A YES price of 75% with $50 of size at the touch and $5/day volume is meaningless. A YES price of 75% with $50k at the touch and $1M/day volume is a real consensus.5152## Workflow: placing an order5354Polymarket orders are real-money trades on Polygon mainnet. Confirm the market, the outcome token, side, price, size and wallet with the user first.55561. `chaingpt_pm_place_order_payload` with `maker`, `tokenId`, `side`, `price`, `size`, `acknowledgeMainnet: true`. It reads the token's live book for the signing domain (CTF / Neg-Risk / v2 exchange), tick size and minimum size, and refuses prices off the tick.57 - Proxy or Safe wallet: `maker` = the proxy, `signer` = the EOA, `signatureType` 1 or 2.58 - Deposit wallet: `maker` = the deposit wallet, `signer` = its owner EOA, `signatureType` 3.592. The user signs the returned typed data in their wallet (`eth_signTypedData_v4`).603. `chaingpt_pm_submit_signed_order` with the order object exactly as returned and the signature. GTD orders also pass `orderType: "GTD"`.6162## What this skill does NOT do (yet)6364- **Cancel orders** — use Polymarket's site or client.65- **Resolve a held position** (redeem after market closes) — same.66- **Multi-outcome markets** (categorical, not just YES/NO) — currently surfaced as outcome arrays, but UX is YES/NO-biased; will improve.6768## When to combine with other skills6970- For ChainGPT's *commentary* layer (PredictFi / Foresight AI summary), check the existing `chaingpt_news_fetch` filtered to "Prediction" categories.71- For wallet-level USDC balance on Polygon before betting — `chaingpt_wallet_balances chains=["polygon"]`.72- For risk-checking the Polymarket exchange contract or USDC.e — `chaingpt_risk_contract_source` + `chaingpt_risk_token`.7374## Credit accounting7576All Polymarket reads cost 0 ChainGPT credits — Gamma + CLOB APIs are free. The credit funnel for this skill comes from the upstream research + news calls users make around prediction-market decisions.