{"uid":"cap_HaCqYEjv1q4AHs0eU68gX","slug":"polymarket-market-screener-d88020c6","name":"Polymarket Market Screener","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/screener","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["volume","closing","move"],"type":"string","default":"volume","description":"rank by lifetime volume, by end date, or by 7-day close move (closing and move are open markets only)"},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"at most this many markets in the answer"},"movers":{"enum":["up","down"],"type":"string","description":"keep only markets with a 7-day close pair and rank by that move, up or down (open markets only, implies sort \"move\")"},"status":{"enum":["open","resolved","all"],"type":"string","default":"open","description":"which markets to list: still open, resolved yes/no, or all"},"category":{"type":"string","default":"all","maxLength":64,"minLength":1,"description":"\"all\" or a Polymarket event tag present in the store's categories table"},"min_volume_usd":{"type":"number","default":1000,"maximum":10000000,"minimum":0,"description":"markets below this lifetime volume are excluded"},"closing_within_days":{"type":"integer","maximum":365,"minimum":1,"description":"only markets ending between the data cut-off and that many days later (open markets only)"}}},"responseSchema":{"type":"json","example":{"filters":{"sort":"closing","limit":20,"status":"open","category":"politics","min_volume_usd":10000,"closing_within_days":30},"markets":[{"id":"559651","slug":"xi-jinping-out-before-2027","end_date":"2027-01-01","question":"Xi Jinping out before 2027?","change_7d":-0.003,"last_close":0.0385,"resolution":"open","volume_usd":13121236.14,"days_to_end":479,"category_tags":["politics","world"],"last_close_day":"2026-09-09"}],"universe":{"capped":false,"candidates":312},"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.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_3oHCWye27i7GOVprwk4tV","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":"Screens and ranks Polymarket prediction markets by volume, closing date, or 7-day price movement with filtering by category, status, and minimum volume","exampleAgentPrompt":"Show me the top 20 open Polymarket politics markets closing within 30 days, sorted by closing date, with at least $10,000 in volume.","exampleUseCases":[{"title":"Scout closing political prediction markets","prompt":"Find me the top 15 open Polymarket politics markets that are closing within the next 30 days, sorted by end date, and only include ones with at least $5,000 in volume."},{"title":"Discover biggest weekly price movers","prompt":"Which open Polymarket markets have moved the most upward in the last 7 days? Show me up to 10 of them with their current close prices and volume."},{"title":"Browse high-volume crypto markets","prompt":"List the 20 highest-volume Polymarket crypto markets right now, open or resolved, with at least $50,000 in lifetime volume, sorted by volume."}],"resultDescription":"Returns a JSON object containing an array of matching Polymarket markets, each with the market ID, slug, question text, end date, last close price, 7-day price change, volume in USD, days to end, category tags, and resolution status. Also includes metadata such as applied filters, total candidates found, whether the result was capped, data cutoff date, and generation timestamp.","failureModes":["Invalid category string returns empty results or error if not present in categories table","Requesting closing_within_days on resolved markets is ignored (open markets only)","Movers filter with no 7-day close data available returns empty array","Exceeding limit maximum of 50 returns validation error","min_volume_usd above 10,000,000 returns validation error","Data may be stale if called shortly after data cutoff timestamp"],"whenToPreferThis":"Use this endpoint when you need to discover, rank, or filter Polymarket prediction markets at scale — for example, building a market watchlist, identifying trending or soon-to-close markets, or scanning a specific category like politics or crypto. Prefer this over a raw Polymarket API when you want server-side filtering, ranking, and clean structured output without handling pagination or raw event data yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:33:17.169Z","isFirstParty":false}