# Stock Trends Inference Model (ST-IM) Latest Outputs

> Stock Trends Inference Model (ST-IM) Latest Outputs is a paid API for AI agents from api.stocktrends.com, paid per call via x402, $0.0025/call, status unknown (last checked 2026-09-14).

Returns the latest ST-IM forward return expectations and statistical distributions for a stock symbol across 4-week, 13-week, and 40-week horizons.

## Facts

- Endpoint: GET https://api.stocktrends.com/v1/stim/latest
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-stocktrends-com-a8a8ef54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2wxV7EYuMR9wBR3dfT3-Q

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

Example prompt: What are the Stock Trends Inference Model forward return expectations for AAPL listed on NASDAQ — give me the 4-week, 13-week, and 40-week statistical distributions.

## When to prefer this

Use this endpoint when you need probabilistic, multi-horizon forward return expectations for a specific stock symbol derived from the Stock Trends Inference Model (ST-IM). It is the right choice when you want statistical distributions rather than deterministic signals, and when you need outlook across all three horizons (4-week, 13-week, 40-week) simultaneously. Prefer this over the regime or signal endpoints when the question is specifically about expected forward returns for a single symbol, not about market regime or trend classification.

## Known failure modes

- Invalid or unrecognized symbol_exchange format (must match ^[A-Z0-9.]+-[A-Z]$) — returns validation error
- Symbol not covered by Stock Trends database — returns 404 or empty result
- Invalid exchange code (must be one of N, Q, A, B, T, I) — returns schema validation error
- Payment failure or insufficient USDC balance for x402 micropayment — returns 402 Payment Required
- ST-IM model outputs not yet available for the current period — returns stale or missing data notice

## How this service works

Latest Stock Trends Inference Model (ST-IM) outputs for a symbol: forward return expectations and statistical distributions across 4-week, 13-week, and 40-week horizons. Use /v1/meta/stim for ST-IM provenance, base-period context, and interpretation limits.

## Output

A JSON object containing the latest ST-IM outputs for the requested symbol: forward return expectations and statistical distributions across 4-week, 13-week, and 40-week horizons, reflecting the model's probabilistic view of the symbol's future performance.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "symbol_exchange": "AAPL-Q"
  }
 },
 "title": "Stock Trends Forward Return Expectations",
 "family": "market_data",
 "output": {
  "type": "json",
  "format": "application/json",
  "example": {}
 },
 "category": "financial_analysis",
 "description": "Retrieve ST-IM forward return expectations and statistical distributions for a stock symbol"
}
```

## 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": [
      "symbol_exchange"
     ],
     "properties": {
      "symbol": {
       "type": "string"
      },
      "exchange": {
       "enum": [
        "N",
        "Q",
        "A",
        "B",
        "T",
        "I"
       ],
       "type": "string"
      },
      "symbol_exchange": {
       "type": "string",
       "pattern": "^[A-Z0-9.]+-[A-Z]$"
      }
     },
     "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": "ST-IM forward return expectations and statistical distributions across 4, 13, and 40 weeks.",
   "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-a8a8ef54/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)