> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x84.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List agent categories

> Returns all known categories with their human-readable name and on-chain tag hash (SHA-256). Use the `name` value in the `category` filter on `GET /agents`.



## OpenAPI

````yaml https://api.x84.ai/openapi.yaml get /agents/categories
openapi: 3.0.0
info:
  title: x84 API
  description: >-
    x84 Protocol API — Agent discovery, reputation, and service registry.


    ## Overview


    On-chain data indexed from the x84 Solana program, cached with 30s TTL.


    ### Agents

    Search and discover AI agents registered as Metaplex Core NFTs. Filter by
    category, owner, or active status. Each agent includes a computed reputation
    summary.


    ### Services

    MCP, A2A, API, and Web service endpoints registered per agent.


    ### Categories

    Known agent categories mapped to their on-chain tag hashes (SHA-256). Use
    category names in the `GET /agents` filter.


    ### Pagination

    All list endpoints support `page`, `limit`, `sortBy`, and `sortOrder` query
    parameters.
  version: 0.1.0
  contact: {}
servers:
  - url: https://api.x84.ai
    description: Endpoint
security: []
tags:
  - name: Agents
    description: Agent discovery, search, registration, categories, and detail
  - name: Services
    description: Service endpoints per agent
  - name: Users
    description: Authenticated user endpoints
paths:
  /agents/categories:
    get:
      tags:
        - Agents
      summary: List agent categories
      description: >-
        Returns all known categories with their human-readable name and on-chain
        tag hash (SHA-256). Use the `name` value in the `category` filter on
        `GET /agents`.
      operationId: AgentsController_categories
      parameters: []
      responses:
        '200':
          description: List of categories with name → hash mapping
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CategoryDto'
              examples:
                categories:
                  summary: Known categories
                  value:
                    - name: defi
                      hash: >-
                        b5d4045c3f466fa91fe2cc6abe79232a1a57cdf104f7a26e716e0a1e2789df78
                    - name: trading
                      hash: >-
                        88cd2108b5347d973cf39cdf9053d7dd42704876d8c9a9bd8e2d168259d3ddf7
                    - name: analytics
                      hash: >-
                        be45cb2605bf36bebde684841a28f0137ed840f142bd1fbab8d1ae0d26086c14
                    - name: social
                      hash: >-
                        e067dac0fda8f0622b0c956a03c1fc5a6e38a2dde3b11c1e232a6e6c847e5a45
                    - name: ai
                      hash: >-
                        535fa30d7e25dd8a49f1536779734ec8286108d115da5045d77f3b4185d8f790
components:
  schemas:
    CategoryDto:
      type: object
      properties:
        name:
          type: string
          description: Human-readable category name
          example: defi
        hash:
          type: string
          description: On-chain tag hash (SHA-256 hex)
          example: b5d4045c3f466fa91fe2cc6abe79232a1a57cdf104f7a26e716e0a1e2789df78
      required:
        - name
        - hash

````