# Nansen Token Sectors

> Nansen Token Sectors is a free API for AI agents from Nansen at api.nansen.ai, Free, status unknown (last checked 2026-10-11).

Returns all available token sector categories (e.g., AI Agents, DeFi Lending, Memecoin) that can be used to filter tokens in Nansen's token screener and related endpoints.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/search/token-sectors?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-11
- 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-token-sectors-a5966723
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XODRFvUDuey-6KUvUqYPz

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-token-sectors-a5966723
```

Example prompt: What token sectors are available on Nansen so I can figure out which ones I can use to filter tokens in the screener?

## When to prefer this

Use this endpoint before calling the Nansen token-screener or any endpoint that accepts a token_sector filter parameter — it provides the canonical list of valid sector values. Prefer this over hardcoding sector names, as the available sectors may change over time. It is free (0 credits) and requires no parameters, making it ideal for initialization or UI population tasks.

## Known failure modes

- Authentication failure (401) if API key is missing or invalid
- Rate limiting (429) if too many requests are made
- Service unavailable (503) if Nansen backend is down
- Empty data array if no sectors meet the 50-token threshold (unlikely but possible)

## How this service works

Get all available token sectors that can be used to filter tokens in the token-screener and other endpoints.

This endpoint returns the list of valid sector values that can be used in the `token_sector` filter parameter. Sectors are categories that describe a token's primary use case or market segment (e.g., "Artificial Intelligence", "DeFi Lending", "Memecoin").

**Key Features:**
- Returns all sectors with 50+ tokens (filters out niche/one-off AI-generated sectors)
- Results are ordered alphabetically
- No parameters required
- Free endpoint (0 credits)

**Example Response:**
```json
{
  "data": [
    {"sector": "AI Agents"},
    {"sector": "Artificial Intelligence"},
    {"sector": "DeFi Lending (Money Markets)"},
    {"sector": "GameFi"},
    {"sector": "Memecoin"}
  ]
}
```

**Use Cases:**
1. **Discover filter options**: Get valid sector values before calling token-screener
2. **Build UI filters**: Populate dropdown menus with available sectors
3. **Validate input**: Check if a sector value is valid before making API calls

## Output

An alphabetically ordered array of sector objects, each containing a 'sector' string field with the sector name (e.g., 'AI Agents', 'Artificial Intelligence', 'DeFi Lending (Money Markets)', 'GameFi', 'Memecoin'). Only sectors with 50 or more associated tokens are included.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TokenSectorsResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "TokenSectorItem",
    "required": [
     "sector"
    ],
    "properties": {
     "sector": {
      "type": "string",
      "title": "Sector",
      "description": "Token sector name (e.g., 'Artificial Intelligence', 'DeFi Lending (Money Markets)')"
     }
    },
    "description": "Single token sector result."
   },
   "title": "Data",
   "description": "List of available token sectors (ordered alphabetically)"
  }
 },
 "description": "Response model for token sectors endpoint.\n\nReturns all available token sectors that can be used to filter tokens\nin the token-screener and other endpoints that support sector filtering.\nSectors with fewer than 50 tokens are excluded."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-token-sectors-a5966723/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)