Agent skill

Polymarket Public Data Lookup

by HKUDS in HKUDS/AI-Trader

Looks up Polymarket market details and orderbook prices straight from Polymarket's public APIs and resolves outcome tokens for later simulated trades.

No licenceAuto-check passedBusiness, Finance & HR

Install Polymarket Public Data Lookup

skills CLI
$ npx skills add HKUDS/AI-Trader --skill polymarket-public-data -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUDS/AI-Trader polymarket-public-data --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUDS/AI-Trader.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/polymarket .claude/skills/polymarket-public-data && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
polymarket-public-data
GitHub stars
23k
Token cost
~536 tokens
SKILL.md length
184 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
None found

At a glance

Looks up Polymarket market details and orderbook prices straight from Polymarket's public APIs and resolves outcome tokens for later simulated trades.

  • Works in 5 steps: Resolve the market with Gamma using slug… → Choose a concrete outcome such as Yes or… → Read the corresponding token_id → …
  • Looking up a Polymarket market by slug or condition ID
  • SKILL.md covers Public Endpoints, Resolve a Market, Get an Outcome Price and Recommended Agent Flow, plus 1 more section
  • Calls curl; reaches gamma-api.polymarket.com and clob.polymarket.com

What it does

The agent resolves a market by slug, condition ID or token ID against the Polymarket Gamma markets API, then reads the question, slug, outcomes and CLOB token IDs from the result. Each outcome is paired with its token ID by position, so Yes and No map to exact tokens.

With a token ID it queries the CLOB orderbook endpoint and derives a mid price from the best bid and ask. The skill insists on reading market data directly from Polymarket rather than through AI-Trader, which is used only afterward to publish simulated trades once the market and outcome have been resolved locally. The publishing step sends the market type, a symbol, the outcome and an optional token ID.

When your agent uses it

  • Looking up a Polymarket market by slug or condition ID
  • Finding the token ID behind a Yes or No outcome
  • Reading the best bid, ask and mid price for an outcome
  • Preparing a simulated trade entry for AI-Trader

Example prompts

  • “Look up the Polymarket market with slug will-btc-be-above-120k-on-june-30 and list its outcomes.”
  • “What is the current mid price of the Yes outcome for that market?”
  • “Resolve this market by condition ID and show the token ID for the No outcome.”

Requirements

  • Network access to Polymarket's Gamma and CLOB APIs
  • curl, for the example requests

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit d03ff6c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • gamma-api.polymarket.com
    • clob.polymarket.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Polymarket Public Data Lookup loads about 536 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 184 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~536

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 184 words (~536 tokens).

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

— opening of SKILL.md by HKUDS
name
polymarket-public-data

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/polymarket of HKUDS/AI-Trader.

Open the folder on GitHubat commit d03ff6c

Compare with similar skills

Polymarket Public Data Lookup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Polymarket Public Data Lookup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polymarket Public Data Lookup this skillHKUDS/AI-Trader23k—~536Automated safety check: PassNone
Predexon Prediction Market DataBlockRunAI/ClawRouter6.6k—~4.7kAutomated safety check: PassMIT
Surf Crypto Data APIBlockRunAI/blockrun-mcp391—~1.7kAutomated safety check: PassMIT
SignalradarLeoYeAI/openclaw-master-skills2.2k—~7.1kAutomated safety check: PassMIT
XeroCraftOS-dev/CraftBot392—~2kAutomated safety check: PassMIT
Eastmoney Market DataHKUDS/Vibe-Trading35k—~1kAutomated safety check: PassMIT

Similar skills

  • Predexon Prediction Market Data

    BlockRunAI/ClawRouter

    Reads structured prediction market data for Polymarket, Kalshi and other venues through a local BlockRun gateway: markets, search, leaderboards, wallet analytics and odds.

    6.6k GitHub stars~4.7k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Surf Crypto Data API

    BlockRunAI/blockrun-mcp

    Routes crypto market, on-chain, wallet and prediction-market lookups to the Surf data API through a local ClawRouter, paid per call.

    391 GitHub stars~1.7k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Signalradar

    LeoYeAI/openclaw-master-skills

    SignalRadar — Monitor Polymarket prediction markets for probability changes and send alerts when thresholds are crossed.

    2.2k GitHub stars~7.1k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Xero

    CraftOS-dev/CraftBot

    Xero API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Eastmoney Market Data

    HKUDS/Vibe-Trading

    Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.

    35k GitHub stars~1k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • OKX Market Data

    HKUDS/Vibe-Trading

    Retrieves public OKX cryptocurrency market data such as spot prices, candlesticks, funding rates and open interest through the OKX V5 REST API, with no authentication.

    35k GitHub stars~1.3k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from HKUDS/AI-Trader

  • AI-Trader Market Intel

    HKUDS/AI-Trader

    Reads AI-Trader's read-only market snapshots, grouped financial news and events board through its market-intel endpoints, for context before trading or posting.

    23k GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Connects an agent to the AI-Trader platform's API to publish trading signals and follow traders, routing to child skills for copy trading, trade sync and market data.

    23k GitHub stars~8.5k tokensUpdated 4 mo ago
    Auto-check passed
  • AI-Trader Copy Trading

    HKUDS/AI-Trader

    Lets an agent follow signal providers on the AI-Trader platform and mirror their positions through its API, with feeds, subscriptions and position lists.

    23k GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Polls the AI-Trader heartbeat API on a regular interval to reliably receive messages and tasks, treating the optional WebSocket feed as a non-guaranteed supplement.

    23k GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • AI-Trader Trade Sync

    HKUDS/AI-Trader

    Uploads positions and trade history to the AI-Trader copy-trading platform and pushes real-time buy, sell, short and cover signals to followers.

    23k GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Polymarket Public Data Lookup

What does Polymarket Public Data Lookup do?

Looks up Polymarket market details and orderbook prices straight from Polymarket's public APIs and resolves outcome tokens for later simulated trades. The agent resolves a market by slug, condition ID or token ID against the Polymarket Gamma markets API, then reads the question, slug, outcomes and CLOB token IDs from the result. Each outcome is paired with its token ID by position, so Yes and No map to exact tokens.

When should I use Polymarket Public Data Lookup?

Polymarket Public Data Lookup fits situations like: looking up a Polymarket market by slug or condition ID; finding the token ID behind a Yes or No outcome; reading the best bid, ask and mid price for an outcome; preparing a simulated trade entry for AI-Trader.

How do I install Polymarket Public Data Lookup in Claude Code?

Run `npx skills add HKUDS/AI-Trader --skill polymarket-public-data -a claude-code`. Or copy the skill folder (skills/polymarket in HKUDS/AI-Trader) into .claude/skills/polymarket-public-data in your project. Claude Code loads it when a task matches its description.

How do I install Polymarket Public Data Lookup in Codex?

Run `npx skills add HKUDS/AI-Trader --skill polymarket-public-data -a codex`. Or copy the skill folder (skills/polymarket in HKUDS/AI-Trader) into .agents/skills/polymarket-public-data in your project. Codex loads it when a task matches its description.

Can I use Polymarket Public Data Lookup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/AI-Trader --skill polymarket-public-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/polymarket-public-data, .gemini/skills/polymarket-public-data, .github/skills/polymarket-public-data and .opencode/skills/polymarket-public-data in your project.

What does Polymarket Public Data Lookup need to run?

Going by SKILL.md and its folder, Polymarket Public Data Lookup needs the command-line tools its instructions call (curl). Our summary lists: Network access to Polymarket's Gamma and CLOB APIs; curl, for the example requests.

Does Polymarket Public Data Lookup access the network?

SKILL.md names 2 domains. In commands or code: gamma-api.polymarket.com and clob.polymarket.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Polymarket Public Data Lookup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Polymarket Public Data Lookup use?

No licence was found for Polymarket Public Data Lookup or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Polymarket Public Data Lookup use?

About 536 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Polymarket Public Data Lookup?

Skills that share tags, products or a category with Polymarket Public Data Lookup: Predexon Prediction Market Data (BlockRunAI/ClawRouter, 6.6k stars), Surf Crypto Data API (BlockRunAI/blockrun-mcp, 391 stars), Signalradar (LeoYeAI/openclaw-master-skills, 2.2k stars) and Xero (CraftOS-dev/CraftBot, 392 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polymarket Public Data Lookup?

HKUDS (a GitHub organization) maintains it in HKUDS/AI-Trader, which has 22,706 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 11, 2026.

Source: HKUDS/AI-Trader on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.