{"uid":"cap_82mslpDBNcV_UwowC2M1F","slug":"polymarket-market-resolution-lookup-a2dea1b3","name":"Polymarket Market Resolution Lookup","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/resolution","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":{"market":{"type":"string","maxLength":200,"minLength":3,"description":"a Polymarket market slug (e.g. xi-jinping-out-before-2027), a 0x-prefixed 64-hex condition id, or the market question as free text"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"match":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"closed":{"type":"boolean"},"question":{"type":"string"}}}},"alternatives":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"question":{"type":"string"}}}}}},"price":{"type":["object","null"],"properties":{"best_ask_yes":{"type":["number","null"]},"best_bid_yes":{"type":["number","null"]},"last_trade_yes":{"type":["number","null"]},"outcome_prices":{"type":["array","null"],"items":{"type":"number"}}}},"query":{"type":"object","properties":{"kind":{"enum":["condition_id","slug","search"],"type":"string"},"market":{"type":"string"}}},"market":{"type":["object","null"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"event":{"type":["object","null"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"}}},"end_at":{"type":["string","null"]},"outcomes":{"type":"array","items":{"type":"string"}},"question":{"type":"string"},"start_at":{"type":["string","null"]},"categories":{"type":"array","items":{"type":"string"}},"created_at":{"type":["string","null"]},"volume_usd":{"type":["number","null"]},"condition_id":{"type":"string"}}},"status":{"enum":["open","resolved","voided","unknown","not_found"],"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"ok":{"type":"boolean"},"url":{"type":"string"},"name":{"type":"string"}}}},"disclaimer":{"type":"string"},"resolution":{"type":["object","null"],"properties":{"payout":{"type":["array","null"],"items":{"type":"number"}},"outcome":{"type":["string","null"]},"closed_at":{"type":["string","null"]},"uma_status":{"type":["string","null"]},"resolved_at":{"type":["string","null"]},"resolved_by":{"type":["string","null"]},"days_after_end":{"type":["number","null"]}}},"attribution":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"match":{},"price":{"best_ask_yes":0.039,"best_bid_yes":0.038,"last_trade_yes":0.038,"outcome_prices":[0.0385,0.9615]},"query":{"kind":"slug","market":"xi-jinping-out-before-2027"},"market":{"id":"559651","slug":"xi-jinping-out-before-2027","event":{"id":"30828","slug":"xi-jinping-out-before-2027","title":"Xi Jinping out before 2027?"},"end_at":"2027-01-01T04:59:00.000Z","outcomes":["Yes","No"],"question":"Xi Jinping out before 2027?","start_at":"2025-07-03T20:37:00.228Z","categories":["geopolitics","world","world-affairs","earn-4","macro-geopolitics","hfc"],"created_at":"2025-07-03T20:25:56.889Z","volume_usd":13121236.14038798,"condition_id":"0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7"},"status":"open","sources":[{"ok":true,"url":"https://gamma-api.polymarket.com/markets/slug/xi-jinping-out-before-2027","name":"gamma_slug"},{"ok":true,"url":"https://gamma-api.polymarket.com/events/30828/tags","name":"gamma_event_tags"}],"disclaimer":"Historical record and public API data; informational only, not a prediction or advice.","resolution":{"payout":null,"outcome":null,"closed_at":null,"uma_status":null,"resolved_at":null,"resolved_by":"0x157Ce2d672854c848c9b79C49a8Cc6cc89176a49","days_after_end":null},"attribution":"Data: Polymarket public APIs (Gamma, CLOB), attributed; SII-WANGZJ/Polymarket_data (MIT) for on-chain fills before 2026-07-21; derived figures only, no feed.","generated_at":"2026-09-10T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hNvUMmrurGVL_x5TgAIUD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up the resolution status, outcome, payout vector, and trading data for any Polymarket prediction market by slug, condition ID, or free-text question.","exampleAgentPrompt":"Has the Polymarket market 'Will Xi Jinping be out before 2027?' resolved yet? Use the slug xi-jinping-out-before-2027 and tell me the outcome, payout, and when it closed.","exampleUseCases":[{"title":"Check resolved outcome of political market","prompt":"Did the Polymarket market on whether Trump would win the 2024 US presidential election resolve as Yes? Look it up by slug and tell me the final payout and when it was resolved."},{"title":"Verify market status before trading","prompt":"What's the current status of the Polymarket market with condition ID 0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7 — is it still open, and what's the best bid and ask right now?"},{"title":"Find closest matching market by question","prompt":"I want to know if there's a Polymarket market about whether the Fed will cut rates in 2025 and whether it has resolved — search for it by question text and tell me the status and outcome if it's closed."}],"resultDescription":"A JSON object containing: the market's resolution status (open, resolved, voided, unknown, or not_found), the winning outcome and payout vector, timestamps for closure and resolution, the UMA status and resolver address, how many days after the end date it resolved, last traded price plus best bid/ask for Yes, outcome prices array, event categories, market metadata (slug, question, volume, condition ID), and nearest candidate matches when a free-text search finds no exact match. Includes a disclaimer that this is informational only.","failureModes":["Free-text question matches no market — returns not_found with nearest candidate slugs and questions","Ambiguous slug or question matches multiple markets — returns alternatives list","Market exists but has not yet resolved — returns status: open with null resolution fields","Polymarket Gamma API is unavailable — may return error or stale data","Condition ID is malformed or unknown — returns not_found"],"whenToPreferThis":"Use this endpoint when you need a deterministic, factual record of whether a specific Polymarket prediction market has resolved and how — especially for post-hoc verification, settlement confirmation, or historical research. Prefer it over LLM-based guessing for resolution status. It supports all three lookup methods (slug, condition ID, free text), so it works even when you only have a rough question in mind. Not suitable for price forecasting, trading decisions, or general web search.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:41:25.285Z","isFirstParty":false}