{
  "schemaVersion": "vultax-public-research-data-v1",
  "articleUrl": "https://vultax.com/research/polymarket-api-python-tutorial",
  "datasets": [
    {
      "title": "Read a price history, and the limits that are not documented",
      "columns": [
        {
          "name": "Request",
          "unit": null
        },
        {
          "name": "What came back on 19 October 2026",
          "unit": null
        }
      ],
      "rows": [
        [
          "interval=max&fidelity=1440",
          "322 daily points, from the contract's first day, 19 November 2025"
        ],
        [
          "interval=max&fidelity=60",
          "711 points, the last 30 days only"
        ],
        [
          "interval=max",
          "4,280 points, the last 30 days only"
        ],
        [
          "startTs and endTs 15 days apart, fidelity=1",
          "A point a minute for the 15 days, with gaps"
        ],
        [
          "startTs and endTs 16 days apart, any fidelity",
          "HTTP 400: 'interval is too long'"
        ],
        [
          "Any of the above",
          "One extra point at the end: the current price"
        ]
      ],
      "measurementContext": "Polymarket CLOB prices-history, read for one token on 19 October 2026. The limits are not in Polymarket's documentation and can change.",
      "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."
        },
        {
          "label": "Selected arithmetic checked in Lean 4.35.0",
          "url": "https://vultax.com/datasets/research-proof-library-2026-10-25/articles/polymarket-api-python-tutorial.md",
          "note": "Selected exact-rational calculations and displayed-value consistency checks, checked by Lean 4.35.0, Lean kernel replay and Nanoda. Not a proof of the underlying observations, statistical conclusions, legal claims or production code."
        },
        {
          "label": "Per-article scope records and Lean package",
          "url": "https://vultax.com/datasets/research-proof-library-public-2026-10-28/README.md",
          "note": "Historical scope records and selected Lean checks; the complete package is temporarily unavailable."
        }
      ],
      "measurement": {
        "kind": null,
        "temporalCoverage": null,
        "population": null,
        "methodology": null
      },
      "id": "price-history-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#price-history",
      "publishedAt": "2026-09-22",
      "modifiedAt": "2026-10-25",
      "version": "622945ba37835eb09b7a6a8dc7e98f0d1413c77d348e4e8e7b51061bde46fe24",
      "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=price-history-table",
        "csv": "https://vultax.com/research/polymarket-api-python-tutorial/data.csv?dataset=price-history-table"
      }
    }
  ]
}