> ## 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.

# Stock → Basket Lookup

> Find the telemetry basket a stock belongs to — for any stock in a basket, not just the 10 listed in the daily telemetry. Each match returns the stock's cohesion with its basket, its factor scores, its rank by total score inside the basket, and the basket's telemetry context (returns, momentum, quadrant, scores, confirmed_in) for the report date. A plain ticker can match several listings; each is returned (up to 3).

Part of the **telemetry-radar** layer, a newer set of endpoints distinct from
the baskets under [Telemetry](https://docs.chicago.global/api-reference/telemetry/summary.md). It reads the
full, live basket membership synced daily into the basket composition tables,
not the 10-member sample in the daily telemetry row.

Finds the telemetry basket(s) a stock belongs to, for any stock in a basket —
not just the 10 listed per basket in the daily telemetry. Each match returns
the stock's cohesion with its basket, its factor scores, its rank by total
score inside the basket, and the basket's telemetry context (returns,
momentum, quadrant, scores, `confirmed_in`) for the report date.

> [!NOTE]
>
> A plain ticker can match several RICs across markets. Each match is returned,
> up to 3 per symbol.

## Query Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `symbols` | array of string | Yes | — | Ticker, RIC, or company name, e.g. `AAPL`, `NVDA.O`, `Toyota`. Repeat the parameter for several, up to 10. |
| `include_members` | boolean | No | `false` | Also return every member of each matched basket. |
| `date` | string | No | Latest | Telemetry report date (`YYYY-MM-DD`) used for basket returns and context. |

Sending no symbols, or more than 10, returns `400`.

## Response

One result per symbol queried, each with its matches (possibly empty).

```json theme={null}
{
  "report_date": "2026-11-04",
  "results": [
    {
      "query": "NVDA",
      "matches": [
        {
          "ric": "NVDA.O",
          "name": "NVIDIA Corp",
          "member_cohesion": 0.812,
          "cohesion_z": 1.46,
          "scores": { "value": 3.1, "quality": 8.7, "momentum": 9.2, "defensive": 4.0, "tactical": 6.5, "total": 7.4 },
          "basket_id": "us-ai-infra-02",
          "rank_in_basket": { "by_total_score": 2, "of_scored": 24, "basket_size": 26 },
          "basket": {
            "basket_id": "us-ai-infra-02",
            "name": "US AI Infrastructure",
            "market": "US",
            "quadrant": "Fading",
            "momentum_1m": -0.018,
            "momentum_6m": 0.064,
            "n_confirmed_markets": 3,
            "is_priced_in": false
          }
        }
      ]
    },
    {
      "query": "ZZZZZ",
      "matches": [],
      "note": "Not in any active telemetry basket. Telemetry covers about N stocks across its baskets; this one isn't among them."
    }
  ]
}
```

For a symbol in no active basket, `note` states live current coverage (`N`
above stands in for that day's actual count, which changes daily as
baskets re-form). `basket` is `null`, with a different `note` explaining the
basket was re-formed since this match was built, when the matched basket is
no longer in the telemetry row for the report date. `members` is included
only when `include_members`
is `true`, sorted most representative (`cohesion_z` descending) first. See
the response example for exact field presence — nullable fields are omitted
from this illustration where not applicable.


## OpenAPI

````yaml GET /v1/telemetry/stock-basket
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/stock-basket:
    get:
      tags:
        - v1
        - Telemetry Radar
      summary: Get Stock Basket
      description: >-
        Find the telemetry basket a stock belongs to — for any stock in a
        basket, not just the 10 listed in the daily telemetry. Each match
        returns the stock's cohesion with its basket, its factor scores, its
        rank by total score inside the basket, and the basket's telemetry
        context (returns, momentum, quadrant, scores, confirmed_in) for the
        report date. A plain ticker can match several listings; each is returned
        (up to 3).
      operationId: get_stock_basket_v1_telemetry_stock_basket_get
      parameters:
        - name: symbols
          in: query
          required: true
          schema:
            type: array
            items:
              type: string
            description: >-
              Ticker, RIC or company name, e.g. AAPL, NVDA.O, Toyota. Repeat for
              several (max 10).
            title: Symbols
          description: >-
            Ticker, RIC or company name, e.g. AAPL, NVDA.O, Toyota. Repeat for
            several (max 10).
        - name: include_members
          in: query
          required: false
          schema:
            type: boolean
            description: Also return every member of each matched basket.
            default: false
            title: Include Members
          description: Also return every member of each matched basket.
        - name: date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Telemetry report date (YYYY-MM-DD) for basket returns. Defaults to
              latest.
            title: Date
          description: >-
            Telemetry report date (YYYY-MM-DD) for basket returns. Defaults to
            latest.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          description: No symbols provided, or more than 10 symbols
        '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.