> ## 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.

# Search & list agents

> Search agents by metadata URI, filter by category, owner, or active status. Uses cursor-based pagination for efficient traversal. All parameters are optional — without filters returns all agents sorted by most recently updated.



## OpenAPI

````yaml https://api.x84.ai/openapi.yaml get /agents
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:
    get:
      tags:
        - Agents
      summary: Search & list agents
      description: >-
        Search agents by metadata URI, filter by category, owner, or active
        status. Uses cursor-based pagination for efficient traversal. All
        parameters are optional — without filters returns all agents sorted by
        most recently updated.
      operationId: AgentsController_list
      parameters:
        - name: cursor
          required: false
          in: query
          description: Opaque cursor from a previous response. Omit for the first page.
          schema:
            example: eyJ2IjoiMjAyNi0wMS0xNVQxMjowMDowMC4wMDBaIiwiaSI6ImFiYzEyMyJ9
            type: string
        - name: limit
          required: false
          in: query
          description: Items per page
          schema:
            minimum: 1
            maximum: 100
            default: 20
            type: number
        - name: q
          required: false
          in: query
          description: Search query (matches metadata URI, min 2 chars)
          schema:
            type: string
        - name: category
          required: false
          in: query
          description: >-
            Filter by category name (e.g. "defi"). Resolved to tag hash
            internally.
          schema:
            type: string
        - name: active
          required: false
          in: query
          description: Filter by active status
          schema:
            type: boolean
        - name: owner
          required: false
          in: query
          description: Filter by owner pubkey
          schema:
            type: string
      responses:
        '200':
          description: Cursor-paginated list of agents with reputation summaries
          content:
            application/json:
              examples:
                agents-list:
                  summary: Agents with cursor
                  value:
                    data:
                      - nftMint: DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy
                        owner: D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu
                        metadataUri: https://arweave.net/abc123
                        categories:
                          - defi
                          - trading
                        active: true
                        reputation:
                          verifiedCount: 42
                          verifiedAvgScore: 90
                          unverifiedCount: 5
                          unverifiedAvgScore: 72
                          validationCount: 3
                      - nftMint: FbA1EbECHnpmVGirBGhCRjtek8VDaL6DT3sQqQU4NXHV
                        owner: 7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX
                        metadataUri: https://arweave.net/def456
                        categories:
                          - analytics
                        active: true
                        reputation:
                          verifiedCount: 18
                          verifiedAvgScore: 85
                          unverifiedCount: 2
                          unverifiedAvgScore: 60
                          validationCount: 1
                    cursor:
                      next: >-
                        eyJ2IjoiMjAyNi0wMS0xNVQxMjowMDowMC4wMDBaIiwiaSI6ImFiYzEyMyJ9
                      hasMore: true
                empty-results:
                  summary: No agents found
                  value:
                    data: []
                    cursor:
                      next: null
                      hasMore: false
                last-page:
                  summary: Last page (no more results)
                  value:
                    data:
                      - nftMint: DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy
                        owner: D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu
                        metadataUri: https://arweave.net/abc123
                        categories:
                          - defi
                        active: true
                        reputation:
                          verifiedCount: 42
                          verifiedAvgScore: 90
                          unverifiedCount: 0
                          unverifiedAvgScore: 0
                          validationCount: 0
                    cursor:
                      next: null
                      hasMore: false

````