---
title: "Get Thesis Performance Overview"
method: GET
path: "/watchlists/{watchlist_id}/thesis-performance"
tags: ["thesis performance"]
---

# Get Thesis Performance Overview

`GET /watchlists/{watchlist_id}/thesis-performance`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/watchlists/{watchlist_id}/thesis-performance`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `watchlist_id` integer, required

## Response `200`

Successful Response

- ThesisPerformanceOverviewOut
  - `benchmark_ticker` string, required
  - `benchmark_label` string, required
  - `price_source` string, required
  - `price_adjustment` 'splits', required
  - `price_coverage` 'current_symbol', required
  - `subjects` ThesisPerformanceSubjectOut[]
    - `subject_type` 'company' | 'investment_theme', required
    - `title` string, required
    - `company_ticker` string, nullable
    - `shared_thesis_id` integer, nullable
    - `version_number` integer, required
    - `is_active` boolean, required
    - `legs` ThesisPerformanceLegOut[]
      - `ticker` string, required
      - `company_name` string, nullable
      - `effect` 'tailwind' | 'headwind' | 'mixed' | 'uncertain', nullable
      - `context_start_at` string, date-time, required
      - `context_end_at` string, date-time, nullable
      - `market_performance` ThesisMarketPerformanceOut, required: Price context around an exact saved interval, never a thesis-quality score.
        - `ticker` string, required
        - `benchmark_ticker` string, required
        - `benchmark_label` string, required
        - `status` 'ready' | 'partial' | 'unavailable', required
        - `status_reason` 'complete_window' | 'starts_after_context' | 'ticker_history_unavailable' | 'benchmark_history_unavailable' | 'insufficient_shared_sessions', required
        - `requested_start_date` string, date, required
        - `requested_end_date` string, date, nullable
        - `start_date` string, date, nullable
        - `end_date` string, date, nullable
        - `trading_sessions` integer
        - `ticker_return_pct` number, nullable
        - `benchmark_return_pct` number, nullable
        - `relative_return_pct` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tickertrac/apis/tickerrag-api.md) · [All operations](https://skmtc.dev/tickertrac/apis/tickerrag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickertrac/apis/tickerrag-api/revisions/3c7eb0f6425d?raw)