{
  "schemaVersion": "vultax-public-research-data-v1",
  "articleUrl": "https://vultax.com/research/polymarket-api-python-tutorial",
  "datasets": [
    {
      "title": "When it stops, it says why",
      "columns": [
        {
          "name": "What you see",
          "unit": null
        },
        {
          "name": "Why",
          "unit": null
        },
        {
          "name": "What to do",
          "unit": null
        }
      ],
      "rows": [
        [
          "'…' is an event with 4 markets, not one market",
          "The slug names an event, which groups several markets",
          "Pass one of the market slugs the message lists"
        ],
        [
          "No market has the exact slug '…'",
          "A typing slip, or the market has been removed",
          "Run --list 10 and copy a slug from the output"
        ],
        [
          "--outcome 'Maybe' does not name exactly one outcome",
          "The label is not one of this market's outcomes",
          "Use one of the labels the message prints"
        ],
        [
          "Order book: unavailable",
          "The market is closed or not accepting orders, or the reply failed an identity check",
          "Read the reason stored under receipts in snapshot.json"
        ],
        [
          "HTTP 429 from the address requested",
          "Requests are arriving too quickly",
          "Wait, for as long as the message says when it gives a time, before running it again"
        ],
        [
          "Output directory already exists",
          "A folder of that name is already there",
          "Pass a new --output path"
        ]
      ],
      "measurementContext": "Messages shortened. Each was produced by running the script on 20 September 2026 UTC, except HTTP 429, which did not occur.",
      "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": "Run the published script with an event slug, an unknown slug, a wrong outcome label, a closed market and an existing output path."
      },
      "id": "errors-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#errors",
      "publishedAt": "2026-09-22",
      "modifiedAt": "2026-09-22",
      "version": "bd84e3db48b200a4c6ccb56edca3bdeff16108e5eaed6409ad8b68de0aea8112",
      "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=errors-table",
        "csv": "https://vultax.com/research/polymarket-api-python-tutorial/data.csv?dataset=errors-table"
      }
    }
  ]
}