Snapshot schema

Source: src/utils/zerodha/zerodha-event.utils.ts → buildSnapshot() Each active index setting produces a snapshot object on every broadcast interval. Snapshots are:

Stored in latestSnapshotData (in-memory Map)
Mirrored to latestDataMap in socket-manager.ts
Emitted via Socket.IO as {indexName}TickData
Persisted to IndexData MongoDB collection

Top-level snapshot

Field	Type	Description
`type`	string	Lowercase index key (e.g. `nifty`, `banknifty`)
`date`	string	`DD/MM/YYYY` (IST)
`dayName`	string	Day of week
`time`	string	`HH:mm:ss` (IST)
`dataProvider`	string	Always `"zerodha"`
`segments`	string[]	Active segments: `cash`, `futures`, `options`
`baseValue`	number	Price from the active segment
`cash`	object	Cash segment snapshot (if enabled)
`futures`	object	Futures segment snapshot (if enabled)
`options`	object	Options segment snapshot (if enabled)

Legacy flat fields (from options)

When options are active, OI and bid/ask fields are flattened to the top level for backward compatibility with the financial table UI:

Group	Fields
OI	`call`, `call1`, `put`, `put1`, `callPut`, `callPut1`, `putCall`, `putCall1`
Ask/Bid	`callAskPrice`, `callBidPrice`, `putAskPrice`, `putBidPrice`, + `1` variants, callPut/putCall variants
Differences	`callAskPriceDifference`, `callBidPriceDifference`, `putAskPriceDifference`, `putBidPriceDifference`, + `1` variants

Cash segment (`cash`)

Field	Type	Description
`instrumentToken`	number	Token
`tradingsymbol`	string	Symbol
`exchange`	string	`"NSE"`
`lotSize`	number	Lot size
`lastPrice`	number	LTP
`open`, `high`, `low`, `close`	number	OHLC
`change`	number	Price change
`volume`	number	Traded volume

Futures segment (`futures`)

Field	Type	Description
`instrumentToken`	number	Active contract token
`tradingsymbol`	string	Contract symbol
`exchange`	string	From index setting
`expiryDate`	string	Active expiry
`expiryType`	string	`weekly` or `monthly`
`contractFormat`	string	Symbol format
`lotSize`	number	Lot size
`lastPrice`	number	LTP
OHLC + volume	number	Quote fields

Options segment (`options`)

Field	Type	Description
`underlyingLastPrice`	number	Spot or futures underlying LTP
`underlyingToken`	number	Underlying instrument token
`expiryDate`	string	Active option expiry
`strikes`	object	Calculated strike map with CE/PE quotes
`atmStrike`	number	At-the-money strike
`legacyFields`	object	Flattened OI/bid/ask (merged to top level before emit)

Strike entry

Each strike in the chain contains:

Field	Description
`strike`	Strike price
`ce.tradingsymbol`	Call symbol
`ce.lastPrice`	Call LTP
`ce.oi`	Call open interest
`ce.bid`, `ce.ask`	Call bid/ask
`pe.*`	Same fields for put leg

baseValue resolution

getActiveSegmentValue selects baseValue based on activeSegment:

activeSegment	Source
`cash`	`cash.lastPrice`
`futures`	`futures.lastPrice`
`options`	`options.underlyingLastPrice`

Fallback: options underlying → futures LTP → cash LTP → 0.

Consumers

Consumer	Usage
`RecurringOrderController`	Reads `baseValue`, strike data for buy triggers
`ScheduleOrderController`	Reads prices for trailing sell and strike match
`zerodha.controller`	Attaches `baseValue` to placed orders
Financial table (frontend)	Receives via `{index}TickData` socket event
`IndexData` collection	Persisted snapshot for historical queries

See Latest data map and Data flow for the full pipeline.

Architecture

Authentication

Database Models

API Reference

Trading Engine

Zerodha Integration

Real-time

Reference

Top-level snapshot

Legacy flat fields (from options)

Cash segment (`cash`)

Futures segment (`futures`)

Options segment (`options`)

Strike entry

baseValue resolution

Consumers

​Top-level snapshot

​Legacy flat fields (from options)

​Cash segment (cash)

​Futures segment (futures)

​Options segment (options)

​Strike entry

​baseValue resolution

​Consumers

Top-level snapshot

Legacy flat fields (from options)

Cash segment (`cash`)

Futures segment (`futures`)

Options segment (`options`)

Strike entry

baseValue resolution

Consumers