{"uid":"cap_3-aiy3e1XapPu0uNvWDRH","slug":"chainhilt-polymarket-prediction-markets-search-445723ad","name":"ChainHilt Polymarket Prediction Markets Search","description":"Search prediction markets. `closingAfter`/`closingBefore` bound the venue query; other filters apply after fetching `limit` rows, so a page can be short or empty while `nextCursor` is set: keep paging until it is absent. `sort=closingTime` lists open markets closing soonest; with `closingBefore` it finds short-horizon markets such as the 5-minute crypto up/down slots, which text `query` search never returns. Errors: 400 invalid query or cursor, 502 venue failure.","url":"https://chainhilt.ai/api/v1/predict/polymarket/markets/search?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","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"sort":{"enum":["relevance","liquidity","volume24h","closingTime"],"type":"string","description":"Order: relevance (default), liquidity, volume24h, or closingTime (soonest first)."},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Markets fetched per page (1-100, default 20); filters apply after the fetch."},"query":{"type":"string","minLength":1,"description":"Free-text search; returns one page with no `nextCursor`. Omit to list markets by `sort`."},"cursor":{"type":"string","pattern":"^\\d+(@\\d+)?$","description":"The previous page's `nextCursor`, unchanged. Ignored with `query`."},"status":{"enum":["open","closed","resolved"],"type":"string","description":"Market status. Listings without `query` default to open markets."},"tradable":{"enum":["true","false"],"type":"string","description":"\"true\" keeps only markets open for trading on the order book, \"false\" the rest."},"closingAfter":{"type":"string","description":"ISO 8601: only markets closing at or after this time."},"minLiquidity":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Minimum market liquidity in USD."},"minVolume24h":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Minimum 24-hour volume in USD."},"closingBefore":{"type":"string","description":"ISO 8601: only markets closing at or before this time."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"markets":[{"id":"512329","fees":{"rate":0,"feeType":null},"venue":"polymarket","status":"open","eventId":"606422","negRisk":false,"outcomes":[{"name":"Yes","price":"0.43","tokenId":"111"},{"name":"No","price":"0.57","tokenId":"222"}],"question":"Will the Fed cut rates at its December meeting?","tickSize":"0.01","tradable":true,"closeTime":"2026-12-10T19:00:00.000Z","liquidity":"125000.5","volume24h":"48210.25","observedAt":"2026-10-30T12:00:00.000Z","resolution":{"rules":"Resolves Yes if the FOMC announces a cut to the federal funds target range at its December meeting.","source":"https://www.federalreserve.gov"},"conditionId":"0x9f1c1c4c1d6a2b2f0d5a7e8b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f","minOrderSize":"5"}],"nextCursor":"5"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vpB1e4X_wuy0pLI5UkRJ-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and paginate Polymarket prediction markets with filters for status, liquidity, volume, closing time, and free-text query","exampleAgentPrompt":"Find open Polymarket prediction markets about the Fed interest rate decision, sorted by soonest closing time, and show me the top 10 results with their current Yes/No prices.","exampleUseCases":[{"title":"Scouting short-horizon crypto markets","prompt":"Show me all tradable Polymarket markets closing within the next hour sorted by soonest closing time — I'm looking for those short-horizon crypto up/down slots."},{"title":"Researching high-liquidity election markets","prompt":"Search Polymarket for prediction markets about the US presidential election that have at least $50,000 in liquidity, sorted by 24-hour volume."},{"title":"Browsing markets closing this week","prompt":"List open Polymarket markets that close before next Monday sorted by closing time, paginate through up to 50 per page."}],"resultDescription":"Returns a paginated list of Polymarket prediction market objects, each including market ID, question text, outcome names with current prices and token IDs, status, closing time, liquidity in USD, 24-hour volume, resolution rules and source, condition ID, tick size, and minimum order size. Includes a nextCursor field for pagination when more results exist.","failureModes":["400 Bad Request: invalid query string, malformed cursor, or invalid ISO 8601 date in closingAfter/closingBefore","502 Bad Gateway: upstream Polymarket venue failure or timeout","Empty page with nextCursor present: post-fetch filters eliminated results but more pages exist — caller must continue paging","Short pages: filters (minLiquidity, minVolume24h, tradable) apply after fetching limit rows, so returned count may be less than limit"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate Polymarket prediction markets programmatically — especially when searching by topic, filtering by closing time window (e.g. short-horizon markets), or sorting by liquidity/volume. Prefer over generic web search when you need structured market data including prices, liquidity, and resolution rules. The closingAfter/closingBefore filters are essential for finding time-bound markets like 5-minute crypto slots that text search cannot surface.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T18:34:14.256Z","isFirstParty":false,"canonicalSlug":"chainhilt-polymarket-prediction-markets-search-445723ad"}