> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chicago.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Telemetry Changes

> What changed in the telemetry baskets over the last `days`: quadrant changes, new divergences (fatigue / rebound), themes confirmed in more markets, and moves of 3+ standard deviations. Built from the daily signal log: from 2026-09-25 it holds each day's signals as recorded that day (no hindsight); earlier dates come from a later backfill. Each event carries the basket's current state for context.

Part of the **telemetry-radar** layer, a newer set of endpoints built on the
daily basket signal log. It is separate from the baskets under
[Telemetry](https://docs.chicago.global/api-reference/telemetry/summary.md), which read the daily telemetry
row directly.

What changed in the telemetry baskets over a lookback window: quadrant
changes, new divergences (fatigue or rebound), themes confirmed in more
markets, and moves of 3 or more standard deviations. Each event carries the
basket's current quadrant and momentum for context.

> [!NOTE]
>
> Built from the daily signal log. From 2026-09-25 each day's signals are
> recorded as seen that day, with no hindsight. Earlier dates come from a later
> backfill run. Only active baskets are reported.

## Query Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `days` | integer | No | `7` | Look back this many calendar days from the latest report. Range 1–90. |
| `market` | string | No | — | Market code or country name to narrow to, e.g. `JP` or `Japan`. |
| `types` | array of string | No | All types | Event types to include. Repeat the parameter for several. Valid values: `quadrant_change`, `divergence`, `theme_spreading`, `big_move`. |
| `limit` | integer | No | `50` | Maximum events returned, newest first. Range 1–500. |

An unknown value in `types` returns `400`.

## Response

The window, counts per event type, and the events themselves (newest first,
capped at `limit`). A `note` field appears only when more events matched than
`limit` allows. `legend` explains each event type and is static.

```json theme={null}
{
  "window": { "from": "2026-10-28", "to": "2026-11-04", "days": 7 },
  "counts": { "quadrant_change": 2, "divergence": 1, "theme_spreading": 1, "big_move": 3 },
  "total_events": 7,
  "events": [
    {
      "basket_id": "jp-semiconductors-01",
      "basket_name": "Japan Semiconductors",
      "theme_id": "semiconductors",
      "market": "JP",
      "country": "Japan",
      "now": { "quadrant": "Leaders", "momentum_1m_pct": 4.21, "momentum_6m_pct": 11.03 },
      "date": "2026-11-03",
      "type": "quadrant_change",
      "from": "Recovering",
      "to": "Leaders",
      "flips": 1,
      "momentum_1m_pct": 4.21,
      "momentum_6m_pct": 11.03
    },
    {
      "basket_id": "us-ai-infra-02",
      "basket_name": "US AI Infrastructure",
      "theme_id": "ai-infra",
      "market": "US",
      "country": "United States",
      "now": { "quadrant": "Fading", "momentum_1m_pct": -1.8, "momentum_6m_pct": 6.4 },
      "date": "2026-11-02",
      "type": "big_move",
      "daily_zscore": -3.4
    }
  ],
  "legend": {
    "quadrant_change": "The basket ended the window in a different quadrant than it started.",
    "divergence": "A divergence started: fatigue = down on the day while up month-to-date; rebound = up on the day while down month-to-date.",
    "theme_spreading": "The basket's theme is confirmed in more other markets than at the start of the window.",
    "big_move": "The day's move was at least 3 standard deviations from the basket's own history.",
    "now": "The basket's latest state, for context: quadrant and momentum (percent)."
  }
}
```


## OpenAPI

````yaml GET /v1/telemetry/changes
openapi: 3.1.0
info:
  title: Parallax API
  description: >-
    Parallax by Chicago Global — AI-powered investment research and portfolio
    analytics. Multi-factor scoring, portfolio analysis and tracking, financial
    statements, analyst estimates, ETF analytics, valuation (DCF & multiples),
    macro and market telemetry, and AI-generated research reports. Credits can
    be fractional. Per-symbol reads cost 0.05 credits per submitted symbol; see
    each operation for its price. A 503 indicates an availability failure, not
    data age.
  version: 2.0.0
servers:
  - url: https://api.chicago.global
security:
  - HTTPBearer: []
paths:
  /v1/telemetry/changes:
    get:
      tags:
        - v1
        - Telemetry Radar
      summary: Get Telemetry Changes
      description: >-
        What changed in the telemetry baskets over the last `days`: quadrant
        changes, new divergences (fatigue / rebound), themes confirmed in more
        markets, and moves of 3+ standard deviations. Built from the daily
        signal log: from 2026-09-25 it holds each day's signals as recorded that
        day (no hindsight); earlier dates come from a later backfill. Each event
        carries the basket's current state for context.
      operationId: get_telemetry_changes_v1_telemetry_changes_get
      parameters:
        - name: days
          in: query
          required: false
          schema:
            type: integer
            maximum: 90
            minimum: 1
            description: Look back this many calendar days from the latest report (1-90).
            default: 7
            title: Days
          description: Look back this many calendar days from the latest report (1-90).
        - name: market
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Market code or country name to narrow to, e.g. JP or Japan.
            title: Market
          description: Market code or country name to narrow to, e.g. JP or Japan.
        - name: types
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            description: >-
              Event types to include (repeatable): quadrant_change, divergence,
              theme_spreading, big_move. Default all.
            title: Types
          description: >-
            Event types to include (repeatable): quadrant_change, divergence,
            theme_spreading, big_move. Default all.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            description: Maximum events returned, newest first (max 500).
            default: 50
            title: Limit
          description: Maximum events returned, newest first (max 500).
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          description: Unknown event type in `types`
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
      security:
        - HTTPBearer: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.