{"uid":"cap_qsO9E4J0bK0Pmr7o4S159","slug":"polymarket-odds-lookup-8881a363","name":"Polymarket Odds 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/odds","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 market slug, a 0x condition id, or free text naming the market"}},"description":"Which Polymarket market to quote: a slug, a 0x condition id, or free text (searched only after payment).","additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"odds":{"type":["object","null"],"properties":{"no":{"type":"number"},"yes":{"type":"number"},"as_of":{"type":"string"},"change_7d":{"type":["number","null"]},"change_24h":{"type":["number","null"]},"last_trade":{"type":["number","null"]},"volume_usd":{"type":["number","null"]},"liquidity_usd":{"type":["number","null"]},"implied_probability_pct":{"type":"number"}}},"query":{"type":"object","properties":{"kind":{"enum":["condition_id","slug","search","text"],"type":"string"},"value":{"type":"string"}}},"market":{"type":["object","null"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"closed":{"type":"boolean"},"end_date":{"type":["string","null"]},"question":{"type":"string"},"resolution":{"type":"string"},"condition_id":{"type":"string"}}},"status":{"enum":["open","closed","resolved","not_found"],"type":"string"},"candidates":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"closed":{"type":"boolean"},"question":{"type":"string"}}}},"disclaimer":{"type":"string"},"generation":{"type":["integer","null"]},"attribution":{"type":"string"},"data_cutoff":{"type":["string","null"]},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"odds":{"no":0.9615,"yes":0.0385,"as_of":"2026-09-11T00:00:00.000Z","change_7d":-0.003,"change_24h":-0.0005,"last_trade":0.038,"volume_usd":13121236.14,"liquidity_usd":412530.12,"implied_probability_pct":3.85},"query":{"kind":"slug","value":"xi-jinping-out-before-2027"},"market":{"id":"559651","slug":"xi-jinping-out-before-2027","closed":false,"end_date":"2027-01-01T04:59:00.000Z","question":"Xi Jinping out before 2027?","resolution":"open","condition_id":"0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7"},"status":"open","disclaimer":"…","generation":1,"attribution":"…","data_cutoff":"2026-09-10","generated_at":"2026-09-11T00:00:00.000Z"}},"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_pnH8v71cuviSk8gpXWuII","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":"Returns real-time Polymarket prediction market odds, volume, liquidity, and 24h/7d price changes for a specified market","exampleAgentPrompt":"What are the current Polymarket odds that Xi Jinping is out before 2027 — give me the yes/no prices, implied probability, and how much the price has moved in the last 24 hours?","exampleUseCases":[{"title":"Election probability check","prompt":"What does Polymarket currently say about the odds of Trump winning the 2024 election — show me the yes price, implied probability, and any movement in the last week?"},{"title":"Political leadership market monitor","prompt":"Pull up the Polymarket market on whether Xi Jinping will be out before 2027 and tell me the current yes/no odds, volume, and liquidity."},{"title":"Event resolution status lookup","prompt":"Is the Polymarket market on Fed rate cuts for 2025 still open or has it resolved? And what are the latest odds if it's still trading?"}],"resultDescription":"Returns a JSON object with the matched market's question, slug, condition ID, open/closed/resolved status, end date, and a full odds block including yes price, no price, implied probability percent, 24h price change, 7d price change, last trade price, USD volume, and USD liquidity. Also includes query metadata (kind: slug/condition_id/search/text), data cutoff timestamp, and attribution disclaimer. If no exact match is found, returns a candidates list of similar markets.","failureModes":["Market not found by slug or condition ID — returns status: not_found with candidates list","Free-text search returns ambiguous candidates — agent must refine query or select from candidates","Market is closed or resolved — odds block may be null or historical","Payment not completed — 402 response before data is returned","Market slug too short (under 3 chars) — schema validation error","Network or upstream Polymarket data outage — may return stale data_cutoff"],"whenToPreferThis":"Use this endpoint when you need current Polymarket prediction market odds for a specific event, especially when you have a known slug or condition ID. Prefer this over general web search when you need structured probability data (yes/no prices, volume, liquidity, price deltas) suitable for programmatic use. The $0.01 per-call price makes it cost-effective for single market lookups. Best when the user wants a precise implied probability figure or wants to track price movement over 24h or 7d windows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:49.943Z","isFirstParty":false}