{"uid":"cap_oIt-ekBEderAhXWAQOXBO","slug":"polymarket-market-search-0d4ba162","name":"Polymarket Market Search","description":"Search active Polymarket markets by keyword. Returns the top matches sorted by 24h volume, with question, current outcome prices (implied probabilities), volume, liquidity, end date, and CLOB token ids for orderbook lookups.","url":"https://agent402.tools/api/polymarket-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max markets to return (1-50, default 10)."},"query":{"type":"string","description":"Keyword to search market questions, slugs, and descriptions."},"activeOnly":{"type":"boolean","description":"Filter to active+open markets only (default true)."}}},"responseSchema":{"type":"json","example":{"count":1,"query":"election","source":"polymarket-gamma","markets":[{"id":"12345","slug":"will-x-win-election","venue":"polymarket","active":true,"closed":false,"prices":[0.62,0.38],"volume":1234567.89,"endDate":"2026-11-03T23:59:00Z","outcomes":["Yes","No"],"question":"Will X win the election?","venueUrl":"https://polymarket.com/market/will-x-win-election","clobTokenIds":["7290..."]}],"scannedMarkets":57,"searchExhausted":false,"searchedKeywordIndex":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1U_kq5rjBWbaDjfUxGbSQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches active Polymarket prediction markets by keyword, returning top matches sorted by 24h volume with prices, probabilities, liquidity, and CLOB token IDs.","exampleAgentPrompt":"Search Polymarket for active markets about the 2024 US presidential election and show me the top 5 results sorted by volume, including current odds and liquidity.","exampleUseCases":null,"resultDescription":"Returns a ranked list of matching Polymarket markets (up to the requested limit), each with the market question, current outcome prices as implied probabilities, 24-hour trading volume, available liquidity, market end date, and CLOB token IDs that can be used for orderbook lookups.","failureModes":["No markets found for obscure or misspelled keywords — returns empty results","Query too broad returns irrelevant markets ranked by volume","Market data may be stale if Polymarket API is slow or rate-limited","Limit parameter outside 1-50 range may cause validation error","Payment failure (402) if USDC balance insufficient for $0.002 call cost"],"whenToPreferThis":"Use this endpoint when you need to discover and evaluate Polymarket prediction markets by topic or keyword, especially when you want current implied probabilities and liquidity metrics sorted by recent trading activity. Ideal for agents building trading strategies, monitoring event probabilities, or surfacing relevant markets for a given news topic. Prefer this over manual Polymarket browsing when you need CLOB token IDs for subsequent orderbook queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:04.657Z","isFirstParty":false}