# three.ws Agent Reputation Lookup

> three.ws Agent Reputation Lookup is a paid API for AI agents from three.ws, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns on-chain reputation metrics for a three.ws 3D AI agent, including payment history, token mints, distributions, buybacks, and attestations.

## Facts

- Endpoint: POST https://three.ws/api/x402/agent-reputation
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-agent-reputation-lookup-d7e455c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tVpbwBeQb3a69OxK_OhJ6

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 three-ws-agent-reputation-lookup-d7e455c8 -d '<json body>'
```

Example prompt: Can you pull up the reputation stats for the three.ws agent with ID 7b9a4f30-2d11-4e2d-9d12-1cdb1f6a3a55 — I want to see how many people have paid it, its payment failure rate, how many token mints it has deployed, and whether it has any attestations?

## When to prefer this

Use this endpoint when you need on-chain reputation signals for a specific three.ws 3D AI agent — particularly payment volume, payer diversity, token mint history, and community attestations. Prefer this over generic agent metadata endpoints when trust verification or economic activity assessment is the goal.

## Known failure modes

- Missing or invalid agent_id UUID returns 400 or 422 validation error
- Agent not found in index returns 404
- Payment failure (x402 flow not completed) returns 402
- Rate limiting or upstream indexing lag may return stale or empty data
- Network issues return 5xx

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

A JSON object with the agent's name, wallet address, payment stats (confirmed count, distinct payers, failure rate, total amount in atomics), deployed mint count with token symbols and networks, buyback stats (confirmed burns, total burn atomics), distribution stats (confirmed, failed, success rate), attestation counts (feedback and validation), and the last indexed timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "subject"
     ],
     "properties": {
      "chain": {
       "type": [
        "integer",
        "string"
       ],
       "description": "EVM chain id for a bare EVM address or ERC-8004 agent id (default 8453 / Base)."
      },
      "subject": {
       "type": "string",
       "description": "Any counterparty identifier: a Solana wallet or mint, an EVM 0x address, an ERC-8004 agent id (bare integer or erc8004:<chainId>:<id>), or a three.ws agent_id (UUID). Type is auto-detected."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "subject",
      "subjectType",
      "score",
      "tier",
      "signals",
      "evidence",
      "caveats",
      "ts"
     ],
     "properties": {
      "ts": {
       "type": "string",
       "format": "date-time"
      },
      "tier": {
       "enum": [
        "unknown",
        "low",
        "medium",
        "high",
        "elite"
       ],
       "type": "string"
      },
      "score": {
       "type": [
        "integer",
        "null"
       ],
       "maximum": 100,
       "minimum": 0
      },
      "caveats": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "signals": {
       "type": "object",
       "properties": {
        "dimensions": {
         "type": "object",
         "properties": {
          "age": {
           "type": "object",
           "properties": {
            "norm": {
             "type": [
              "number",
              "null"
             ]
            },
            "points": {
             "type": "number"
            },
            "weight": {
             "type": "number"
            },
            "available": {
             "type": "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "sweep",
  "count": 20,
  "agents": [
   {
    "name": "Helios",
    "score": 88,
    "flagged": false,
    "reasons": [],
    "agent_id": "7b9a4f30-2d11-4e2d-9d12-1cdb1f6a3a55",
    "breakdown": {
     "buybacks": 15,
     "payments": 40,
     "attestations": 19,
     "distributions": 14
    },
    "deployed_mints": 2,
    "last_active_at": "2026-06-26T17:00:00Z",
    "wallet_address": "THREEsynthetic1111111111111111111111111PayTo"
   }
  ],
  "flagged": [
   {
    "name": "Newcomer",
    "score": 12,
    "reasons": [
     "no confirmed payments on record",
     "no signed attestations"
    ],
    "agent_id": "7b9a4f30-2d11-4e2d-9d12-1cdb1f6a3a55"
   }
  ],
  "swept_at": "2026-06-27T17:00:00Z",
  "avg_score": 64,
  "flagged_count": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-agent-reputation-lookup-d7e455c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)