# Stock Trends Symbol Decision Evaluator

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

Evaluates a single stock symbol using Stock Trends signal context and current market regime to produce a deterministic buy/sell/hold-type decision output.

## Facts

- Endpoint: POST https://api.stocktrends.com/v1/decision/evaluate-symbol
- Price: $0.5/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-7a237747
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XKGxW-lnn9i9yxFslUQgq

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-7a237747 -d '<json body>'
```

Example prompt: Using Stock Trends, evaluate NVDA right now — combine the trend signal context with the current market regime and tell me what the decision output is.

## When to prefer this

Use this endpoint when you need a single, combined decision output for a specific ticker that fuses both the Stock Trends indicator signal and the broader market regime context into one deterministic result — rather than calling the signal endpoint and regime endpoint separately and manually combining them. Ideal for agent workflows that need a ready-to-use verdict per symbol without writing custom combination logic.

## Known failure modes

- Symbol not found or not covered by Stock Trends universe — returns an error or empty result
- Market regime data unavailable for the evaluation period — evaluation cannot be completed
- Invalid or malformed symbol input — returns a validation error
- Service unavailable or rate-limited — returns 4xx/5xx HTTP error
- Payment failure via x402 protocol — request not processed

## How this service works

Deterministic symbol-level decision evaluation combining Stock Trends signal context with market regime context.

## Output

A deterministic evaluation object for the requested symbol, combining the Stock Trends signal (trend state, trend persistence, relative performance, relative performance direction, volume activity) with the current market regime classification to produce a decision assessment — effectively a regime-aware signal verdict for that ticker.

## Example request

```json
{
 "evaluationDate": "2024-01-15",
 "symbol_exchange": "AAPL-Q",
 "includeMarketRegime": true
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string"
  },
  "exchange": {
   "enum": [
    "N",
    "Q",
    "A",
    "B",
    "T",
    "I"
   ],
   "type": "string"
  },
  "symbol_exchange": {
   "type": "string",
   "pattern": "^[A-Z0-9.]+-[A-Z]$"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-stocktrends-com-7a237747/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)