Health & Hygiene

Get Health Report

Analyze a Base wallet address and return a health report.

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

  • Fetches transaction history from Blockscout
  • Calculates success rate, gas efficiency, nonce health
  • Computes composite health score (0-100)
  • Generates specific optimization recommendations
get/health/{address}

Request

  • Base URL: https://agenthealthmonitor.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://agenthealthmonitor.xyz/health/{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

nansen_availableboolean

Whether Nansen enrichment was successful

total_portfolio_usdnumber

Total portfolio value in USD

Example response

{
  "status": "ok",
  "report": {
    "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
    "health_score": 74.5,
    "optimization_priority": "medium",
    "total_transactions": 1542,
    "successful": 1480,
    "failed": 62,
    "success_rate_pct": 95.98,
    "total_gas_spent_eth": 0.284,
    "wasted_gas_eth": 0.019,
    "estimated_monthly_waste_usd": 14.3,
    "avg_gas_efficiency_pct": 67.3,
    "out_of_gas_count": 3,
    "reverted_count": 59,
    "retry_count": 2,
    "top_failure_type": "execution reverted",
    "first_seen": "2024-01-15T08:30:00Z",
    "last_seen": "2025-04-05T14:22:00Z",
    "recommendations": [
      {
        "category": "gas",
        "severity": "high",
        "message": "Gas waste detected — 12% of gas spent on reverted transactions"
      }
    ],
    "eth_price_usd": 3245.5,
    "analyzed_at": "2025-04-06T10:00:00Z"
  },
  "nansen_labels": [
    {
      "label": "Smart Money",
      "category": "behavioral",
      "definition": "Wallet that consistently trades profitably"
    }
  ],
  "token_balances": [
    {
      "chain": "base",
      "symbol": "USDC",
      "name": "USD Coin",
      "amount": 1250.75,
      "usd_value": 1250.75
    }
  ],
  "total_portfolio_usd": 4820.5
}

Changes

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