MyAlgoGuru Help
Education Glossary Open the app
Help/Reference/Market Data

Instrument Master

The master catalogue of every tradable instrument — symbols, tokens, expiries, lot sizes and status — that the rest of the platform references.

Where you will find this

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.

Only Active instruments trade

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:

  1. Instrument Master Repository
  2. Instrument Classification
  3. Exchange Management
  4. Symbol Management
  5. Instrument Search
  6. Instrument Status Management
  7. Instrument Lifecycle
  8. Instrument Metadata
  9. Instrument Relationships
  10. 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:

  1. NSE
  2. BSE
  3. 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.

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.