Skip to main content

​
Base URL

All API requests use the following base URL: 
https://api.agentscore.sh

​
Authentication

Every request must include an API key in the X-API-Key header: 
curl -H "X-API-Key: as_live_your_key_here" \
  https://api.agentscore.sh/v1/stats
Get your API key from the dashboard. Requests without a valid API key receive: 
{
  "error": {
    "code": "signup_required",
    "message": "Sign up for a free account to use the AgentScore API.",
    "signup_url": "https://agentscore.sh/sign-up"
  }
}

​
Tiers

FreePaid ($49/mo)Enterprise
Rate limit1 req/sec10 req/secUnlimited
GET /v1/agentsYesYesYes
GET /v1/reputation/:addressYesYesYes
GET /v1/statsYesYesYes
POST /v1/assessNoYesYes
Custom policiesNoNoYes
SupportCommunityEmailDedicated

​
Endpoints

MethodPathDescriptionMin Tier
GET/v1/agentsBrowse ERC-8004 agentsFree
GET/v1/reputation/{address}Cached reputation lookupFree
POST/v1/assessOn-the-fly trust assessmentPaid
GET/v1/statsEcosystem statisticsFree

​
Response format

All responses are JSON. Successful responses return HTTP 200. Errors return the appropriate HTTP status code with an error object: 
{
  "error": {
    "code": "error_code",
    "message": "Human-readable description."
  }
}

​
Versioning

The API is versioned via the URL path (/v1/). Breaking changes will be introduced under a new version prefix.