{"uid":"cap_pMi9X-ZIe0AUTWiW97qVX","slug":"polymarket-market-price-history-4adac996","name":"Polymarket Market Price History","description":"Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1","url":"https://aiworker.duckdns.org/v1/polymarket/history","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","required":["market"],"properties":{"days":{"type":"integer","default":90,"maximum":365,"minimum":1,"description":"How many UTC days ending at the store's data cut-off to include (only days with a stored close appear)"},"market":{"type":"string","maxLength":200,"minLength":3,"description":"A market slug, a 0x condition id, or a numeric market id (same classifier as resolution_check)"}},"description":"Which stored market to chart and how many UTC days of daily closes to include.","additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"market":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"end_date":{"type":"string"},"question":{"type":"string"},"event_slug":{"type":"string"},"resolution":{"type":"string"},"resolved_at":{"type":["string","null"]},"condition_id":{"type":"string"}}},"series":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"vwap":{"type":["number","null"]},"close":{"type":"number"},"source":{"enum":["dump","clob"],"type":"string"},"trades":{"type":["integer","null"]},"volume_usd":{"type":["number","null"]}}}},"window":{"type":"object","properties":{"to":{"type":"string"},"days":{"type":"integer"},"from":{"type":"string"}}},"summary":{"type":"object","properties":{"low":{"type":["number","null"]},"high":{"type":["number","null"]},"last":{"type":["number","null"]},"open":{"type":["number","null"]},"n_days":{"type":"integer"},"change_1d":{"type":["number","null"]},"change_1w":{"type":["number","null"]},"days_to_end":{"type":["number","null"]},"volume_usd_total":{"type":["number","null"]}}},"disclaimer":{"type":"string"},"generation":{"type":"integer"},"attribution":{"type":"string"},"data_cutoff":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"market":{"id":"559651","slug":"xi-jinping-out-before-2027","end_date":"2027-01-01","question":"Xi Jinping out before 2027?","event_slug":"xi-jinping-out-before-2027","resolution":"open","resolved_at":null,"condition_id":"0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7"},"series":[{"day":"2026-08-11","vwap":0.0398,"close":0.04,"source":"clob","trades":41,"volume_usd":1520.5}],"window":{"to":"2026-09-09","days":30,"from":"2026-08-11"},"summary":{"low":0.037,"high":0.045,"last":0.0385,"open":0.04,"n_days":30,"change_1d":-0.001,"change_1w":-0.003,"days_to_end":479,"volume_usd_total":48210.2},"disclaimer":"…","generation":1,"attribution":"…","data_cutoff":"2026-09-09","generated_at":"2026-09-10T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hxoExuvzJXrcOh_yNH2MX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily close prices, VWAP, volume, and summary statistics for a Polymarket prediction market over a configurable date window.","exampleAgentPrompt":"Pull the last 30 days of daily close prices and volume for the Polymarket market 'xi-jinping-out-before-2027' and give me the price summary including the 1-day and 1-week change.","exampleUseCases":[{"title":"Track prediction market price trend","prompt":"Show me the daily closing prices for the Polymarket market 'will-the-fed-cut-rates-in-2025' over the last 60 days, including the volume and how much the price has changed this week."},{"title":"Research resolved market outcome","prompt":"Get me the full price history for Polymarket condition ID 0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7 over the past 90 days so I can see how the market moved before resolution."},{"title":"Monitor live market momentum","prompt":"What are the current price, high, low, and 1-day change for the Polymarket market with slug 'trump-wins-2024-election'? Pull the last 7 days of data."}],"resultDescription":"Returns a JSON object containing: market metadata (slug, question, condition ID, resolution status, end date), a daily time-series array (date, close price, VWAP, trade count, USD volume, data source), a window object (from/to dates, number of days), and a summary object (open, high, low, last price, 1-day change, 1-week change, total USD volume, days to end, number of days with data).","failureModes":["Invalid or unrecognized market slug/condition ID returns an error","Market with no stored close data returns empty series array","Days parameter out of range (1-365) rejected with validation error","Payment of $0.02 USDC required; missing x402 payment header returns 402","Market exists but has no trading history within the requested window"],"whenToPreferThis":"Choose this endpoint when you need structured daily price history, VWAP, and volume statistics for a specific Polymarket prediction market — especially when you need a clean summary (open/high/low/last, 1d/1w change) without scraping Polymarket directly. Ideal for agents doing trend analysis, backtesting, or monitoring a market's probability movement over time. Prefer over raw Polymarket API access when you want normalized, ready-to-use data at low per-call cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:59:14.654Z","isFirstParty":false}