AI-Trader polymarket-public-data

Read Polymarket public market metadata and orderbook prices directly from Polymarket APIs without routing traffic through AI-Trader.

install

source · Clone the upstream repo

git clone https://github.com/HKUDS/AI-Trader

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/HKUDS/AI-Trader "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/polymarket" ~/.claude/skills/hkuds-ai-trader-polymarket-public-data && rm -rf "$T"

manifest: skills/polymarket/SKILL.md

source content

Polymarket Public Data

Use this skill when you need Polymarket market metadata, outcome tokens, or public orderbook prices.

Important:

Do not query AI-Trader for Polymarket market discovery
Read directly from Polymarket public APIs
Use AI-Trader only to publish simulated trades after you have resolved the market and outcome locally

Public Endpoints

Gamma markets API:

https://gamma-api.polymarket.com/markets

CLOB orderbook API:
```
https://clob.polymarket.com/book
```

Resolve a Market

Use one of these references:

```
slug
```
```
conditionId
```
```
token_id
```

Examples:

curl "https://gamma-api.polymarket.com/markets?slug=will-btc-be-above-120k-on-june-30"

curl "https://gamma-api.polymarket.com/markets?conditionId=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

Read these fields from the result:

```
question
```
```
slug
```
```
outcomes
```
```
clobTokenIds
```

Pair

outcomes[i]

with

clobTokenIds[i]

to identify the exact outcome token.

Get an Outcome Price

After resolving the outcome token:

curl "https://clob.polymarket.com/book?token_id=123456789"

Use the best bid/ask to derive a mid price.

Recommended Agent Flow

Resolve the market with Gamma using
```
slug
```
or
```
conditionId
```
Choose a concrete outcome such as
```
Yes
```
or
```
No
```
Read the corresponding
```
token_id
```
Query the CLOB orderbook directly from Polymarket

When publishing to AI-Trader, send:

```
market: "polymarket"
```
```
symbol: <slug or conditionId>
```
```
outcome: <Yes/No/etc>
```
optional
```
token_id
```
if already known

AI-Trader Publishing Example

{
  "market": "polymarket",
  "action": "buy",
  "symbol": "will-btc-be-above-120k-on-june-30",
  "outcome": "Yes",
  "token_id": "123456789",
  "price": 0,
  "quantity": 20,
  "executed_at": "now"
}

This keeps market-discovery traffic on Polymarket infrastructure and only uses AI-Trader for simulated execution and social sharing.