Instrument Master
The master catalogue of every tradable instrument — symbols, tokens, expiries, lot sizes and status — that the rest of the platform references.
Instrument master.
Purpose
Instruments are shared reference data for your deployment, not owned by any one user. Orders, market data, strategies and the option chain all resolve against this catalogue, so an instrument’s status here governs whether it can be traded anywhere on the platform.
An instrument must be Active to be placed in an order. Reference changes are tracked historically so the catalogue stays auditable.
The Instrument Master module maintains the master catalogue of all tradable financial instruments supported by the platform.
It provides a single, authoritative source of reference information for instruments across all business modules.
The Instrument Master serves as the foundation for market data, trading, analytics and reporting.
Objectives
The module will:
- Maintain a central repository of tradable instruments.
- Provide unique identification for every instrument.
- Store instrument reference information.
- Support multiple exchanges and asset classes.
- Enable efficient instrument discovery.
- Maintain historical reference data where applicable.
- Supply instrument information to dependent business modules.
Functional Scope
The module includes:
- Instrument Master Repository
- Instrument Classification
- Exchange Management
- Symbol Management
- Instrument Search
- Instrument Status Management
- Instrument Lifecycle
- Instrument Metadata
- Instrument Relationships
- Instrument History
Instrument Model
An instrument represents a tradable financial security recognised by one or more exchanges.
Every instrument will maintain a unique identity within the platform.
Reference information remains independent of live market data.
Supported Asset Classes
The platform will support multiple asset classes including:
- Equity
- Futures
- Options
- Indices
- Exchange Traded Funds (ETF)
- Commodities
- Currency Derivatives
The design remains extensible for future asset classes.
Exchange Management
The platform will support instruments listed on multiple exchanges.
Examples include:
- NSE
- BSE
- MCX
Each instrument will maintain its associated exchange information.
Instrument Identification
Every instrument will maintain unique identification.
Typical identifiers include:
- Exchange
- Trading Symbol
- Instrument Token
- Instrument Type
Additional identifiers may be maintained where required.
Instrument Metadata
The platform will maintain reference information for every instrument.
Typical information includes:
- Instrument Name
- Trading Symbol
- Exchange
- Asset Class
- Instrument Type
- Trading Status
- Lot Size
- Tick Size
- Price Precision
- Expiry Date (where applicable)
- Strike Price (where applicable)
- Option Type (where applicable)
Instrument Classification
The platform will classify instruments using business categories.
Typical classifications include:
- Exchange
- Asset Class
- Industry
- Sector
- Instrument Type
Classification will support efficient search and filtering.
Instrument Lifecycle
Every instrument will maintain a lifecycle status.
Typical statuses include:
- Active
- Suspended
- Expired
- Delisted
Only Active instruments is eligible for trading.
Instrument Relationships
The platform will maintain logical relationships between instruments where applicable.
Examples include:
- Underlying Instrument
- Option Contracts
- Futures Contracts
- Index Constituents
Relationships will support navigation and analytical functions.
Instrument Search
Users and business modules is able to search instruments.
Search capabilities includes:
- Trading Symbol
- Instrument Name
- Exchange
- Asset Class
- Sector
- Industry
- Instrument Type
Filtering and sorting is supported.
Instrument Availability
Only Active instruments is available for:
- Trading
- Strategy Configuration
- Watchlists
- Scanners
- Backtesting
- Market Data
- Portfolio Reporting
Inactive instruments remains available for historical purposes.
Instrument Synchronisation
The platform will support synchronisation of the Instrument Master with supported broker and exchange reference data.
Synchronisation will detect:
- New Instruments
- Updated Instruments
- Expired Instruments
- Delisted Instruments
Reference data remains internally consistent.
Historical Reference
Historical reference information is preserved where applicable.
Historical information may include:
- Symbol Changes
- Name Changes
- Lot Size Changes
- Tick Size Changes
- Classification Changes
Historical records remains immutable.
Business Rules
- Every instrument will maintain a unique identity.
- Instrument reference data remains independent of market data.
- Only Active instruments is eligible for trading.
- Historical reference information will never be deleted.
- Instrument relationships is maintained where applicable.
- Reference updates does not affect historical trading records.
- Instrument Master is the authoritative source of instrument information.
Audit Requirements
The platform will maintain an audit trail for Instrument Master activities.
Audit events includes:
- Instrument Creation
- Instrument Update
- Instrument Activation
- Instrument Suspension
- Instrument Expiry
- Instrument Delisting
- Synchronisation Events
Audit records remains immutable.
Out of Scope
The following are outside the scope of this module:
- Live Market Prices
- Historical OHLC Data
- Order Execution
- Trading Strategies
- Portfolio Calculations
- Risk Evaluation
These are addressed by their respective business modules.