{"uid":"cap_kBV7dAUZHvmQFQdDSyNqG","slug":"api-nansen-ai-195825bb","name":"Nansen Prediction Market Categories","description":"Get Prediction Market Categories","url":"https://api.nansen.ai/api/v1/prediction-market/categories","method":"GET","headers":{},"bodySchema":{"type":"object","title":"CategoriesRequest","examples":[{"pagination":{"page":1,"per_page":10}}],"properties":{"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."}},"description":"Request for categories endpoint (pagination only).","additionalProperties":false},"responseSchema":{"type":"object","title":"CategoriesResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"CategoryItem","required":["category"],"properties":{"category":{"type":"string","title":"Category","examples":["Politics"],"description":"Category name"},"total_volume":{"anyOf":[{"type":"number"}],"title":"Total Volume","description":"Total volume (USD)"},"top_market_id":{"anyOf":[{"type":"string"}],"title":"Top Market Id","description":"Top market by 24h volume"},"active_markets":{"anyOf":[{"type":"integer"}],"title":"Active Markets","description":"Number of active markets"},"total_volume_1wk":{"anyOf":[{"type":"number"}],"title":"Total Volume 1Wk","description":"Total 1 week volume (USD)"},"total_traders_24h":{"anyOf":[{"type":"integer"}],"title":"Total Traders 24H","description":"Total unique traders in 24h"},"total_volume_24hr":{"anyOf":[{"type":"number"}],"title":"Total Volume 24Hr","description":"Total 24h volume (USD)"},"top_market_question":{"anyOf":[{"type":"string"}],"title":"Top Market Question","description":"Top market question"},"total_open_interest":{"anyOf":[{"type":"number"}],"title":"Total Open Interest","description":"Total open interest (USD)"},"top_market_volume_24hr":{"anyOf":[{"type":"number"}],"title":"Top Market Volume 24Hr","description":"Top market 24h volume"}},"description":"Category data from ch_api_pm_categories."},"title":"Data","description":"List of category records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response for categories endpoint."},"example":{"request":{"pagination":{"limit":10,"offset":0}},"response":{"data":[{"category":"Sports","total_volume":2540551078,"top_market_id":"558984","active_markets":26319,"total_volume_1wk":555722115,"total_traders_24h":146883,"total_volume_24hr":152768385,"top_market_question":"Will Czechia win the 2026 FIFA World Cup?","total_open_interest":2403167323,"top_market_volume_24hr":6160506.049},{"category":"Soccer","total_volume":2111820966,"top_market_id":"558984","active_markets":14810,"total_volume_1wk":506088788,"total_traders_24h":95185,"total_volume_24hr":133016265,"top_market_question":"Will Czechia win the 2026 FIFA World Cup?","total_open_interest":2225243730,"top_market_volume_24hr":6160506.049},{"category":"Politics","total_volume":3806826584,"top_market_id":"2270330","active_markets":5629,"total_volume_1wk":218455898,"total_traders_24h":72191,"total_volume_24hr":44039742,"top_market_question":"US x Iran permanent peace deal by June 15, 2026?","total_open_interest":1487059699,"top_market_volume_24hr":6921720.298281006},{"category":"Geopolitics","total_volume":688240302,"top_market_id":"2270330","active_markets":961,"total_volume_1wk":111131827,"total_traders_24h":38619,"total_volume_24hr":30091958,"top_market_question":"US x Iran permanent peace deal by June 15, 2026?","total_open_interest":246044819,"top_market_volume_24hr":6921720.298281006},{"category":"Trump","total_volume":399526280,"top_market_id":"2270330","active_markets":1168,"total_volume_1wk":61769278,"total_traders_24h":21148,"total_volume_24hr":18625551,"top_market_question":"US x Iran permanent peace deal by June 15, 2026?","total_open_interest":129367348,"top_market_volume_24hr":6921720.298281006},{"category":"Elections","total_volume":2879752405,"top_market_id":"947289","active_markets":3494,"total_volume_1wk":82776694,"total_traders_24h":24869,"total_volume_24hr":9340045,"top_market_question":"Will Roberto Sánchez Palomino win the 2026 Peruvian presidential election?","total_open_interest":1082163734,"top_market_volume_24hr":1840658.316464999},{"category":"Economy","total_volume":199065930,"top_market_id":"1971905","active_markets":772,"total_volume_1wk":46006416,"total_traders_24h":9304,"total_volume_24hr":8806454,"top_market_question":"Strait of Hormuz traffic returns to normal by end of June?","total_open_interest":130628952,"top_market_volume_24hr":1684478.3538389916},{"category":"World","total_volume":622772107,"top_market_id":"665374","active_markets":782,"total_volume_1wk":36611593,"total_traders_24h":17820,"total_volume_24hr":6811695,"top_market_question":"Will the U.S. invade Iran before 2027?","total_open_interest":268412726,"top_market_volume_24hr":1126999.7952390013},{"category":"Tennis","total_volume":22021708,"top_market_id":"1088147","active_markets":2511,"total_volume_1wk":5891426,"total_traders_24h":9282,"total_volume_24hr":4528788,"top_market_question":"Will Jelena Ostapenko be the 2026 Women’s Wimbledon Winner?","total_open_interest":10025629,"top_market_volume_24hr":889153.428333},{"category":"Basketball","total_volume":75728979,"top_market_id":"553858","active_markets":833,"total_volume_1wk":14970876,"total_traders_24h":8534,"total_volume_24hr":4412481,"top_market_question":"Will the New York Knicks win the 2026 NBA Finals?","total_open_interest":47362044,"top_market_volume_24hr":1550239.7646309992}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"pagination":{"limit":10,"offset":0}},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IIe9iskISz0Nm8McXaei-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the available categories for prediction markets tracked by Nansen's analytics platform","exampleAgentPrompt":"Can you pull up the full list of prediction market categories available on Nansen so I know what topics and segments I can filter by?","exampleUseCases":null,"resultDescription":"A list of prediction market categories tracked by Nansen, including category names and identifiers that can be used to filter or query other prediction market endpoints.","failureModes":["Invalid or malformed POST body returns 400 error","Authentication failure returns 401 or 403","Service unavailable or rate-limited returns 429 or 500","Empty result if no categories are currently indexed"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate the available taxonomy of prediction market categories on Nansen before querying specific markets, positions, or holders. It serves as a prerequisite lookup for downstream prediction market queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:28.489Z","isFirstParty":false}