# Crucible Portfolio Valuation

> Crucible Portfolio Valuation is a paid API for AI agents from crucible.unitynodes.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns token holdings, USD balances, and portfolio allocation breakdown for an Ethereum mainnet wallet address.

## Facts

- Endpoint: POST https://crucible.unitynodes.com/finance/portfolio
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crucible-portfolio-valuation-24525fe3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Les349lkRJ0taUWYb4Di9

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 crucible-portfolio-valuation-24525fe3 -d '<json body>'
```

Example prompt: Can you pull up the full portfolio valuation for Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see every token it holds, the USD value of each, and what percentage of the total portfolio each one represents?

## When to prefer this

Choose this endpoint when you need a full USD-denominated portfolio snapshot of an Ethereum mainnet wallet, including per-token allocation percentages and cited evidence. It is especially useful when auditability matters, since results include source hashes and evidence citations. Prefer this over generic block explorers when you need structured, agent-consumable JSON with risk scoring and confidence levels in a single pay-per-call response.

## Known failure modes

- Invalid or malformed wallet address (non-0x format) — returns validation error
- Wallet with no on-chain token holdings — returns empty holdings array and zero totalUsd
- Upstream price feed unavailable for obscure tokens — usdValue may be null for those tokens
- Rate limiting or payment failure — HTTP 402 if USDC payment not processed
- Network timeout fetching onchain data — returns partial or error response

## How this service works

Pay-per-call Web3 agent services: wallet, token and agent security audits; token prices, depeg checks and portfolio valuation; cited fact-checking and source research.

## Output

Returns a structured object with the wallet address, an array of all token holdings (each with token name, symbol, raw balance, USD value, and portfolio percentage), a total portfolio USD value, a risk score, a confidence rating, a content hash for verifiability, and an array of cited evidence with source URLs for auditability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "wallet"
 ],
 "properties": {
  "wallet": {
   "type": "string",
   "description": "Wallet address (0x...), Ethereum mainnet"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cost": {
   "type": "number"
  },
  "data": {
   "type": "object",
   "properties": {
    "wallet": {
     "type": "string"
    },
    "holdings": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "pct": {
        "type": "number",
        "nullable": true
       },
       "token": {
        "type": "string"
       },
       "symbol": {
        "type": "string"
       },
       "balance": {
        "type": "string"
       },
       "usdValue": {
        "type": "number",
        "nullable": true
       }
      }
     }
    },
    "totalUsd": {
     "type": "number"
    }
   }
  },
  "sources": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "url": {
      "type": "string"
     },
     "hash": {
      "type": "string"
     },
     "name": {
      "type": "string"
     }
    }
   }
  },
  "evidence": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "claim": {
      "type": "string"
     },
     "support": {
      "type": "string"
     },
     "sourceIndex": {
      "type": "number"
     }
    }
   }
  },
  "riskScore": {
   "type": "number"
  },
  "confidence": {
   "type": "number"
  },
  "contentHash": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crucible-portfolio-valuation-24525fe3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crucible.unitynodes.com](https://www.zero.xyz/host/crucible.unitynodes.com/llms.txt)