# Web3Identity Token Categories List

> Web3Identity Token Categories List is a paid API for AI agents from api.web3identity.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns all token categories with item counts and aggregated market capitalization data

## Facts

- Endpoint: GET https://api.web3identity.com/api/tokens/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-web3identity-com-14d0c26f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uJuzlsWT6afRqHkn8vsFD

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-web3identity-com-14d0c26f
```

Example prompt: Give me a full list of all crypto token categories right now, including how many tokens are in each one and their total market cap figures.

## When to prefer this

Use this endpoint when you need a high-level taxonomy of the cryptocurrency market organized by category, including counts and market cap aggregates per category. Ideal for building market overviews, sector analysis dashboards, or when you need to understand which crypto sectors exist before drilling into individual tokens.

## Known failure modes

- API returns 402 if payment header is missing or insufficient
- Empty categories array if market data is temporarily unavailable
- Rate limiting if too many calls are made in quick succession
- Stale market cap data if the underlying price feeds are delayed

## How this service works

List all token categories with counts and market data

## Output

An array of token category objects, each containing the category name, the count of tokens in that category, and the total market capitalization for that category.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "categories": {
       "type": "array",
       "items": {
        "properties": {
         "name": {
          "type": "string"
         },
         "count": {
          "type": "number"
         },
         "totalMarketCap": {
          "type": "number"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-web3identity-com-14d0c26f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.web3identity.com](https://www.zero.xyz/host/api.web3identity.com/llms.txt)