@startsimpli/api 0.5.18 → 0.5.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@startsimpli/api",
-  "version": "0.5.18",
+  "version": "0.5.19",
   "description": "Type-safe Django REST API client for StartSimpli apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/constants/endpoints.ts

@@ -78,10 +78,9 @@ export const ENDPOINTS = {
   EARNINGS_CALENDAR: 'api/v1/markets/calendar',
   TRADING_SNAPSHOTS: 'api/v1/markets/trading/snapshots',
 
-  // Options (TENTATIVE — schemas to be confirmed by claude-mac via agent_bridge req 42c763b2)
+  // Options — schemas aligned with brain-trading prefs (agent_bridge req b09a6bb6)
   OPTIONS_CHAIN: 'api/v1/markets/options/chain',
-  OPTIONS_IV: 'api/v1/markets/options/iv',
-  OPTIONS_SKEW: 'api/v1/markets/options/skew',
+  OPTIONS_IV_HISTORY: (symbol: string) => `api/v1/markets/instruments/${symbol}/options/iv/history`,
   OPTIONS_GREEKS: 'api/v1/markets/options/greeks',
   VIX_TERM: 'api/v1/markets/vix_term',
 

package/src/index.ts

@@ -237,9 +237,11 @@ export type {
   OptionsChainResponse,
   OptionsIvPoint,
   OptionsIvResponse,
+  OptionsIvHistoryParams,
   OptionsSkewPoint,
-  OptionsSkewResponse,
   OptionsGreeks,
+  VixTenor,
+  VixTermState,
   VixTermPoint,
   VixTermResponse,
 } from './lib/markets-api';

package/src/lib/markets-api.ts

@@ -271,34 +271,40 @@ export interface OptionsChainParams {
   expiry?: string;
 }
 
+// Per brain-trading req b09a6bb6 — atm/skew/put-call ratios as a single snapshot row
 export interface OptionsIvPoint {
-  date: string;
-  iv30: number;
-  iv60: number | null;
-  iv90: number | null;
-  iv30Rank: number | null;
-  iv30Percentile: number | null;
+  snapshotDate: string;
+  atmIv: number;
+  atmCallIv: number | null;
+  atmPutIv: number | null;
+  ivSkew25d: number | null;
+  ivSkewOtmPuts: number | null;
+  putCallVolumeRatio: number | null;
+  putCallOiRatio: number | null;
+  // Populated once 20+ days of history accumulate
+  ivRank30d: number | null;
+  ivRank252d: number | null;
 }
 
 export interface OptionsIvResponse {
   symbol: string;
-  count: number;
   results: OptionsIvPoint[];
 }
 
+export interface OptionsIvHistoryParams {
+  symbol: string;
+  since?: string;
+  until?: string;
+}
+
+// Skew is derived client-side from chain (per brain-trading guidance);
+// kept as a local UI type, not an endpoint.
 export interface OptionsSkewPoint {
   strike: number;
   iv: number;
   side: OptionSide;
 }
 
-export interface OptionsSkewResponse {
-  symbol: string;
-  expiry: string;
-  spot: number;
-  results: OptionsSkewPoint[];
-}
-
 export interface OptionsGreeks {
   symbol: string;
   expiry: string;
@@ -312,15 +318,20 @@ export interface OptionsGreeks {
   computedAt: string | null;
 }
 
+export type VixTenor = '9D' | '30D' | '3M' | string;
+export type VixTermState = 'contango' | 'backwardation';
+
 export interface VixTermPoint {
-  symbol: 'VIX' | 'VIX3M' | 'VIX6M' | 'VIX1Y' | string;
+  tenor: VixTenor;
+  symbol: string;
   value: number;
   percentile252d: number | null;
-  dailyDelta: number | null;
+  delta1d: number | null;
 }
 
 export interface VixTermResponse {
   generatedAt: string;
+  state: VixTermState;
   points: VixTermPoint[];
 }
 
@@ -440,24 +451,24 @@ function coerceContract(c: OptionContract): OptionContract {
 function coerceIvPoint(p: OptionsIvPoint): OptionsIvPoint {
   return {
     ...p,
-    iv30: n(p.iv30),
-    iv60: maybeN(p.iv60),
-    iv90: maybeN(p.iv90),
-    iv30Rank: maybeN(p.iv30Rank),
-    iv30Percentile: maybeN(p.iv30Percentile),
+    atmIv: n(p.atmIv),
+    atmCallIv: maybeN(p.atmCallIv),
+    atmPutIv: maybeN(p.atmPutIv),
+    ivSkew25d: maybeN(p.ivSkew25d),
+    ivSkewOtmPuts: maybeN(p.ivSkewOtmPuts),
+    putCallVolumeRatio: maybeN(p.putCallVolumeRatio),
+    putCallOiRatio: maybeN(p.putCallOiRatio),
+    ivRank30d: maybeN(p.ivRank30d),
+    ivRank252d: maybeN(p.ivRank252d),
   };
 }
 
-function coerceSkewPoint(p: OptionsSkewPoint): OptionsSkewPoint {
-  return { ...p, strike: n(p.strike), iv: n(p.iv) };
-}
-
 function coerceVixPoint(p: VixTermPoint): VixTermPoint {
   return {
     ...p,
     value: n(p.value),
     percentile252d: maybeN(p.percentile252d),
-    dailyDelta: maybeN(p.dailyDelta),
+    delta1d: maybeN(p.delta1d),
   };
 }
 
@@ -539,20 +550,14 @@ export class MarketsApi {
     };
   }
 
-  async getOptionsIv(symbol: string): Promise<OptionsIvResponse> {
-    const res = await this.client.fetch.get<OptionsIvResponse>(ENDPOINTS.OPTIONS_IV, {
-      params: { symbol },
+  async getOptionsIvHistory(params: OptionsIvHistoryParams): Promise<OptionsIvResponse> {
+    const { symbol, ...rest } = params;
+    const res = await this.client.fetch.get<OptionsIvResponse>(ENDPOINTS.OPTIONS_IV_HISTORY(symbol), {
+      params: rest as Record<string, unknown>,
     });
     return { ...res, results: (res.results ?? []).map(coerceIvPoint) };
   }
 
-  async getOptionsSkew(symbol: string, expiry: string): Promise<OptionsSkewResponse> {
-    const res = await this.client.fetch.get<OptionsSkewResponse>(ENDPOINTS.OPTIONS_SKEW, {
-      params: { symbol, expiry },
-    });
-    return { ...res, spot: n(res.spot), results: (res.results ?? []).map(coerceSkewPoint) };
-  }
-
   async getOptionsGreeks(symbol: string, expiry: string, strike: number, side: OptionSide): Promise<OptionsGreeks> {
     const res = await this.client.fetch.get<OptionsGreeks>(ENDPOINTS.OPTIONS_GREEKS, {
       params: { symbol, expiry, strike, side },