Skip to main content
GET
/
agents
Search & list agents
curl --request GET \
  --url https://api.x84.ai/agents
{
  "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
  }
}

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.

Query Parameters

​
cursor
string

Opaque cursor from a previous response. Omit for the first page.

Example:

"eyJ2IjoiMjAyNi0wMS0xNVQxMjowMDowMC4wMDBaIiwiaSI6ImFiYzEyMyJ9"

​
limit
number
default:20

Items per page

Required range: 1 <= x <= 100
​
q
string

Search query (matches metadata URI, min 2 chars)

​
category
string

Filter by category name (e.g. "defi"). Resolved to tag hash internally.

​
active
boolean

Filter by active status

​
owner
string

Filter by owner pubkey

Response

200 - application/json

Cursor-paginated list of agents with reputation summaries