# Stock Trends Historical Sector/Industry Breadth Series

> Stock Trends Historical Sector/Industry Breadth Series is a paid API for AI agents from api.stocktrends.com, paid per call via x402, $0.3/call, status unknown (last checked 2026-09-13).

Returns historical breadth time series for a sector, industry group, or industry based on Stock Trends signal distribution across constituent stocks.

## Facts

- Endpoint: GET https://api.stocktrends.com/v1/breadth/sector/history
- Price: $0.3/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-cc9eec85
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E1e38fbKg7APIxDwReCv5

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-cc9eec85
```

Example prompt: Pull me the weekly sector-level breadth history from Stock Trends for common stocks on the NYSE from January 2020 to December 2023, showing up to 500 records.

## When to prefer this

Use this endpoint when you need longitudinal breadth data aggregated at the sector, industry group, or industry level based on Stock Trends signal classifications — particularly for backtesting, regime analysis, or understanding how breadth has evolved over multi-year periods. Prefer this over the current regime or leadership endpoints when historical time-series context is needed rather than a snapshot.

## Known failure modes

- Invalid date format for start/end returns a 400 error
- Unsupported exchange code returns a 400 validation error
- limit exceeding 500000 returns a 400 error
- No data available for the specified date range returns an empty result set
- Payment not fulfilled (x402) returns a 402 Payment Required response
- Invalid group_level enum value returns a 400 error

## How this service works

Historical sector, industry-group, or industry breadth series derived from Stock Trends signal distribution.

## Output

A JSON array of historical breadth data points grouped by sector, industry group, or industry, each containing Stock Trends signal distribution metrics (e.g., percentage of stocks in various trend states) aggregated weekly or daily over the requested date range.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "end": "2023-12-31",
   "limit": 500,
   "start": "2020-01-01",
   "cs_only": true,
   "exchange": "N",
   "group_level": "sector",
   "group_by_week": true
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "end": {
       "type": "string",
       "format": "date"
      },
      "limit": {
       "type": "integer",
       "default": 5000,
       "maximum": 500000,
       "minimum": 1
      },
      "start": {
       "type": "string",
       "format": "date"
      },
      "cs_only": {
       "type": "boolean",
       "default": true
      },
      "exchange": {
       "enum": [
        "N",
        "Q",
        "A",
        "B",
        "T",
        "I"
       ],
       "type": "string"
      },
      "group_level": {
       "enum": [
        "sector",
        "industry_group",
        "industry"
       ],
       "type": "string",
       "default": "sector"
      },
      "group_by_week": {
       "type": "boolean",
       "default": true
      },
      "include_unknown": {
       "type": "boolean",
       "default": false
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "title": {
   "type": "string"
  },
  "family": {
   "type": "string"
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "format": {
     "type": "string"
    },
    "example": {}
   },
   "description": "Historical breadth groups and weekly signal distribution metrics.",
   "additionalProperties": true
  },
  "category": {
   "type": "string"
  },
  "schemaUrl": {
   "type": "string"
  },
  "description": {
   "type": "string"
  },
  "metadataUrl": {
   "type": "string"
  },
  "tools_manifest": {
   "type": "string"
  },
  "pricing_catalog": {
   "type": "string"
  }
 },
 "additionalProperties": true
}
```

## More

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