# HorizonPulse EVM Portfolio Snapshot

> HorizonPulse EVM Portfolio Snapshot is a paid API for AI agents from horizonpulse.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-01).

Returns on-chain portfolio balances (ETH, USDC, WETH, WBTC/cbBTC, DAI) for a single EVM address on Base and Ethereum, with rule-based risk assessment and rebalancing suggestions.

## Facts

- Endpoint: GET https://horizonpulse.dev/api/portfolio?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/horizonpulse-evm-portfolio-snapshot-ebc6c655
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kDKTN0kAKr9A5BzFlJyKk

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 horizonpulse-evm-portfolio-snapshot-ebc6c655
```

Example prompt: Can you pull the full on-chain portfolio snapshot for wallet 0x4a9d2F3e8B1c7D0eA5f6b3C2d4E7f8A9b0C1d2E3 across Base and Ethereum — I want to see my ETH, USDC, WETH, and stablecoin balances plus any rebalancing suggestions?

## When to prefer this

Use this endpoint when you need a quick multi-token, multi-chain (Base + Ethereum) portfolio snapshot for a single EVM address including rule-based risk and rebalancing output. Prefer this over generic blockchain explorers when you want structured portfolio analysis rather than raw transaction history, and when you need coverage of the most common DeFi tokens (ETH, USDC, WETH, WBTC/cbBTC, DAI) in a single call.

## Known failure modes

- Invalid or malformed EVM address returns an error (missing 0x prefix or wrong length)
- Address with zero activity may return empty/zero balances
- Network timeouts or RPC node issues may cause delayed or failed responses
- Payment failure (x402) if USDC payment is not authorized or insufficient

## How this service works

On-chain portfolio for one EVM address (?address=0x...) on Base + Ethereum: native ETH, USDC, WETH, WBTC/cbBTC, DAI; rule-based risk + rebalance suggestions

## Output

A portfolio snapshot object for the given EVM address showing balances for native ETH, USDC, WETH, WBTC/cbBTC, and DAI across Base and Ethereum mainnet, accompanied by rule-based risk indicators and rebalancing suggestions.

## 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",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address to read on Base + Ethereum (required): 0x followed by 40 hex characters."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "Horizon Pulse portfolio snapshot. The example is a trimmed real response recorded from GET /api/demo/portfolio at 2026-10-01T14:36Z UTC; live values differ on every call."
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "risk": {
   "band": "moderate",
   "score": 0
  },
  "totals": {
   "valueUsd": 0,
   "stablecoinShare": 0
  },
  "address": "0x...",
  "methodology": {},
  "suggestions": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/horizonpulse-evm-portfolio-snapshot-ebc6c655/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from horizonpulse.dev](https://www.zero.xyz/host/horizonpulse.dev/llms.txt)