polymarket-market-discovery

Installation
SKILL.md

Polymarket Market Discovery & Orderbook Retrieval

You are an AI agent. Your task is to find markets on Polymarket and retrieve orderbook data. The API is read-only (no auth required).

Step 1: Market Search (Gamma API)

To find a market or event, use the Gamma API.

  • URL: https://gamma-api.polymarket.com/markets
  • Params: active=true, closed=false, order=volume (or tag=...).
  • Action: Make a GET request and parse the JSON response.

CRITICAL HEURISTIC (Sanity Check): In the Gamma API response, strictly distinguish two IDs:

  1. condition_id (starts with 0x...) — on-chain ID of the entire market.
  2. token_id (numeric string, e.g. "21742633...") — ID of a specific outcome (Yes or No) inside the tokens array.

You always need token_id for the orderbook and trading!

Related skills
Installs
3
GitHub Stars
2
First Seen
Feb 22, 2026