Skip to main content
GET
/
v1
/
agents
GET /v1/agents
curl --request GET \
  --url https://api.agentscore.sh/v1/agents

​
Request

​
Headers

HeaderRequiredDescription
X-API-KeyYesYour API key

​
Query parameters

ParameterTypeDefaultDescription
chainstring—Filter by chain (base, ethereum, arbitrum, etc.)
limitinteger25Results per page (max 100)
cursorstring—Cursor for next page (from next_cursor)
offsetinteger0Offset for pagination (alternative to cursor)
gradestring—Filter by grade (A, B, C, D, F)
min_scorenumber—Minimum score threshold
metadata_qualitystring—Filter by metadata quality
entity_typestring—Filter by entity type (agent, service, hybrid, etc.)
has_endpointboolean—Filter to agents with endpoints
has_candidate_payment_activityboolean—Filter to agents with candidate payment activity
has_verified_payment_activityboolean—Filter to agents with verified payment activity

​
Response

{
  "items": [
    {
      "chain": "base",
      "token_id": 42,
      "owner_address": "0x1234...abcd",
      "agent_wallet": "0x5678...ef01",
      "name": "PayBot",
      "description": "Autonomous payment agent",
      "metadata_quality": "real",
      "score": 68.2,
      "grade": "B",
      "entity_type": "agent",
      "endpoint_count": 3,
      "website_url": "https://paybot.example.com",
      "github_url": "https://github.com/paybot",
      "has_candidate_payment_activity": true,
      "has_verified_payment_activity": false,
      "agents_sharing_owner": 1,
      "updated_at": "2026-03-10T12:00:00Z"
    }
  ],
  "next_cursor": "68.2:42",
  "count": 47200,
  "version": "v2"
}

​
Response fields

FieldTypeDescription
itemsarrayList of agent objects
items[].agent_walletstring|nullAgent’s wallet address (if different from owner)
items[].descriptionstring|nullAgent description from metadata
items[].metadata_qualitystringMetadata quality level (real, placeholder, unknown)
items[].github_urlstring|nullGitHub URL from metadata
items[].agents_sharing_ownerintegerNumber of agents registered under the same owner. When > 1, payment data is shared.
next_cursorstring|nullCursor for next page, null if no more results
countintegerTotal matching agents
versionstringAPI version
Scores in the browse view may be cached. For live scoring, use POST /v1/assess.