Skip to main content
GET
/
v1
/
reputation
/
{address}
GET /v1/reputation/{address}
curl --request GET \
  --url https://api.agentscore.sh/v1/reputation/{address}

Request

Headers

HeaderRequiredDescription
X-API-KeyYesYour API key

Path parameters

ParameterTypeDescription
addressstringEVM wallet address (0x…)

Query parameters

ParameterTypeDefaultDescription
chainstringbaseChain to query

Response

{
  "subject": {
    "chain": "base",
    "address": "0xdb5aa553feeb2c3e3d03e8360b36fb0f7e480671"
  },
  "classification": {
    "entity_type": "agent",
    "confidence": 0.92,
    "is_known": true,
    "is_known_erc8004_agent": true,
    "has_candidate_payment_activity": true,
    "has_verified_payment_activity": false,
    "reasons": ["erc8004_registered", "has_endpoints"]
  },
  "score": {
    "status": "scored",
    "value": 68.2,
    "grade": "B",
    "confidence": 0.85,
    "dimensions": {
      "identity": 85,
      "activity": 35,
      "capability": 70,
      "reach": 50,
      "trust": 72
    },
    "scored_at": "2026-03-10T12:00:00Z",
    "version": "v2"
  },
  "identity": {
    "ens_name": null,
    "website_url": "https://paybot.example.com",
    "github_url": null,
    "erc8004": {
      "chain": "base",
      "token_id": 42,
      "registry_contract": "0x...",
      "name": "PayBot",
      "description": "Autonomous payment agent",
      "metadata_quality": "good",
      "endpoint_count": 3
    }
  },
  "activity": {
    "total_candidate_transactions": 142,
    "total_verified_transactions": 0,
    "as_candidate_payer": 80,
    "as_candidate_payee": 62,
    "as_verified_payer": 0,
    "as_verified_payee": 0,
    "counterparties_count": 17,
    "active_days": 45,
    "active_months": 3,
    "first_candidate_tx_at": "2026-01-15T08:30:00Z",
    "last_candidate_tx_at": "2026-03-10T10:22:00Z",
    "first_verified_tx_at": null,
    "last_verified_tx_at": null
  },
  "evidence_summary": {
    "website_url": "https://paybot.example.com",
    "github_url": null,
    "github_stars": null,
    "metadata_kind": "real",
    "website_reachable": true,
    "website_mentions_mcp": false,
    "website_mentions_x402": false,
    "has_a2a_agent_card": false
  },
  "data_semantics": "candidate_payment_activity_with_verified_subset",
  "caveats": [],
  "updated_at": "2026-03-10T12:00:00Z"
}

Score status values

StatusMeaning
scoredScore is fresh (computed within 24h)
staleScore exists but is older than 24h. Use POST /v1/assess for a fresh evaluation.
known_unscoredAddress is indexed but has not been scored yet

Unknown address (404)

If the address has not been indexed:
{
  "error": {
    "code": "unknown_address",
    "message": "Address not yet indexed.",
    "can_assess": true
  }
}
Use POST /v1/assess to score any address on-the-fly, including unknown ones.
This endpoint is read-only. It returns cached data and never triggers scoring. For fresh, on-the-fly scoring, use POST /v1/assess (paid tier required).