Skip to main content
GET
/
api
/
v1
/
erc8004
/
browse
ERC-8004 Browse
curl --request GET \
  --url https://api.agentscore.sh/api/v1/erc8004/browse
This is a legacy endpoint. Not recommended for new integrations.

​
Overview

Returns a paginated, filterable list of ERC-8004 registered agents with their scores and dimension breakdowns. No authentication required.

​
Query parameters

​
limit
number
default:"50"
Results per page. Maximum 100.
​
offset
number
default:"0"
Pagination offset.
​
chain
string
Filter by chain: ethereum, base, arbitrum, optimism, avalanche, linea, celo.
​
grade
string
Filter by grade: A, B, C, D, F.
​
min_score
number
Minimum score threshold.

​
Example

curl "https://api.agentscore.sh/api/v1/erc8004/browse?chain=ethereum&grade=A&limit=2"
Response
{
  "agents": [
    {
      "tokenId": 13026,
      "chain": "ethereum",
      "owner": "0x3273786c3add9092F3fbF0201013B4532bD780f7",
      "name": "Silverback",
      "score": 59,
      "grade": "A",
      "dimensions": {
        "identity": 85,
        "activity": 0,
        "capability": 70,
        "reach": 0,
        "trust": 85
      }
    },
    {
      "tokenId": 22778,
      "chain": "ethereum",
      "owner": "0x739c393cCB9a42E0F94a3B433b8B3dF9794087BB",
      "name": "OnchainExpat x402 APIs",
      "score": 59,
      "grade": "A",
      "dimensions": {
        "identity": 85,
        "activity": 0,
        "capability": 70,
        "reach": 0,
        "trust": 85
      }
    }
  ],
  "total": 514,
  "limit": 2,
  "offset": 0,
  "weights": {
    "identity": 0.2,
    "activity": 0.2,
    "capability": 0.3,
    "reach": 0.05,
    "trust": 0.25
  },
  "version": "v1"
}

​
Response fields

FieldTypeDescription
agentsarrayArray of agent objects
agents[].tokenIdnumberERC-8004 token ID
agents[].chainstringChain the agent is registered on
agents[].ownerstringOwner wallet address
agents[].namestringRegistered agent name
agents[].scorenumberComposite score
agents[].gradestringLetter grade
agents[].dimensionsobject5 dimension scores (0-100): identity, activity, capability, reach, trust
totalnumberTotal agents matching the query
limitnumberResults per page
offsetnumberCurrent pagination offset
weightsobjectScoring weights per dimension
versionstringScoring model version