# TraceFast Ethereum Address Portfolio

> TraceFast Ethereum Address Portfolio is a paid API for AI agents from mpp.tracefast.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-16).

Returns the complete USD-valued token and ETH portfolio for an Ethereum address, with up to 100 positions ranked by value, plus aggregate totals.

## Facts

- Endpoint: GET https://mpp.tracefast.xyz/api/v1/chains/1/entities/:address/portfolio
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tracefast-ethereum-address-portfolio-3f971f8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_byyWax8o1UdaDXbJKKZh0

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 tracefast-ethereum-address-portfolio-3f971f8b
```

Example prompt: What does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently hold on Ethereum — list all token and ETH balances with their USD values and the total portfolio value?

## When to prefer this

Use this endpoint when you need a complete, USD-valued snapshot of everything an Ethereum address holds — both ERC-20 tokens and native ETH — in a single call. Prefer it over per-token balance checks when you need portfolio-level aggregation, total net worth, or a ranked view of positions. It supports historical state via block number, making it ideal for point-in-time portfolio analysis. Choose it over generic blockchain explorers when you need structured, agent-ready output with USD valuations already computed.

## Known failure modes

- Invalid or malformed Ethereum address (not 0x-prefixed 40 hex) returns 400 error
- Block number that doesn't exist or is in the future returns 400 or 404
- Limit outside 1–100 range returns 400 validation error
- Address with no holdings returns empty positions array with totalUsd of 0
- Payment failure (insufficient USDC balance) returns 402 Payment Required
- Network timeout for very active addresses with hundreds of tokens

## How this service works

TraceFast live Ethereum data: everything an address holds, valued in USD — token balances and native ETH, up to 100 positions by USD value, plus totalUsd / pricedCount / hiddenCount over the whole holding. Path address: 0x-prefixed, 40 hex. Query block: integer, state at the end of this block, absent = current; limit: integer 1..100, default 100. Docs: https://docs.tracefast.xyz/api/address-portfolio.md

## Output

A ranked list of up to 100 token and ETH positions for the address, each with token symbol, contract address, balance, and USD value. Includes aggregate fields: totalUsd (sum of all valued positions), pricedCount (number of positions with a USD price), and hiddenCount (positions omitted due to spam/dust filters or limit). Positions are ordered by USD value descending.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tracefast-ethereum-address-portfolio-3f971f8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.tracefast.xyz](https://www.zero.xyz/host/mpp.tracefast.xyz/llms.txt)