{"uid":"cap_8dSYQGwhyi1YXA218YYw3","slug":"polymarket-best-markets-to-watch-923e9b70","name":"Polymarket Best Markets to Watch","description":"Best Markets to Watch ($0.02/call): The best Polymarket prediction markets to watch right now, ranked by a composite watch-score (24h volume, liquidity, competitiveness, momentum, time-to-resolution). Filter by tag. Returns implied probability, volume, liquidity, spread and a plain-English reason for each. Live data, no account needed.","url":"https://x402.botsmith.dev/polymarket/markets","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":["limit","sort"],"properties":{"tag":{"type":"string","description":"Filter by a Polymarket tag slug, e.g. 'politics', 'crypto', 'sports'"},"sort":{"enum":["watch","volume","liquidity"],"type":"string","default":"watch","description":"Ranking: 'watch' = composite watch-score (default), or raw volume/liquidity"},"limit":{"type":"integer","default":10,"maximum":25,"minimum":1,"description":"How many markets to return"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["count","sort","markets"],"properties":{"sort":{"type":"string"},"count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"markets":{"type":"array","items":{"type":"object","required":["question","slug","url","yesPrice","volume24hr","liquidity","spread","priceChange24h","daysToResolution","watchScore","why"],"properties":{"url":{"type":"string"},"why":{"type":"string","description":"Short human-readable reason this market ranks"},"slug":{"type":"string"},"spread":{"anyOf":[{"type":"number"},{"type":"null"}]},"question":{"type":"string"},"yesPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Implied probability of the first outcome (0-1)"},"liquidity":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume24hr":{"anyOf":[{"type":"number"},{"type":"null"}]},"watchScore":{"type":"number","description":"0-100 composite: activity, depth, competitiveness, momentum, timing"},"priceChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"daysToResolution":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kv0mmBCfRGqpN-hiZqA0W","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top Polymarket prediction markets ranked by a composite watch-score based on volume, liquidity, competitiveness, momentum, and time-to-resolution, with optional tag filtering.","exampleAgentPrompt":"Show me the top 5 crypto prediction markets on Polymarket right now, ranked by the composite watch-score, with their implied probabilities and a quick reason why each is worth watching.","exampleUseCases":null,"resultDescription":"A ranked list of Polymarket prediction markets, each including the question, URL, implied probability (yes price 0-1), 24h volume, liquidity, bid-ask spread, 24h price change, days until resolution, a 0-100 composite watch-score, and a plain-English sentence explaining why the market ranks. The response includes the count and the sort method used.","failureModes":["Invalid tag slug returns empty markets array or 404","Limit outside 1-25 range causes validation error","Sort value not in enum causes 400 bad request","Polymarket data temporarily unavailable causes 503 or stale data","Payment failure (x402) blocks request before reaching endpoint"],"whenToPreferThis":"Use this endpoint when you want a curated, ranked discovery view of Polymarket markets — especially when you don't know which specific market to look at and want algorithmically scored recommendations. Prefer over the sibling Market Intel endpoint when you need broad discovery rather than deep analysis of one market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:40:12.269Z","isFirstParty":false}