polymarket public data
- Repo stars 19,128
- Author repo AI-Trader
- Domain
- Data
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @HKUDS · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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"
}
# 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:
```bash
curl "https://gamma-api.polymarket.com/markets?slug=will-btc-be-above-120k-on-june-30"
```
```bash
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:
```bash
curl "https://clob.polymarket.com/book?token_id=123456789"
```
Use the best bid/ask to derive a mid price.
## Recommended Agent Flow
1. Resolve the market with Gamma using `slug` or `conditionId`
2. Choose a concrete outcome such as `Yes` or `No`
3. Read the corresponding `token_id`
4. Query the CLOB orderbook directly from Polymarket
5. 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
```json
{
"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.
Sections and files
Listed in source order.
sections -> Public Endpoints → Resolve a Market → Get an Outcome Price → Recommended Agent Flow → AI-Trader Publishing Example
terms -> Use this skill when you need Polymarket market metadata, outcome tokens, or public orderbook prices. · Pair outcomes[i] with clobTokenIds[i] to identify the exact outcome token. · Use the best bid/ask to derive a mid price. · 1. Resolve the market with Gamma using slug or conditionId 2. · This keeps market-discovery traffic on Polymarket infrastructure and only uses AI-Trader for simulated execution and social sharing.
files/cmd -> https://gamma-api.polymarket.com/markets · https://clob.polymarket.com/book · slug · conditionId · token_id · question · outcomes · clobTokenIds
body sha256 -> 18f82a4e28ce
Public Endpoints
Gamma markets API:
https://gamma-api.polymarket.com/marketsCLOB orderbook API:https://clob.polymarket.com/bookResolve a Market
Use one of these references:
slugconditionIdtoken_idExamples:Get an Outcome Price
After resolving the outcome token: Use the best bid/ask to derive a mid price.
Recommended Agent Flow
Resolve the market with Gamma using
slugorconditionIdChoose a concrete outcome such asYesorNoRead the correspondingtoken_idQuery the CLOB orderbook directly from Polymarket When publishing to AI-Trader, send:AI-Trader Publishing Example
This keeps market-discovery traffic on Polymarket infrastructure and only uses AI-Trader for simulated execution and social sharing.