{
  "schemaVersion": "vultax-public-research-data-v1",
  "articleUrl": "https://vultax.com/research/polymarket-api-python-tutorial",
  "datasets": [
    {
      "title": "Three requests and no key: what the Polymarket API gives you",
      "columns": [
        {
          "name": "Service",
          "unit": null
        },
        {
          "name": "Ask it for",
          "unit": null
        },
        {
          "name": "What comes back",
          "unit": null
        }
      ],
      "rows": [
        [
          "Gamma, gamma-api.polymarket.com",
          "One market, by its exact slug",
          "Market and condition IDs, labelled outcomes with their token IDs, a summary price per outcome, open or closed, and the market's own fee settings"
        ],
        [
          "CLOB, clob.polymarket.com",
          "One order book, by an outcome's token ID",
          "Every bid and ask with its size, and the time the book was produced"
        ],
        [
          "Vultax research exports",
          "One published table, by article and dataset ID",
          "A historical table with its observation window, population, sources and a version that changes only when the table does"
        ]
      ],
      "measurementContext": "Responsibilities checked against Polymarket's documentation and live responses on 20 September 2026 UTC. The three sources are read one after another and are not one synchronized dataset.",
      "sources": [
        {
          "label": "Polymarket: market data overview",
          "url": "https://docs.polymarket.com/market-data/overview",
          "note": "Events, markets, outcomes and token IDs; checked 20 September 2026 UTC."
        },
        {
          "label": "Polymarket: discover markets",
          "url": "https://docs.polymarket.com/market-data/discover-markets",
          "note": "Official market discovery and pagination reference."
        },
        {
          "label": "Polymarket: market details",
          "url": "https://docs.polymarket.com/market-data/market-details",
          "note": "Outcome identity, market state and the fee fields feesEnabled and feeSchedule."
        },
        {
          "label": "Polymarket: prices and order books",
          "url": "https://docs.polymarket.com/market-data/prices-order-books",
          "note": "Official order-book reference."
        },
        {
          "label": "Polymarket: fees",
          "url": "https://docs.polymarket.com/trading/fees",
          "note": "The taker fee formula, published category rates and five-decimal rounding; checked 20 September 2026 UTC."
        },
        {
          "label": "Vultax: fee settings of the 1,000 most-traded open markets",
          "url": "https://vultax.com/tools/polymarket-fee-calculator#what-markets-charge",
          "note": "One read on 20 September 2026 at 20:53 UTC, with CSV, JSON and the script that produced it."
        },
        {
          "label": "Vultax trader research and published data",
          "url": "https://vultax.com/research/best-polymarket-traders-leaderboards",
          "note": "A separate historical research population, not a join to the selected market."
        }
      ],
      "measurement": {
        "kind": "reference",
        "temporalCoverage": "2026-09-20",
        "population": null,
        "methodology": "Read one exact market, the order book of one of its outcomes and one published research export; keep each source, its identifiers and its timestamps separate."
      },
      "id": "start-table",
      "kind": "published-table",
      "description": "A standard-library Python script reads one Polymarket market, the order book for one outcome and the fee that market charges, in three public requests with no key. Read this way, 309 of the 1,000 most-traded open markets charged takers nothing on 20 September 2026.",
      "articleUrl": "https://vultax.com/research/polymarket-api-python-tutorial",
      "sectionUrl": "https://vultax.com/research/polymarket-api-python-tutorial#start",
      "publishedAt": "2026-09-22",
      "modifiedAt": "2026-09-22",
      "version": "666281ea8a7cfa28f7a385be44080a2a8fdf64f5969df907cbb929c0f632b43d",
      "isLive": false,
      "limitations": "Published research snapshots and calculations; these exports do not contain current quotes or live account data. Observation windows and populations are stated in the source captions and methodology. Missing metadata is unknown, not zero. A teaching example built on public data: it does not trade, and provider responses can change without notice. Not financial advice.",
      "downloads": {
        "json": "https://vultax.com/research/polymarket-api-python-tutorial/data.json?dataset=start-table",
        "csv": "https://vultax.com/research/polymarket-api-python-tutorial/data.csv?dataset=start-table"
      }
    }
  ]
}