{"uid":"cap_XHrNDP5GwtYcNPdmbOUkd","slug":"polymarket-free-text-prediction-market-search-343c455a","name":"Polymarket Free-Text Prediction Market Search","description":"Search Polymarket prediction markets by free text: elections, Fed rates, crypto prices, sports, geopolitics, AI. Returns the top matching open markets with live odds (outcome probabilities), best bid/ask, spread, volume, liquidity, end date and event link as flat JSON. Prediction market search, event odds lookup, \"what are the odds of X\". $0.001 per call — 5x cheaper than comparable PM search.","url":"https://x402.ottoai.services/pm-search","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":["query"],"properties":{"query":{"type":"string","description":"Free-text search across open prediction markets (e.g. \"fed rate cut\", \"bitcoin 150k\", \"world cup\")"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status"],"properties":{"data":{},"meta":{"type":"object"},"reason":{"type":"string","description":"status=unavailable only; every >=400 is UNCHARGED"},"status":{"enum":["success","unavailable"],"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"query":"fed rate cut","venue":"polymarket","markets":[],"matchCount":4,"generatedAt":"2026-07-10T12:00:00.000Z"},"meta":{"degraded":false,"validUntil":"","generatedAt":"","stalenessSec":0},"status":"success"}},"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_NUstEJ_H4RSnmuX-ht7fk","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 open Polymarket prediction markets by free text and return live odds, bid/ask spread, volume, liquidity, and event links as flat JSON","exampleAgentPrompt":"What are the current Polymarket odds on the Fed cutting rates before end of year? Search for open prediction markets about Fed rate cuts and show me the live probabilities, spread, and volume.","exampleUseCases":[{"title":"Real-time crypto price prediction tracking","prompt":"Search Polymarket for open markets about Bitcoin hitting $150k this year. Show me the current odds, bid-ask spread, and trading volume so I can see what the prediction market thinks about crypto prices."},{"title":"Geopolitical event odds analysis","prompt":"Find prediction markets on Polymarket about the next major geopolitical conflict or sanctions announcement. I want to see the live probabilities, liquidity, and how the odds are moving to understand market sentiment."},{"title":"AI regulation impact assessment","prompt":"Look up what Polymarket prediction markets are saying about AI regulation passing in the US this year. Give me the top markets with current odds, spreads, and volume so I can gauge consensus expectations."}],"resultDescription":"A flat JSON object with status, meta (freshness timestamp), and data containing the top matching open prediction markets — each with market name, outcome probabilities, best bid, best ask, spread, volume, liquidity, end date, and a direct Polymarket event link.","failureModes":["Empty results if no open markets match the query string","Stale odds if Polymarket data feed is delayed","HTTP 402 if USDC payment is not provided or fails","HTTP 400 if the required 'query' parameter is missing","Results may not include recently created markets if index hasn't refreshed"],"whenToPreferThis":"Choose this endpoint when you need to search Polymarket by arbitrary free-text topic rather than browsing top-volume markets; it is 5x cheaper than comparable prediction market search APIs and returns richer metadata (spread, liquidity, bid/ask) in a single flat JSON response without needing to parse nested structures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:39.015Z","isFirstParty":false}