Agent Directory Endpoint

GET /v1/directory

Query the indexed agent directory with filters and sorting.

Endpoint URL

https://agent-api.fairscale.xyz/v1/directory

Parameter	Type	Required	Default	Description
`page`	number	No	`1`	Page number
`limit`	number	No	`25`	Results per page (max 100)
`sort`	string	No	`agent_fairscore`	Sort field: `agent_fairscore`, `verification`, `wallet_history`, `work_history`, `network_quality`, `peer_reputation`
`source`	string	No	-	Filter by registry: `said`, `erc8004`, `sati`
`min_score`	number	No	-	Minimum score filter
`verified_only`	boolean	No	-	`true` to return only registry-verified agents
`recommendation`	string	No	-	Filter by tier: `trusted`, `caution`, `high_risk`, `unverified`
`search`	string	No	-	Search agent names or descriptions
`has_attestations`	boolean	No	-	`true` to return only agents with on-chain attestations

curl "https://agent-api.fairscale.xyz/v1/directory?sort=work_history&source=erc8004&min_score=60&limit=10" \
  -H "fairkey: zpka_your_key_here"

GET /v1/leaderboard

Top-scoring agents across the indexed directory.

https://agent-api.fairscale.xyz/v1/leaderboard

Parameter	Type	Required	Default	Description
`metric`	string	No	`agent_fairscore`	Sort metric
`limit`	number	No	`25`	Number of results

curl "https://agent-api.fairscale.xyz/v1/leaderboard?metric=work_history&limit=10" \
  -H "fairkey: zpka_your_key_here"