{"uid":"cap_Rdw1JBUE-alrtArb6OHg9","slug":"nansen-categories-eac6ed38","name":"Nansen Prediction Market Categories","description":"Get aggregated statistics for all prediction market categories. Shows volume,\nopen interest, and top markets per category.\n\n**What it helps to answer:**\n\n1. **Which prediction market categories have the most activity?**\n2. **What is the volume breakdown by category?**\n3. **What are the top markets in each category?**","url":"https://api.nansen.ai/api/v1/prediction-market/categories?utm_source=zero.xyz","method":"POST","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":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VT3TphAQROJrxJHG_4gw3","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns aggregated statistics (volume, open interest, active markets, top markets) for all prediction market categories.","exampleAgentPrompt":"Show me all prediction market categories tracked by Nansen — I want to see which ones have the highest 24-hour volume, total open interest, and what the top market question is in each category. Give me the first 10 categories.","exampleUseCases":null,"resultDescription":"A paginated list of prediction market categories, each with total USD volume, 24h volume, 1-week volume, total open interest, number of active markets, unique traders in the last 24 hours, and the top market by 24h volume including its ID and question text. Includes pagination metadata indicating current page and whether it is the last page.","failureModes":["Invalid pagination parameters (page < 1 or per_page > 1000) return a 422 validation error","Insufficient USDC balance causes a payment failure before data is returned","Empty data array returned if no categories are currently tracked","Network timeout if the analytics backend is under heavy load"],"whenToPreferThis":"Use this endpoint when you need a high-level overview of the prediction market landscape across all categories, including relative activity levels, volume rankings, and leading market questions per category. Prefer this over individual market endpoints when you want to compare categories rather than drill into specific markets or events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:53:27.975Z","isFirstParty":false,"canonicalSlug":"api-nansen-ai-195825bb"}