Polymarket Markets

Live market discovery via Gamma API.

For foundational context, see polymarket-references.

Search Markets

curl -s "https://gamma-api.polymarket.com/public-search?q=QUERY&limit_per_type=10" | jq

Response contains events[] with markets, prices, volume.

Get Market by Condition ID

curl -s "https://gamma-api.polymarket.com/markets?condition_ids=CONDITION_ID&limit=1&offset=0" | jq '.[0]'

Key fields: question, conditionId, outcomes, outcomePrices, clobTokenIds, volume, liquidity, negRisk

Get Event with All Markets

curl -s "https://gamma-api.polymarket.com/events/EVENT_ID" | jq

Or by slug:

curl -s "https://gamma-api.polymarket.com/events/EVENT_SLUG" | jq

List Markets with Filters

curl -s "https://gamma-api.polymarket.com/markets?limit=20&offset=0&active=true&closed=false" | jq

Optional params:

• tag_slug=politics - Filter by tag
• volume_num_min=10000 - Minimum volume
• liquidity_num_min=5000 - Minimum liquidity

Trending Markets (by volume)

curl -s "https://gamma-api.polymarket.com/markets?limit=20&active=true&closed=false" | jq 'sort_by(-.volume24hr) | .[0:10] | .[] | {question, volume24hr, outcomePrices}'

List Tags

curl -s "https://gamma-api.polymarket.com/tags" | jq '.[] | {id, label, slug}'

Python Alternative

import httpx

GAMMA = "https://gamma-api.polymarket.com"

def search_markets(query: str, limit: int = 10):
    r = httpx.get(f"{GAMMA}/public-search", params={"q": query, "limit_per_type": limit})
    return r.json().get("events", [])

def get_market(condition_id: str):
    r = httpx.get(f"{GAMMA}/markets", params={"condition_ids": condition_id, "limit": 1, "offset": 0})
    return r.json()[0] if r.json() else None

def get_event(event_id: str):
    r = httpx.get(f"{GAMMA}/events/{event_id}")
    return r.json()