# Stock Trends Sector/Industry Breadth Snapshot

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

Returns the latest breadth snapshot showing Stock Trends signal distribution across sectors, industry groups, or industries for market analysis.

## Facts

- Endpoint: GET https://api.stocktrends.com/v1/breadth/sector/latest
- 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/api-stocktrends-com-6eb1752e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nR1uIco0oZRmS65A1jSds

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-6eb1752e
```

Example prompt: Pull the latest Stock Trends breadth snapshot at the industry_group level for NASDAQ-listed stocks with a minimum price of 5 and minimum volume of 100000 — I want to see which groups have the strongest signal distribution right now.

## When to prefer this

Use this endpoint when you need a top-down market breadth view aggregated by sector, industry group, or industry using the Stock Trends signal framework. Prefer this over individual symbol endpoints when your goal is to assess broad market conditions, identify leading/lagging sectors, or understand signal distribution patterns across the market. Best suited for portfolio construction context, regime analysis, or sector rotation research.

## Known failure modes

- Invalid group_level enum value returns 400 error
- Invalid exchange code returns 400 error
- No data available for specified weekdate returns empty result set
- weekdate format must be ISO date (YYYY-MM-DD), otherwise returns 400
- Payment failure (402) if x402 payment not included or insufficient
- Rate limiting or quota exceeded returns 429

## How this service works

Latest sector, industry-group, or industry breadth snapshot derived from Stock Trends signal distribution.

## Output

A JSON object containing the latest breadth groups and their current Stock Trends signal distribution metrics, broken down by sector, industry group, or industry depending on the requested group_level. Includes trend code counts and distribution percentages per group.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 100,
   "cs_only": true,
   "exchange": "Q",
   "min_price": 5,
   "min_volume": 100000,
   "group_level": "industry_group"
  }
 }
}
```

## 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": {
      "limit": {
       "type": "integer",
       "default": 5000,
       "maximum": 50000,
       "minimum": 1
      },
      "cs_only": {
       "type": "boolean",
       "default": true
      },
      "exchange": {
       "enum": [
        "N",
        "Q",
        "A",
        "B",
        "T",
        "I"
       ],
       "type": "string"
      },
      "weekdate": {
       "type": "string",
       "format": "date"
      },
      "min_price": {
       "type": "number",
       "minimum": 0
      },
      "vol_scale": {
       "type": "integer",
       "default": 100,
       "minimum": 1
      },
      "min_volume": {
       "type": "integer",
       "minimum": 0
      },
      "group_level": {
       "enum": [
        "sector",
        "industry_group",
        "industry"
       ],
       "type": "string",
       "default": "sector"
      },
      "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": "Latest breadth groups and current 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-6eb1752e/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)