{"uid":"cap_ob9kwzxVIaUJm-WnV33IR","slug":"polymarket-historical-markets-api-278c3d17","name":"Polymarket Historical Markets API","description":"Get resolved/historical prediction markets from Polymarket. Filter by date range, slug, or category.","url":"https://mechamanda.com/api/polymarket/historical?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"slug":{"type":"string","description":"Look up a specific event by slug"},"limit":{"type":"string","description":"Max number of events to return (default 5)"},"offset":{"type":"string","description":"Pagination offset (default 0)"},"tag_slug":{"type":"string","description":"Filter by category tag (e.g. politics, sports, crypto)"},"endDateMax":{"type":"string","description":"Filter events that ended on or before this date (ISO 8601)"},"endDateMin":{"type":"string","description":"Filter events that ended on or after this date (ISO 8601)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","required":["question","outcomes","outcomePrices","volume"],"properties":{"volume":{"type":"number","description":"Total trading volume"},"outcomes":{"type":"array","items":{"type":"string"},"description":"Possible outcomes (e.g. Yes/No)"},"question":{"type":"string","description":"The market question"},"liquidity":{"type":"number","description":"Current liquidity in the market"},"description":{"type":"string","description":"Market description"},"outcomePrices":{"type":"array","items":{"type":"string"},"description":"Current prices for each outcome (0-1)"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Tcex68HyHQL28qv9WOrww","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves resolved/historical prediction markets from Polymarket, filterable by date range, slug, or category tag.","exampleAgentPrompt":"Can you pull up resolved Polymarket prediction markets about crypto that ended between January 1 and March 31, 2024? Show me the top 10 by volume.","exampleUseCases":[{"title":"Research past election prediction markets","prompt":"What did Polymarket predict for last year's US election markets? Show me all the resolved politics markets from November 2024, up to 20 results."},{"title":"Audit a specific market outcome","prompt":"Look up the resolved Polymarket market with the slug 'will-bitcoin-reach-100k-by-end-of-2024' and tell me what the final outcome prices were."},{"title":"Analyze sports market history","prompt":"Pull the last 10 resolved sports prediction markets on Polymarket that ended after September 1, 2024, so I can see how accurate they were."}],"resultDescription":"An array of resolved prediction market objects, each containing the market question, possible outcomes (e.g. Yes/No), outcome prices (0–1 scale), total trading volume, current liquidity, and a market description. Returns up to the requested limit of markets matching the filter criteria.","failureModes":["Invalid date format (non-ISO 8601) returns an error","Unknown slug returns empty results or 404","Invalid tag_slug category returns empty results","Exceeding rate limits or missing payment returns 402","Very large limit values may time out or return partial results"],"whenToPreferThis":"Use this endpoint when you need historical or resolved Polymarket prediction markets — i.e. markets that have already concluded. It supports rich filtering by date range, specific event slug, or category tag, making it ideal for research, auditing past outcomes, or analyzing market accuracy. For live/trending markets, use the sibling trending endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:43:44.249Z","isFirstParty":false,"canonicalSlug":"polymarket-historical-markets-api-278c3d17"}