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 } }

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