Health & Hygiene

Get Report Card

Agent Report Card: Visual health report card with ecosystem benchmarks.

Requires x402 payment ($2.00 USDC on Base) OR valid X-API-Key / X-Internal-Key header.

Runs a full AHS scan, pulls ecosystem comparison data, and generates a personalised 1200x675 PNG report card image. Returns JSON with scores, benchmarks, and a URL to the generated image.

get/report-card/{address}

Request

  • Base URL: https://agenthealthmonitor.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://agenthealthmonitor.xyz/report-card/{address}
  • Auth: none declared

Path parameters

addressstring required

Ethereum wallet address (0x-prefixed, 40 hex chars)

Example:0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae

Response

Successful Response

statusstring required

Response status

Example response

{
  "status": "ok",
  "report": {
    "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
    "agent_health_score": 67,
    "grade": "C",
    "confidence": "high",
    "mode": "2D",
    "dimensions": [
      {
        "dimension": "D1 Wallet Hygiene",
        "score": 84,
        "weight": 0.5
      }
    ],
    "patterns_detected": [
      {
        "name": "Zombie Agent",
        "detected": true,
        "severity": "warning",
        "description": "Wallet shows signs of abandoned automation"
      }
    ],
    "recommendations": [
      "Reduce revert rate below 5%"
    ],
    "ecosystem_comparison": {
      "average_ahs": 58.3,
      "percentile_rank": 72,
      "grade_distribution": {
        "A": 8,
        "B": 22,
        "C": 45,
        "D": 18,
        "F": 7
      },
      "total_agents_scored": 1247
    },
    "image_url": "https://agenthealthmonitor.xyz/static/report-cards/0xde0b...7bae.png",
    "share_url": "https://agenthealthmonitor.xyz/report-card/0xde0b...7bae"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.