# Stock Trends Portfolio Evaluator

> Stock Trends Portfolio Evaluator is a paid API for AI agents from api.stocktrends.com, paid per call via x402, $0.75/call, status unknown (last checked 2026-09-13).

Evaluates a user-supplied portfolio against Stock Trends signal context and current market regime to assess portfolio quality and alignment.

## Facts

- Endpoint: POST https://api.stocktrends.com/v1/portfolio/evaluate
- Price: $0.75/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-stocktrends-com-ef7b28de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T7pA_ljIshWu42XoT0NjQ

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 api-stocktrends-com-ef7b28de -d '<json body>'
```

Example prompt: Can you evaluate my portfolio — AAPL, MSFT, NVDA, and JPM — against the current Stock Trends signals and market regime context to see how well my holdings are aligned with the trend and regime conditions right now?

## When to prefer this

Use this endpoint when you need to evaluate a specific user-defined portfolio (vs. constructing a new one) against Stock Trends signals and market regime context. Prefer this over the symbol-level decision endpoint when assessing multiple holdings collectively, or over the portfolio constructor endpoint when the user already has an existing portfolio they want graded rather than built from scratch.

## Known failure modes

- Invalid or unrecognized stock symbols in the portfolio — returns error with offending symbols
- Empty or malformed portfolio payload — returns validation error
- Market regime data temporarily unavailable — partial or degraded evaluation returned
- Symbols outside the Stock Trends coverage universe — excluded from evaluation with a warning
- Payment not processed or insufficient USDC — request rejected with payment error

## How this service works

Evaluates a user-supplied portfolio against Stock Trends signal and market regime context.

## Output

Returns an evaluation of the submitted portfolio against Stock Trends signal indicators (trend state, trend persistence, relative performance, volume activity) and the current market regime classification, yielding a structured assessment of how well the portfolio aligns with prevailing trend and regime conditions.

## Example request

```json
{
 "positions": [
  {
   "weight": 0.3,
   "symbol_exchange": "AAPL-N"
  },
  {
   "weight": 0.25,
   "symbol_exchange": "MSFT-Q"
  },
  {
   "weight": 0.25,
   "symbol_exchange": "NVDA-Q"
  },
  {
   "weight": 0.2,
   "symbol_exchange": "JPM-N"
  }
 ]
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "positions": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "symbol_exchange",
     "weight"
    ],
    "properties": {
     "weight": {
      "type": "number",
      "maximum": 1,
      "minimum": 0
     },
     "symbol_exchange": {
      "type": "string",
      "pattern": "^[A-Z0-9.]+-[A-Z]$"
     }
    },
    "additionalProperties": false
   }
  }
 }
}
```

## More

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