Health & Hygiene

Get Ahs Report

Agent Health Score: Composite 0-100 index for on-chain agent wallets.

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

Three dimensions:

  • D1 Wallet Hygiene (dust, spam, gas efficiency, failure rate, nonce gaps)
  • D2 Behavioural Patterns (repeated failures, gas adaptation, timing, diversity, retry storms)
  • D3 Infrastructure Health (optional — provide ?agent_url= to enable 3D mode)

Plus cross-dimensional pattern detection (Zombie Agent, Cascading Failure, etc.) and temporal scoring via X-AHS-Previous JWT header.

get/ahs/{address}

Request

  • Base URL: https://agenthealthmonitor.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://agenthealthmonitor.xyz/ahs/{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",
    "patterns_detected": [
      {
        "name": "Zombie Agent",
        "detected": true,
        "severity": "warning",
        "description": "Wallet shows signs of abandoned automation"
      }
    ],
    "trend": "stable",
    "recommendations": [
      "Reduce revert rate below 5% to improve D1 score",
      "Investigate Zombie Agent pattern"
    ],
    "ahs_token": "eyJhbGciOiJIUzI1NiIs...",
    "model_version": "2.1.0",
    "scan_timestamp": "2025-04-06T10:00:00Z",
    "next_scan_recommended": "2025-04-13T10:00:00Z",
    "routing_recommendation": "escrow"
  }
}

Changes

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