# Nansen Prediction Market Categories

> Nansen Prediction Market Categories is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.01/call, status unknown (last checked 2026-10-09).

Returns aggregated statistics (volume, open interest, active markets, top markets) for all prediction market categories.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/prediction-market/categories?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-categories-eac6ed38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Rdw1JBUE-alrtArb6OHg9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-categories-eac6ed38 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get aggregated statistics for all prediction market categories. Shows volume,
open interest, and top markets per category.

**What it helps to answer:**

1. **Which prediction market categories have the most activity?**
2. **What is the volume breakdown by category?**
3. **What are the top markets in each category?**

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
}
```

## Response schema (JSON Schema)

```json
{
 "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": {
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-categories-eac6ed38/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)