{"uid":"cap_p_iI7O5DVUoIvFsfJTKtJ","slug":"polymarket-search-1b05fcb8","name":"Polymarket Search","description":"Search open Polymarket prediction markets by keyword (election, bitcoin, fed, AI...) and get each event's markets with live outcome probabilities, best bid/ask, 24h and total volume, liquidity, end date and link. Use to answer what the market thinks will happen, or to find a market to trade.","url":"https://bess-x402.onrender.com/v1/predictions/polymarket/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search words"},"limit":{"type":"integer","description":"Maximum number of results (1-30)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-8jpBmkapKxc_IePk2Hoe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Polymarket prediction markets by keyword and retrieve live outcome probabilities, bid/ask spreads, volume, liquidity, and links for matching events.","exampleAgentPrompt":"What does Polymarket currently think about the Fed cutting interest rates — show me the live odds, volume, and best bid/ask for the top 5 matching markets.","exampleUseCases":[{"title":"Election outcome probability check","prompt":"Search Polymarket for election markets and show me the current probabilities for each outcome, including liquidity and end dates — I want to see up to 10 results."},{"title":"Bitcoin price prediction markets","prompt":"What does Polymarket think will happen with Bitcoin this year? Find me the open prediction markets about BTC price with their live odds and 24h volume."},{"title":"Fed rate decision market research","prompt":"Look up Polymarket markets related to Fed rate cuts and give me the outcome probabilities, best bid/ask prices, and total volume for each one."}],"resultDescription":"A list of matching Polymarket events, each containing one or more markets with: the question text, current outcome probabilities for each option, best bid and ask prices, 24-hour and total trading volume, available liquidity, market end/resolution date, and a direct link to the market on Polymarket.","failureModes":["No markets found for the keyword — returns empty result set","Query string missing — returns 400 bad request","Limit out of range (below 1 or above 30) — returns validation error","Polymarket API upstream unavailable — returns 502/503 error","Rate limiting or payment verification failure — returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need to discover multiple Polymarket prediction markets matching a topic keyword and want live probability data at scale. Prefer this over the single-market endpoint when you don't have a specific market slug or ID and want to explore what markets exist. Best for answering 'what does the market think about X' questions across a broad topic area.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:41:52.146Z","isFirstParty":false,"canonicalSlug":"polymarket-search-1b05fcb8"}