# GraphAdvocate Agent Reputation Scorer

> GraphAdvocate Agent Reputation Scorer is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Scores a wallet's on-chain agent reputation using ERC-8004 registration, IPFS metadata, recent payments, and feedback signals, returning a tiered score with evidence for a specified trailing time window.

## Facts

- Endpoint: POST https://graphadvocate.com/agent/score
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/graphadvocate-agent-reputation-scorer-21da38fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OschyCIliJXG4mAJ4HxWO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability graphadvocate-agent-reputation-scorer-21da38fd -d '<json body>'
```

Example prompt: Can you score the agent reputation for wallet 0x1234abcd...5678 over the last 30-day trailing window — I want to know its tier, recent payment activity, and what feedback signals back it up?

## When to prefer this

Choose this endpoint when you need to assess the trustworthiness or activity level of an on-chain AI agent wallet before interacting with it, delegating funds, or routing tasks. It is specifically designed for ERC-8004 registered agents and combines registration, IPFS metadata, payment history, and feedback into a single tiered score — making it more comprehensive than raw on-chain balance checks or simple transaction history lookups.

## Known failure modes

- Wallet address not registered under ERC-8004 — returns low score or unranked tier with missing registration evidence
- IPFS metadata unavailable or unresolvable — partial score with missing metadata signals
- No recent payment activity in the trailing window — score reflects inactivity
- Invalid wallet address format — returns 400 error
- Trailing window parameter out of allowed range — returns 422 validation error
- Network or upstream IPFS timeout — returns 503 or partial response

## How this service works

Composite 0-100 reputation score for any Base wallet. POST {wallet, days?=90}. Combines ERC-8004 registration (Agent0 subgraph), USDC settlement velocity (Base RPC scan), and ERC-8004 feedback+validation registry events aggregated across all of the owner's agents. Hard-gates on 8004 registration to filter burn addresses + CEX wallets. Cached 24h. Use for: should I integrate/pay/trust this peer agent.

## Output

Returns a tiered reputation score (e.g. bronze/silver/gold) for the queried wallet, with supporting evidence including ERC-8004 registration status, IPFS metadata signals, recent payment activity, and aggregated feedback indicators for the requested trailing window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "default": 90,
   "maximum": 365,
   "minimum": 1,
   "description": "USDC settlement scan window."
  },
  "wallet": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Wallet address to score (owner or agentWallet)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tier": "active",
  "score": 65,
  "wallet": "0x575267eED09c338FAE5716A486A7B58A5749A292",
  "signals": {
   "feedback_count": 1,
   "erc8004_age_days": 75.2,
   "erc8004_agent_id": "41034",
   "avg_feedback_value": 85,
   "erc8004_registered": true,
   "distinct_senders_30d": 2,
   "usdc_received_30d_usdc": 4.66,
   "distinct_feedback_clients": 1,
   "erc8004_agent_count_for_owner": 1
  },
  "verdict": "[active] ERC-8004 registered (75d old, agent #41034) — metadata valid — received $4.6620 USDC from 2 distinct sender(s) in 30d (9 tx) — last paid call 2.6d ago — 1 feedback event(s) from 1 distinct client(s), avg value 85.0.",
  "cache_hit": false,
  "max_score": 100,
  "window_days": 90,
  "awarded_points": {
   "any_feedback": 10,
   "active_last_7d": 10,
   "received_any_30d": 10,
   "erc8004_age_gt_7d": 5,
   "erc8004_registered": 15,
   "ipfs_declares_x402": 5,
   "ipfs_metadata_valid": 5,
   "positive_avg_feedback": 5
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/graphadvocate-agent-reputation-scorer-21da38fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from graphadvocate.com](https://www.zero.xyz/host/graphadvocate.com/llms.txt)