# Stock Trends Equal-Weight Portfolio Constructor

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

Constructs a deterministic equal-weight portfolio from eligible Stock Trends signal candidates based on current trend and regime context.

## Facts

- Endpoint: POST https://api.stocktrends.com/v1/portfolio/construct
- Price: $1/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-b21a7272
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LxykPov7LSPwC5k_PP0YA

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

Example prompt: Use Stock Trends to build me a deterministic equal-weight portfolio from the current eligible signal candidates — I want a fully constructed allocation I can act on today.

## When to prefer this

Use this endpoint when you need a ready-to-trade, rules-based equal-weight portfolio constructed systematically from Stock Trends signal candidates, rather than evaluating individual symbols or screening manually. Prefer this over the symbol-level decision or screener endpoints when you want a complete portfolio output in a single call.

## Known failure modes

- No eligible candidates available given current regime conditions — returns empty or minimal portfolio
- Invalid or missing input parameters result in 400 error
- Insufficient signal data for candidate evaluation returns reduced candidate pool
- Payment failure via x402 protocol returns 402 Payment Required
- Service unavailable returns 503 with retry guidance

## How this service works

Constructs a deterministic equal-weight portfolio from eligible Stock Trends signal candidates.

## Output

A deterministically constructed equal-weight portfolio listing selected symbols and their equal allocation weights, derived from currently eligible Stock Trends signal candidates filtered through trend state, persistence, and market regime context.

## Example request

```json
{
 "input": {
  "body": {
   "bias": "auto",
   "count": 5,
   "exchange": "N",
   "universe": "top"
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bias": {
   "enum": [
    "auto",
    "bullish",
    "bearish"
   ],
   "type": "string",
   "default": "auto"
  },
  "count": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1
  },
  "exchange": {
   "enum": [
    "N",
    "Q",
    "A",
    "T"
   ],
   "type": "string"
  },
  "universe": {
   "enum": [
    "top"
   ],
   "type": "string",
   "default": "top"
  }
 }
}
```

## More

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