# LoneStarOracle PortfolioRisk

> LoneStarOracle PortfolioRisk is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Analyzes portfolio risk across up to 20 tickers, returning volatility, beta, VaR, correlation, diversification score, and sector concentration flags

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_portfolio_lonestaroracle_xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lonestaroracle-portfoliorisk-9d7eef4d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lVgEQt9Zq4c2laXKIdvmC

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 lonestaroracle-portfoliorisk-9d7eef4d
```

Example prompt: Can you run a portfolio risk analysis on my holdings — AAPL at 25%, MSFT at 25%, NVDA at 25%, and SPY at 25%? I want to see the volatility, beta, VaR, diversification score, and any sector concentration warnings.

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-metric portfolio risk snapshot across a basket of equities — including beta, VaR, correlation, diversification score, and sector flags — in a single call. Prefer it over individual stock analysis endpoints when the user's question is about their combined holdings rather than a single security, and when they need actionable risk flags for rebalancing or review decisions.

## Known failure modes

- Invalid or unrecognized ticker symbols return errors or are silently skipped
- Weights that don't sum to 100 may produce unexpected results or be rejected
- More than 20 tickers may be rejected or truncated
- Stale or missing market data for illiquid tickers may cause incomplete output
- Malformed query parameter format (e.g. bad delimiter for tickers) causes parse errors

## How this service works

Portfolio risk analysis — concentration volatility correlation across holdings

## Output

Returns a portfolio-level summary including 1-month, 3-month, and 1-year weighted returns, annualized portfolio volatility, portfolio beta, 1-day 95% VaR as a percentage, average pairwise correlation, a diversification score from 0 to 10, sector concentration breakdown, per-holding metrics (return, volatility, beta, weight), top correlated pairs, and risk flags such as sector overconcentration.

## Request schema (JSON Schema)

```json
{
 "name": "LoneStarOracle — PortfolioRisk",
 "tags": [
  "portfolio",
  "risk",
  "correlation",
  "diversification",
  "var",
  "beta"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "trading",
 "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",
     "properties": {
      "tickers": {
       "type": "string",
       "title": "Tickers"
      },
      "weights": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Weights"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "summary": "4-asset portfolio: 1yr ret +28.4% | Vol 18.2% | Beta 1.12 | Div score 6.8/10",
     "holdings": [
      {
       "beta": 1.24,
       "ret_1y": 34.8,
       "ticker": "AAPL",
       "weight": 25,
       "ann_vol": 23.4
      }
     ],
     "risk_flags": [
      "sector concentration: Technology at 60%"
     ],
     "portfolio_beta": 1.12,
     "avg_correlation": 0.54,
     "var_95_1day_pct": 1.82,
     "sector_breakdown": {
      "ETF": 25,
      "Technology": 60
     },
     "portfolio_return_1y": 28.4,
     "portfolio_volatility": 18.2,
     "diversification_score": 6.8
    }
   }
  }
 },
 "description": "Portfolio risk analysis for up to 20 tickers. Returns weighted portfolio returns (1m/3m/1y), annualized volatility, portfolio beta, 1-day 95% VaR, average correlation, diversification score (0-10), sector concentration breakdown, top correlated pairs, and risk flags. Supports custom weights or equal-weight. Ideal for portfolio review, risk assessment, and rebalancing decisions."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lonestaroracle-portfoliorisk-9d7eef4d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)