Equity Rank Admin V79 API

openapi: 3.2.0
info:
  title: Equity Rank Com Admin V79 API
  version: 0.1.0
  description: 'Operations tagged admin-v79 across 2 of this provider''s published API definitions: openapi.json, equity-rank-com-openapi.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: admin-v79
paths:
  /api/admin/v79/dashboard:
    get:
      tags:
      - admin-v79
      summary: Dashboard
      description: 'Full v7.9 engine state for the admin dashboard. Computes current MTM

        on every holding and option. One round-trip, no client-side pricing.'
      operationId: dashboard_api_admin_v79_dashboard_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Dashboard Api Admin V79 Dashboard Get
      security:
      - HTTPBearer: []
  /api/admin/v79/signals:
    get:
      tags:
      - admin-v79
      summary: Signals
      description: 'Last N v79-tagged signals from auto_trader_signals (strategy_label

        starts with ''v79:''). Ordered newest-first.'
      operationId: signals_api_admin_v79_signals_get
      security:
      - HTTPBearer: []
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 100
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Signals Api Admin V79 Signals Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/v79/nav-history:
    get:
      tags:
      - admin-v79
      summary: Nav History
      description: 'Time series of total NAV + SPY/QQQ benchmark for the validation

        chart. One row per run_v79_cycle invocation, ordered oldest-first.'
      operationId: nav_history_api_admin_v79_nav_history_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Nav History Api Admin V79 Nav History Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/v79/honest-scorecard:
    get:
      tags:
      - admin-v79
      summary: Honest Scorecard
      description: 'The stored realistic-bookkeeping report (costs, T-bill interest,

        dividends, SPY total return, options at real quotes, risk). Built daily

        by the `v79-honest-scorecard` job; read-only.'
      operationId: honest_scorecard_api_admin_v79_honest_scorecard_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Honest Scorecard Api Admin V79 Honest Scorecard Get
      security:
      - HTTPBearer: []
  /api/admin/v79/honest-scorecard/rebuild:
    post:
      tags:
      - admin-v79
      summary: Honest Scorecard Rebuild
      description: 'Rebuild and store the report now (reads the DB and Alpha Vantage;

        changes nothing in the book).'
      operationId: honest_scorecard_rebuild_api_admin_v79_honest_scorecard_rebuild_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Honest Scorecard Rebuild Api Admin V79 Honest Scorecard Rebuild Post
      security:
      - HTTPBearer: []
  /api/admin/v79/options-replay:
    get:
      tags:
      - admin-v79
      summary: Options Replay
      description: 'The stored options-replay research result (revised put rules on real

        2019+ quotes vs a delta-matched stock-and-bills position). Research only;

        built by the `v79-options-replay` job.'
      operationId: options_replay_api_admin_v79_options_replay_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Options Replay Api Admin V79 Options Replay Get
      security:
      - HTTPBearer: []
  /api/admin/v79/snapshot-eps-now:
    post:
      tags:
      - admin-v79
      summary: Snapshot Eps Now
      description: 'Manually trigger the EPS-surprise backfill for the v79 universe.

        Same code path as the daily 13:25 UTC scheduled job. Populates

        earnings_dates.eps_surprise_pct so the earnings_momentum sleeve can

        fire on fresh post-earnings drift.'
      operationId: snapshot_eps_now_api_admin_v79_snapshot_eps_now_post
      security:
      - HTTPBearer: []
      parameters:
      - name: lookback_days
        in: query
        required: false
        schema:
          type: integer
          maximum: 60
          minimum: 1
          default: 14
          title: Lookback Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Snapshot Eps Now Api Admin V79 Snapshot Eps Now Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/v79/hmm-fit:
    post:
      tags:
      - admin-v79
      summary: Hmm Fit Endpoint
      description: 'One-time HMM training. Fits a 3-state Gaussian HMM on all

        available joint (VIX, SPY) history and persists the model

        parameters. Run this BEFORE /hmm-compute the first time.'
      operationId: hmm_fit_endpoint_api_admin_v79_hmm_fit_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Hmm Fit Endpoint Api Admin V79 Hmm Fit Post
      security:
      - HTTPBearer: []
  /api/admin/v79/hmm-compute:
    post:
      tags:
      - admin-v79
      summary: Hmm Compute Endpoint
      description: 'Apply the latest trained HMM model to every historical date and

        UPSERT hmm_regime_history. Idempotent on (date).'
      operationId: hmm_compute_endpoint_api_admin_v79_hmm_compute_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Hmm Compute Endpoint Api Admin V79 Hmm Compute Post
      security:
      - HTTPBearer: []
  /api/admin/v79/hmm-latest:
    get:
      tags:
      - admin-v79
      summary: Hmm Latest Endpoint
      description: Return the most recent HMM regime label + posterior probabilities.
      operationId: hmm_latest_endpoint_api_admin_v79_hmm_latest_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Hmm Latest Endpoint Api Admin V79 Hmm Latest Get
      security:
      - HTTPBearer: []
  /api/admin/v79/backfill-earnings-calendar:
    post:
      tags:
      - admin-v79
      summary: Backfill Earnings Calendar Endpoint
      description: 'One-time deep backfill: pull AV EARNINGS history for every v79

        ticker (~879) and insert all historical (symbol, report_date) rows

        into earnings_dates. Idempotent — ON CONFLICT DO NOTHING skips

        existing rows. Takes ~60-90 sec at AV''s 1600/min rate.


        After this completes, the earnings_iv_history backfill (run separately)

        can extract pre/post IV from iv_daily_snapshot''s 18-year archive for

        every ticker × quarter → tens of thousands of crush observations

        instead of the ~500 we have today.'
      operationId: backfill_earnings_calendar_endpoint_api_admin_v79_backfill_earnings_calendar_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Backfill Earnings Calendar Endpoint Api Admin V79 Backfill Earnings Calendar Post
      security:
      - HTTPBearer: []
  /api/admin/v79/run-once:
    post:
      tags:
      - admin-v79
      summary: Manual Run Once
      description: 'Trigger one v7.9 paper-mode cycle on demand. Same code path as the

        daily 13:35 UTC scheduler. dry_run=True runs the full pipeline without

        persisting state or logging signals (safe preview).

        portfolio_value is the fallback if Schwab equity cannot be fetched.'
      operationId: manual_run_once_api_admin_v79_run_once_post
      security:
      - HTTPBearer: []
      parameters:
      - name: dry_run
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Dry Run
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Manual Run Once Api Admin V79 Run Once Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/v79/pins:
    get:
      tags:
      - admin-v79
      summary: List Pins
      description: Return the list of tickers the engine will never sell.
      operationId: list_pins_api_admin_v79_pins_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response List Pins Api Admin V79 Pins Get
      security:
      - HTTPBearer: []
    post:
      tags:
      - admin-v79
      summary: Pin Ticker
      description: 'Add a ticker to the do-not-sell list.


        Body: {"ticker": "PM"}

        The engine will hold this position across all sleeves until explicitly unpinned.'
      operationId: pin_ticker_api_admin_v79_pins_post
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: true
              type: object
              title: Body
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Pin Ticker Api Admin V79 Pins Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/admin/v79/pins/{ticker}:
    delete:
      tags:
      - admin-v79
      summary: Unpin Ticker
      description: Remove a ticker from the do-not-sell list — engine may sell it again.
      operationId: unpin_ticker_api_admin_v79_pins__ticker__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: ticker
        in: path
        required: true
        schema:
          type: string
          title: Ticker
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Unpin Ticker Api Admin V79 Pins  Ticker  Delete
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-refined-from:
- openapi.json
- equity-rank-com-openapi.yml