{"uid":"cap_eZW_jZfg50G_5BQgDwib3","slug":"polymarket-prediction-market-search-677920f4","name":"Polymarket Prediction Market Search","description":"Searches Polymarket for markets matching your terms and returns, per market, the implied probability of each outcome with the liquidity, 24-hour volume, bid-ask spread and closing date. The probability is the mid price and nothing more: on a market with little liquidity or a wide spread it says little, so both are returned next to it and a thin market is flagged rather than presented as a confident forecast.","url":"https://finanz.halowerk.com/v1/prediction-markets","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"slug":{"type":"string","maxLength":200,"description":"Exact market slug, if known."},"limit":{"type":"integer","default":8,"maximum":25,"minimum":1,"description":"How many markets to return."},"query":{"type":"string","maxLength":200,"description":"Search terms, e.g. \"election\" or \"fed rate\". Omit to list the most active markets."},"active_only":{"type":"boolean","default":true,"description":"Only markets still open for trading."},"min_liquidity":{"type":"number","minimum":0,"description":"Skip markets below this liquidity in USD."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UfxZtv1Qm5enj7s-GyMsh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Polymarket for prediction markets matching a query and returns per-market implied probabilities, liquidity, 24-hour volume, bid-ask spread, and closing date with thin-market warnings.","exampleAgentPrompt":"Search Polymarket for markets about a Federal Reserve interest rate cut in 2025 and tell me the implied probability of each outcome, along with the liquidity, 24-hour volume, and bid-ask spread — and flag any that look thin.","exampleUseCases":[{"title":"Election odds research","prompt":"Search Polymarket for markets about the 2026 US midterm elections and show me the implied probabilities for each outcome, plus liquidity and spread — I want to know which markets are thin."},{"title":"Macro event probability check","prompt":"What does Polymarket currently think the probability is of a US recession in 2025? Pull up the matching markets with their 24-hour volume and closing dates."},{"title":"Crypto regulatory outcome tracking","prompt":"Find prediction markets on Polymarket about a spot Ethereum ETF approval and give me the mid-price probability for each outcome alongside the bid-ask spread and liquidity."}],"resultDescription":"Returns a list of matching Polymarket markets, each containing: outcome names with implied mid-price probabilities, liquidity depth, 24-hour trading volume, bid-ask spread, market closing date, and a flag indicating whether the market is thin (low liquidity or wide spread) — with an explicit caveat that mid-price on thin markets is unreliable.","failureModes":["No markets found matching the search terms — returns empty result set","Polymarket API unavailable or rate-limited — upstream error propagated","Very broad query returns too many loosely related markets","Thin-market flag raised but probability still returned — agent must interpret with caution","Payment failure via x402 protocol — request rejected before execution"],"whenToPreferThis":"Use this endpoint when you need real-time crowd-sourced probability estimates from Polymarket for any event, especially when you also need liquidity and spread data to assess forecast reliability. Prefer this over news sentiment or model-based forecasts when you want market-implied probabilities with transparency about data quality. Especially useful for macro, geopolitical, crypto, and regulatory event research where Polymarket has active markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:12.915Z","isFirstParty":false}