# Vextorium Portfolio Valuation

> Vextorium Portfolio Valuation is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-15).

Values a multi-asset crypto portfolio by current prices and optionally computes historical performance metrics like return, volatility, and max drawdown since a given date.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/portfolio-valuation?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-portfolio-valuation-0a753975
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p_dVYfnqKFg8sZTWImgCt

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 vextorium-portfolio-valuation-0a753975 -d '<json body>'
```

Example prompt: What's my crypto portfolio worth right now and how has it performed since January 1st 2025? I hold 0.1 BTC and 2 ETH.

## When to prefer this

Use this endpoint when you need a complete multi-asset crypto portfolio valuation in a single call, especially when historical performance analytics (return, volatility, drawdown) are needed alongside current prices. Prefer it over individual price lookups when you have up to 20 assets and want portfolio-level metrics rather than just spot prices. Ideal for agents building portfolio dashboards, rebalancing tools, or performance reports.

## Known failure modes

- More than 20 positions submitted — API rejects with validation error
- Unrecognized asset symbol — price cannot be fetched, position may be null or omitted
- Invalid date format for 'since' field — historical block not returned or error
- No price data available for an asset — null values in position output
- Network timeout when fetching aggregated prices from DefiLlama

## How this service works

Value a crypto portfolio such as {"BTC": 0.1, "ETH": 2}: current value and weight of each holding and total; with a start date, its value then, return, annualized volatility and maximum drawdown. Prices from DefiLlama.

## Output

Returns a JSON object with per-asset breakdown (symbol, current price from DefiLlama aggregated feeds, quantity, USD value, and portfolio weight as a percentage), total portfolio USD value, and optionally a historical block with start date, total return percentage, maximum drawdown percentage, initial portfolio value, and annualized volatility percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "positions": {
   "type": "object",
   "description": "Ticker -> quantity (up to 20)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-10-16T21:12:44+00:00",
  "source": "Data from alternative.me (Crypto API: free to use, including commercial projects; https://alternative.me/crypto/api/)",
  "positions": [
   {
    "asset": "BTC",
    "price": 81564,
    "amount": 0.1,
    "value_usd": 8156.4,
    "weight_pct": 62.85,
    "change_24h_pct": -0.6052
   },
   {
    "asset": "ETH",
    "price": 2410.9,
    "amount": 2,
    "value_usd": 4821.8,
    "weight_pct": 37.15,
    "change_24h_pct": -1.68261
   }
  ],
  "total_value_usd": 12978.2
 }
}
```

## More

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