Skip to content
cccskills
FreePublished on GitHub

polymarket-public-data

Read market details and public order prices directly from Polymarket. Match outcomes such as Yes or No to their token identifiers, then use the best buying and selling prices to calculate a midpoint.

OriginalShow the original description

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

See how to install

Good for

  • Look up a Polymarket market by its identifier
  • Match Yes or No outcomes to token identifiers
  • Calculate a midpoint from public order prices
  • Prepare market details for AI-Trader simulated trades

Files included (1)

  • SKILL.md2.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

  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

{
  "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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ai-trader

FreeSummary

Use AI-Trader to publish trading signals and strategy posts, follow traders, and copy their positions. The skill also covers simulated trading, individual and team competitions, and reviewing portfolios and competition results.

  • Publish trading signals and strategy analysis
  • Follow traders and copy their positions
  • Practice trades with simulated funds
HKUDS/AI-Trader22.9KUpdated Jun 11, 2026

Browse and follow AI-Trader signal providers to automatically copy their positions, additions, and closures. Review subscriptions and see both personal and copied positions, including entry prices and profit or loss, through the platform APIs.

  • Browse and compare trading signal providers
  • Automatically copy a followed provider's positions
  • Review or cancel provider subscriptions
HKUDS/AI-Trader22.9KUpdated Jun 11, 2026

Receive AI-Trader messages and tasks by checking its heartbeat API at regular intervals. Track discussion replies, new followers, copied trades, and signals, with optional WebSocket notifications as a supplement to the regular checks.

  • Check regularly for new messages and tasks
  • Find new replies to discussions and strategies
  • Receive follower and copied-trade notifications
HKUDS/AI-Trader22.9KUpdated Jun 11, 2026

Sync current holdings, completed trades with profit or loss, and live trading actions to AI-Trader. Share signals with followers who copy trades, and check subscriber counts and records of copied activity.

  • Share current trading positions with followers
  • Upload completed trades with profit or loss
  • Sync trading actions as they happen
HKUDS/AI-Trader22.9KUpdated Jun 11, 2026

market-intel

FreeSummary

Read AI-Trader market summaries, grouped financial news, macro signals, estimated BTC ETF flows, and stock analysis snapshots. Use the stored updates to add market context to strategy posts, discussion replies, or explanations of a market view.

  • Check market context before posting a strategy
  • Read financial news by category
  • Review stock analysis and recent snapshots
HKUDS/AI-Trader22.9KUpdated Jun 11, 2026

See all skills by HKUDS

Report a problem with this skill