Polymarket API Guide: Get Started with Market Data

#!/usr/bin/env python3
"""
Fetch Polymarket market data via the CLOB API.
No API key required for public endpoints.
"""

import requests
import json

CLOB_BASE = "https://clob.polymarket.com"
GAMMA_BASE = "https://gamma-api.polymarket.com"

def get_markets(limit=5):
    """Fetch a list of active markets."""
    url = f"{CLOB_BASE}/markets"
    params = {"next_cursor": "MA=="}
    response = requests.get(url, params=params, timeout=10)
    response.raise_for_status()
    data = response.json()
    return data

def get_market_price(token_id: str):
    """Get the current price for a specific token."""
    url = f"{CLOB_BASE}/prices"
    params = {"token_id": token_id, "side": "buy"}
    response = requests.get(url, params=params, timeout=10)
    response.raise_for_status()
    return response.json()

def get_orderbook(token_id: str):
    """Get the full orderbook for a token."""
    url = f"{CLOB_BASE}/book"
    params = {"token_id": token_id}
    response = requests.get(url, params=params, timeout=10)
    response.raise_for_status()
    data = response.json()
    return {
        "best_bid": data.get("bids", [{}])[0],
        "best_ask": data.get("asks", [{}])[0],
        "bid_depth": len(data.get("bids", [])),
        "ask_depth": len(data.get("asks", []))
    }

def get_recent_trades(asset_id: str, limit=20):
    """Fetch recent trades for a market."""
    url = f"{CLOB_BASE}/trades"
    params = {"asset_id": asset_id, "limit": limit}
    response = requests.get(url, params=params, timeout=10)
    response.raise_for_status()
    return response.json()

if __name__ == "__main__":
    # 1. List markets
    print("=== Fetching Markets ===")
    markets = get_markets()
    for market in markets.get("data", [])[:5]:
        print(f"  {market.get('question', 'N/A')}")
        tokens = market.get("tokens", [])
        for token in tokens:
            tid = token.get("token_id", "")
            print(f"    Token: {tid[:20]}...")

    # 2. Get a price (replace with a real token_id)
    # price = get_market_price("0x1234...")
    # print(f"Current price: {price}")

    print("\nDone! Customize the token IDs above.")

/**
 * Fetch Polymarket data using the CLOB API.
 * Works in Node.js 18+ and modern browsers.
 */

const CLOB_BASE = "https://clob.polymarket.com";

async function getMarkets() {
  const res = await fetch(`${CLOB_BASE}/markets?next_cursor=MA==`);
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

async function getPrice(tokenId) {
  const res = await fetch(
    `${CLOB_BASE}/prices?token_id=${tokenId}&side=buy`
  );
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

async function getRecentTrades(assetId, limit = 20) {
  const res = await fetch(
    `${CLOB_BASE}/trades?asset_id=${assetId}&limit=${limit}`
  );
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

// Main
(async () => {
  console.log("=== Fetching Markets ===");
  const markets = await getMarkets();
  const items = markets.data?.slice(0, 5) || [];

  for (const market of items) {
    console.log(`  ${market.question}`);
    for (const token of market.tokens || []) {
      console.log(`    Token: ${token.token_id?.slice(0, 20)}...`);
    }
  }

  console.log("\nDone!");
})();