{"uid":"cap_riusgnWUsI8m4dowU1IxS","slug":"polymarket-markets-by-category-tag-d5bf0e32","name":"Polymarket Markets by Category Tag","description":"Polymarket markets filtered by category tag id (politics, crypto, sports, etc.): question, outcome prices, volume. Free Polymarket Gamma data. Use polymarket-tags to discover tag ids.","url":"https://proxy.suverse.io/v1/data/polymarket-markets-by-tag","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RdnnXwpPU9cZjz8zVvPsf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Polymarket prediction market listings filtered by a category tag ID, including questions, outcome prices, and trading volume.","exampleAgentPrompt":"Pull all the current Polymarket prediction markets in the politics category — I want to see the questions, outcome prices, and trading volume for each one.","exampleUseCases":[{"title":"Monitor election prediction markets","prompt":"Show me all the active Polymarket politics markets right now — I want to track the outcome prices and volume for any election-related questions."},{"title":"Crypto market sentiment dashboard","prompt":"Fetch all the Polymarket markets tagged under crypto so I can see what traders are betting on and what the current outcome probabilities look like."},{"title":"Sports betting odds tracker","prompt":"Get me the current Polymarket sports markets — list all the questions, the outcome prices, and how much volume each one has traded."}],"resultDescription":"A list of Polymarket prediction markets matching the specified category tag, each including the market question text, outcome option prices (probabilities), and cumulative trading volume.","failureModes":["Invalid or unknown tag ID returns empty results or an error","Tag ID not found — use polymarket-tags endpoint first to discover valid IDs","API returns stale data if Polymarket Gamma feed is delayed","Payment failure (x402) if USDC balance is insufficient for the $0.05 call","Malformed POST body or wrong bodyType causes 400-level error"],"whenToPreferThis":"Use this endpoint when you need to browse or monitor Polymarket prediction markets organized by topic category (politics, crypto, sports, etc.) and want free Gamma data without direct Polymarket API integration. Pair with the polymarket-tags endpoint to discover valid tag IDs first. Prefer this over scraping Polymarket directly or using unfiltered market dumps when you need category-scoped results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:03:18.678Z","isFirstParty":false}