@startsimpli/api 0.5.15 → 0.5.17

package/package.json

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

package/src/constants/endpoints.ts

@@ -74,6 +74,9 @@ export const ENDPOINTS = {
   INSTRUMENT_ANALYTICS: (symbol: string) => `api/v1/markets/instruments/${symbol}/analytics`,
   INSTRUMENT_NEWS: (symbol: string) => `api/v1/markets/instruments/${symbol}/news`,
   MARKETS_HEALTH: 'api/v1/markets/health',
+  SECTOR_BREADTH: 'api/v1/markets/sector_breadth',
+  EARNINGS_CALENDAR: 'api/v1/markets/calendar',
+  TRADING_SNAPSHOTS: 'api/v1/markets/trading/snapshots',
 
   // Sources ops
   SOURCES_HEALTH: 'api/v1/sources/ops/health',

package/src/index.ts

@@ -205,6 +205,9 @@ export type {
   VolatilityPoint,
   BetaAnalytics,
   PairSpreadPoint,
+  NewsDirection,
+  NewsSentimentLabel,
+  NewsEventType,
   InstrumentNewsItem,
   InstrumentNewsResponse,
   NewsParams,
@@ -212,4 +215,20 @@ export type {
   InstrumentHealthInterval,
   SourceInstanceHealth,
   MarketsHealth,
+  SectorBreadthParams,
+  SectorBreadthPoint,
+  SectorBreadthResponse,
+  EarningsCalendarParams,
+  EarningsTimeOfDay,
+  EarningsCalendarRow,
+  EarningsCalendarResponse,
+  PairConsensus,
+  CommitteeVotes,
+  PairMember,
+  PairSnapshot,
+  AlpacaPosition,
+  AlpacaSnapshot,
+  TradingSnapshot,
+  TradingSnapshotsResponse,
+  TradingSnapshotsParams,
 } from './lib/markets-api';

package/src/lib/markets-api.ts

@@ -92,17 +92,34 @@ export type AnalyticsResponse =
   | BetaAnalytics
   | PairSpreadPoint[];
 
+export type NewsDirection = 'bullish' | 'bearish' | 'neutral' | 'unclear';
+export type NewsSentimentLabel = 'positive' | 'neutral' | 'negative';
+export type NewsEventType =
+  | 'ceasefire'
+  | 'escalation'
+  | 'supply_disruption'
+  | 'opec'
+  | 'earnings'
+  | 'central_bank'
+  | 'regulatory'
+  | 'general';
+
 export interface InstrumentNewsItem {
   id: string;
-  title: string;
+  title: string | null;
   summary?: string | null;
-  url: string;
+  url: string | null;
   publisherName?: string | null;
   publisherDomain?: string | null;
   publishedAt?: string | null;
   queryTag?: string | null;
-  confidence?: number | null;
-  ingestedAt?: string | null;
+  confidence: number;
+  direction: NewsDirection | null;
+  sentiment: number | null;
+  sentimentLabel: NewsSentimentLabel | null;
+  eventType: NewsEventType;
+  marketMovingScore: number;
+  ingestedAt: string;
 }
 
 export interface InstrumentNewsResponse {
@@ -117,6 +134,122 @@ export interface NewsParams {
   since?: string;
 }
 
+export interface SectorBreadthParams {
+  sector: string;
+  since?: string;
+  until?: string;
+}
+
+export interface SectorBreadthPoint {
+  barDate: string;
+  nUp: number;
+  nTotal: number;
+  pctUp: number;
+  meanReturn: number;
+  returnDispersion: number;
+}
+
+export interface SectorBreadthResponse {
+  sector: string;
+  interval: '1d';
+  members: string[];
+  count: number;
+  results: SectorBreadthPoint[];
+}
+
+export interface EarningsCalendarParams {
+  symbols: string[];
+  since?: string;
+  until?: string;
+}
+
+export type EarningsTimeOfDay = 'BMO' | 'AMC' | 'During' | 'Unknown';
+
+export interface EarningsCalendarRow {
+  date: string;
+  symbol: string;
+  eventType: 'earnings';
+  confirmed: boolean;
+  timeOfDay: EarningsTimeOfDay;
+  epsEstimate: number | null;
+  reportedEps: number | null;
+  surprisePct: number | null;
+}
+
+export interface EarningsCalendarResponse {
+  symbolsRequested: string[];
+  since: string | null;
+  until: string | null;
+  count: number;
+  errors: Record<string, string>;
+  results: EarningsCalendarRow[];
+}
+
+export type PairConsensus = 'BULL' | 'BEAR' | 'FLAT';
+
+export interface CommitteeVotes {
+  BULL: number;
+  BEAR: number;
+  FLAT: number;
+}
+
+export interface PairMember {
+  modelName: string;
+  features: string[];
+  thresholds: [number, number];
+  scoreToday: number;
+  signalToday: number;
+  endValueFull?: number | null;
+}
+
+export interface PairSnapshot {
+  consensus: PairConsensus;
+  topScore: number;
+  topSignal: number;
+  targetSymbol: string;
+  committeeN: number;
+  committeeVotes: CommitteeVotes;
+  committeeMeanScore: number;
+  topConfigName: string;
+  members: PairMember[];
+  [key: string]: unknown;
+}
+
+export interface AlpacaPosition {
+  symbol: string;
+  qty: number;
+  marketValue: number;
+  costBasis: number;
+  unrealizedPl: number;
+  [key: string]: unknown;
+}
+
+export interface AlpacaSnapshot {
+  equity: number;
+  cash: number;
+  buyingPower: number;
+  positions: AlpacaPosition[];
+}
+
+export interface TradingSnapshot {
+  id: string;
+  timestampUtc: string;
+  createdAt: string;
+  alpaca: AlpacaSnapshot;
+  pairs: Record<string, PairSnapshot>;
+  notes?: string | null;
+}
+
+export interface TradingSnapshotsResponse {
+  count: number;
+  results: TradingSnapshot[];
+}
+
+export interface TradingSnapshotsParams {
+  since?: string;
+  limit?: number;
+}
+
 export interface InstrumentHealthInterval {
   interval: BarInterval;
   barCount: number;
@@ -190,4 +323,23 @@ export class MarketsApi {
   async getHealth(): Promise<MarketsHealth> {
     return this.client.fetch.get<MarketsHealth>(ENDPOINTS.MARKETS_HEALTH);
   }
+
+  async getSectorBreadth(params: SectorBreadthParams): Promise<SectorBreadthResponse> {
+    return this.client.fetch.get<SectorBreadthResponse>(ENDPOINTS.SECTOR_BREADTH, {
+      params: params as unknown as Record<string, unknown>,
+    });
+  }
+
+  async getEarningsCalendar(params: EarningsCalendarParams): Promise<EarningsCalendarResponse> {
+    const { symbols, ...rest } = params;
+    return this.client.fetch.get<EarningsCalendarResponse>(ENDPOINTS.EARNINGS_CALENDAR, {
+      params: { ...rest, symbols: symbols.join(',') } as unknown as Record<string, unknown>,
+    });
+  }
+
+  async getTradingSnapshots(params?: TradingSnapshotsParams): Promise<TradingSnapshotsResponse> {
+    return this.client.fetch.get<TradingSnapshotsResponse>(ENDPOINTS.TRADING_SNAPSHOTS, {
+      params: params as Record<string, unknown> | undefined,
+    });
+  }
 }