# Nansen Prediction Market Categories

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

Retrieves the available categories for prediction markets tracked by Nansen's analytics platform

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/prediction-market/categories
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-195825bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kBV7dAUZHvmQFQdDSyNqG

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 api-nansen-ai-195825bb
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get Prediction Market Categories

## Output

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.

## Example request

```json
{
 "pagination": {
  "limit": 10,
  "offset": 0
 }
}
```

## 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/api-nansen-ai-195825bb/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)