# Stock Trends Market Regime History

> Stock Trends Market Regime History is a paid API for AI agents from api.stocktrends.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Returns a historical sequence of weekly market regime classifications using the Stock Trends framework

## Facts

- Endpoint: GET https://api.stocktrends.com/v1/market/regime/history
- Price: $0.25/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-bc85903b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lz3ZFRMdNJ4cF5QgZzUtI

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

Example prompt: Pull me the last 20 weeks of Stock Trends weekly market regime classification history starting from 2024-01-01 so I can see how market conditions have shifted over time.

## When to prefer this

Use this endpoint when you need a multi-week historical view of market regime classifications for backtesting, longitudinal analysis, or trend context. Prefer this over the current regime endpoint when you need time-series data rather than a single snapshot, and over individual symbol endpoints when your focus is broad market conditions rather than stock-specific signals.

## Known failure modes

- Invalid or future start date returns a 400 error
- Limit outside 1-52 range returns a validation error
- Start date too far in the past may return fewer records than requested
- Service unavailable returns a 5xx error
- Payment not processed returns a 402 error

## How this service works

Historical sequence of weekly market regime classifications.

## Output

A time-ordered sequence of weekly market regime classification records, each indicating the regime state (e.g. bull, bear, neutral) as determined by the distribution of Stock Trends trend codes across the market for that week. Returns up to 52 weeks of data depending on the limit parameter.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 20,
   "start": "2024-01-01"
  }
 }
}
```

## 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": 12,
       "maximum": 52,
       "minimum": 1
      },
      "start_date": {
       "type": "string",
       "format": "date"
      }
     },
     "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": "Recent weekly market regime sequence.",
   "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-bc85903b/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)