# Heurist Mesh: Ethereum Address History & Balance Analyzer

> Heurist Mesh: Ethereum Address History & Balance Analyzer is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Analyzes a blockchain address to retrieve its transaction history, token balances, and activity summary including usage patterns and holdings.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/EtherscanAgent/get_address_history
- 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/heurist-mesh-ethereum-address-history-balance-analyzer-7eab6d05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ilXGhZutPNgsQ2xHM4B3Q

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 heurist-mesh-ethereum-address-history-balance-analyzer-7eab6d05 -d '<json body>'
```

Example prompt: Can you analyze the Ethereum wallet 0x742d35Cc6634C0532925a3b8D4C9C6f0bB8E2c18 and give me a summary of its transaction history, token balances, and activity patterns?

## When to prefer this

Use this endpoint when you need a comprehensive on-chain profile of an Ethereum wallet address including transaction history and token balances via Etherscan data. Prefer this over the Base network wallet analyzer sibling endpoint when the address is on Ethereum mainnet rather than Base. Choose this over generic blockchain explorers when you need structured, LLM-ready output for agent consumption.

## Known failure modes

- Invalid or malformed Ethereum address returns an error
- Address with no on-chain activity may return empty results
- Rate limiting or payment failure ($0.01 USDC x402) causes request rejection
- Network timeouts if Etherscan API is slow or unavailable
- Non-Ethereum addresses (e.g. Solana, Bitcoin) may not be supported despite the endpoint path suggesting Solana

## How this service works

Analyze a blockchain address to get transaction history, balance, and activity summary. Use this tool to gets insights into the address usage patterns and token holdings.

## Output

Returns a structured summary of the blockchain address including: full transaction history, current token balances, token holdings breakdown, and activity patterns such as frequency and types of interactions on the Ethereum network.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network to query",
       "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "zksync",
        "avalanche",
        "bsc"
       ]
      },
      "address": {
       "type": "string",
       "description": "Wallet address starting with 0x"
      },
      "debug": {
       "type": "boolean",
       "description": "Debug mode flag. ALWAYS use false.",
       "default": false
      }
     },
     "required": [
      "chain",
      "address"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-ethereum-address-history-balance-analyzer-7eab6d05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)