DhanHQ 2.1.7 → 2.1.10

data/lib/DhanHQ/models/ledger_entry.rb

@@ -3,34 +3,98 @@
 module DhanHQ
   module Models
     ##
-    # Represents a single row/entry in the Ledger.
-    # Ledger data typically returns an array of these objects.
+    # Model representing a single ledger entry in the Trading Account Ledger Report.
+    #
+    # The Ledger Report contains all credit and debit transaction details for a particular time interval.
+    # Each entry represents a single transaction with details such as narration, voucher information,
+    # debit/credit amounts, and running balance.
+    #
+    # @example Fetch ledger entries for a date range
+    #   entries = DhanHQ::Models::LedgerEntry.all(
+    #     from_date: "2024-04-01",
+    #     to_date: "2024-04-30"
+    #   )
+    #   entries.each do |entry|
+    #     puts "#{entry.voucherdate}: #{entry.narration} - #{entry.debit} / #{entry.credit}"
+    #   end
+    #
+    # @example Calculate total credits and debits
+    #   entries = DhanHQ::Models::LedgerEntry.all(
+    #     from_date: "2024-04-01",
+    #     to_date: "2024-04-30"
+    #   )
+    #   total_debits = entries.sum { |e| e.debit.to_f }
+    #   total_credits = entries.sum { |e| e.credit.to_f }
+    #
     class LedgerEntry < BaseModel
-      # The endpoint is /v2/ledger?from-date=...&to-date=...
-      # So we may define a resource path or rely on the Statements resource.
+      # Base path for ledger endpoint.
       HTTP_PATH = "/v2/ledger"
 
-      # Typical fields from API docs
       attributes :dhan_client_id, :narration, :voucherdate, :exchange,
                  :voucherdesc, :vouchernumber, :debit, :credit, :runbal
 
       class << self
         ##
-        # Provides a **shared instance** of the `Statements` resource.
+        # Provides a shared instance of the Statements resource.
         #
-        # @return [DhanHQ::Resources::Statements]
+        # @return [DhanHQ::Resources::Statements] The Statements resource client instance
         def resource
           @resource ||= DhanHQ::Resources::Statements.new
         end
 
         ##
-        # Fetch ledger entries for the given date range.
+        # Retrieves Trading Account Ledger Report entries for the specified date range.
         #
-        # @param from_date [String] e.g. "2023-01-01"
-        # @param to_date   [String] e.g. "2023-01-31"
-        # @return [Array<LedgerEntry>]
+        # Fetches all credit and debit transaction details for the given time interval.
+        # The ledger entries include transaction descriptions, voucher information, amounts,
+        # and running balances.
+        #
+        # @param from_date [String] Start date of the ledger report in YYYY-MM-DD format.
+        #   Example: "2024-04-01"
+        # @param to_date [String] End date of the ledger report in YYYY-MM-DD format.
+        #   Example: "2024-04-30"
+        #
+        # @return [Array<LedgerEntry>] Array of LedgerEntry objects. Returns empty array if no entries exist.
+        #   Each LedgerEntry object contains (keys normalized to snake_case):
+        #   - **:dhan_client_id** [String] User-specific identification generated by Dhan
+        #   - **:narration** [String] Description of the ledger transaction (e.g., "FUNDS WITHDRAWAL", "CLOSING BALANCE")
+        #   - **:voucherdate** [String] Transaction date in format "Mon DD, YYYY" (e.g., "Jun 22, 2022")
+        #   - **:exchange** [String] Exchange information for the transaction (e.g., "NSE-CAPITAL", "NSE_CASH")
+        #   - **:voucherdesc** [String] Nature of transaction (e.g., "PAYBNK", "CLOSING BALANCE", "OPENING BALANCE")
+        #   - **:vouchernumber** [String] System generated transaction number. May be empty string for balance entries
+        #   - **:debit** [String] Debit amount as string. Only populated when credit returns "0.00"
+        #   - **:credit** [String] Credit amount as string. Only populated when debit returns "0.00"
+        #   - **:runbal** [String] Running balance post transaction as string
+        #
+        # @example Fetch ledger entries for a month
+        #   entries = DhanHQ::Models::LedgerEntry.all(
+        #     from_date: "2024-04-01",
+        #     to_date: "2024-04-30"
+        #   )
+        #   entries.each do |entry|
+        #     puts "#{entry.voucherdate}: #{entry.narration} - Balance: #{entry.runbal}"
+        #   end
+        #
+        # @example Filter entries by transaction type
+        #   entries = DhanHQ::Models::LedgerEntry.all(
+        #     from_date: "2024-04-01",
+        #     to_date: "2024-04-30"
+        #   )
+        #   withdrawals = entries.select { |e| e.voucherdesc == "PAYBNK" }
+        #   puts "Total withdrawals: #{withdrawals.size}"
+        #
+        # @example Calculate net balance change
+        #   entries = DhanHQ::Models::LedgerEntry.all(
+        #     from_date: "2024-04-01",
+        #     to_date: "2024-04-30"
+        #   )
+        #   net_change = entries.sum { |e| e.credit.to_f - e.debit.to_f }
+        #   puts "Net change: ₹#{net_change}"
+        #
+        # @note This is a GET request with query parameters. No body required.
+        # @note The ledger report represents historical data dumps and entries are returned as-is
+        #   without additional validation.
         def all(from_date:, to_date:)
-          # The resource call returns an Array<Hash>, according to the docs.
           response = resource.ledger(from_date: from_date, to_date: to_date)
 
           return [] unless response.is_a?(Array)
@@ -41,7 +105,31 @@ module DhanHQ
         end
       end
 
-      # Optional: you can override #to_h or #inspect if you want a custom representation
+      ##
+      # Converts the LedgerEntry model attributes to a hash representation.
+      #
+      # Useful for serialization, logging, or passing ledger entry data to other methods.
+      #
+      # @return [Hash{Symbol => String}] Hash representation of the LedgerEntry model containing:
+      #   - **:dhan_client_id** [String] User-specific identification
+      #   - **:narration** [String] Transaction description
+      #   - **:voucherdate** [String] Transaction date
+      #   - **:exchange** [String] Exchange information
+      #   - **:voucherdesc** [String] Nature of transaction
+      #   - **:vouchernumber** [String] Transaction number
+      #   - **:debit** [String] Debit amount
+      #   - **:credit** [String] Credit amount
+      #   - **:runbal** [String] Running balance
+      #
+      # @example Convert entry to hash
+      #   entry = DhanHQ::Models::LedgerEntry.all(
+      #     from_date: "2024-04-01",
+      #     to_date: "2024-04-30"
+      #   ).first
+      #   entry_hash = entry.to_h
+      #   puts entry_hash[:narration]  # => "FUNDS WITHDRAWAL"
+      #   puts entry_hash[:runbal]      # => "957.29"
+      #
       def to_h
         {
           dhan_client_id: dhan_client_id,

data/lib/DhanHQ/models/margin.rb

@@ -2,7 +2,47 @@
 
 module DhanHQ
   module Models
-    # Model for the on-demand margin calculator response.
+    ##
+    # Model for fetching margin calculation results for orders.
+    #
+    # The Margin Calculator API provides span margin, exposure margin, VAR (variable margin),
+    # brokerage, leverage, and available margin values for any type of order and instrument
+    # you want to place. This helps you determine the margin requirements before placing an order.
+    #
+    # @example Calculate margin for a CNC order
+    #   margin = DhanHQ::Models::Margin.calculate(
+    #     dhan_client_id: "1000000132",
+    #     exchange_segment: "NSE_EQ",
+    #     transaction_type: "BUY",
+    #     quantity: 5,
+    #     product_type: "CNC",
+    #     security_id: "1333",
+    #     price: 1428.0
+    #   )
+    #   puts "Total margin required: ₹#{margin.total_margin}"
+    #   puts "Available balance: ₹#{margin.available_balance}"
+    #
+    # @example Calculate margin for stop-loss order
+    #   margin = DhanHQ::Models::Margin.calculate(
+    #     dhan_client_id: "1000000132",
+    #     exchange_segment: "NSE_EQ",
+    #     transaction_type: "BUY",
+    #     quantity: 10,
+    #     product_type: "INTRADAY",
+    #     security_id: "1333",
+    #     price: 1428.0,
+    #     trigger_price: 1427.0
+    #   )
+    #   puts "Leverage: #{margin.leverage}x"
+    #
+    # @example Check if sufficient margin is available
+    #   margin = DhanHQ::Models::Margin.calculate(params)
+    #   if margin.insufficient_balance > 0
+    #     puts "Insufficient balance: ₹#{margin.insufficient_balance}"
+    #   else
+    #     puts "Sufficient margin available"
+    #   end
+    #
     class Margin < BaseModel
       # Base path used to invoke the calculator.
       HTTP_PATH = "/v2/margincalculator"
@@ -12,18 +52,86 @@ module DhanHQ
 
       class << self
         ##
-        # Provides a **shared instance** of the `MarginCalculator` resource.
+        # Provides a shared instance of the MarginCalculator resource.
         #
-        # @return [DhanHQ::Resources::MarginCalculator]
+        # @return [DhanHQ::Resources::MarginCalculator] The MarginCalculator resource client instance
         def resource
           @resource ||= DhanHQ::Resources::MarginCalculator.new
         end
 
         ##
-        # Calculate margin requirements for an order.
+        # Calculates margin requirements for an order before placement.
         #
-        # @param params [Hash] Request parameters for margin calculation.
-        # @return [Margin]
+        # Fetches span margin, exposure margin, VAR (variable margin), brokerage, leverage,
+        # and available margin values for the specified order parameters. This allows you to
+        # check margin requirements and availability before actually placing the order.
+        #
+        # @param params [Hash{Symbol => String, Integer, Float}] Request parameters for margin calculation
+        #   @option params [String] :dhan_client_id (required) User-specific identification generated by Dhan.
+        #     Must be explicitly provided in the params hash
+        #   @option params [String] :exchange_segment (required) Exchange and segment identifier.
+        #     Valid values: "NSE_EQ", "NSE_FNO", "BSE_EQ", "BSE_FNO", "MCX_COMM"
+        #   @option params [String] :transaction_type (required) The trading side of transaction.
+        #     Valid values: "BUY", "SELL"
+        #   @option params [Integer] :quantity (required) Number of shares for the order. Must be greater than 0
+        #   @option params [String] :product_type (required) Product type.
+        #     Valid values: "CNC", "INTRADAY", "MARGIN", "MTF", "CO", "BO"
+        #   @option params [String] :security_id (required) Exchange standard ID for each scrip
+        #   @option params [Float] :price (required) Price at which order is placed. Must be greater than 0
+        #   @option params [Float] :trigger_price (conditionally required) Price at which the order is triggered.
+        #     Required for STOP_LOSS and STOP_LOSS_MARKET order types
+        #
+        # @return [Margin] Margin object containing margin calculation results.
+        #   Response structure (keys normalized to snake_case):
+        #   - **:total_margin** [Float] Total margin required for placing the order successfully
+        #   - **:span_margin** [Float] SPAN margin required
+        #   - **:exposure_margin** [Float] Exposure margin required
+        #   - **:available_balance** [Float] Available amount in trading account
+        #   - **:variable_margin** [Float] VAR or Variable margin required
+        #   - **:insufficient_balance** [Float] Insufficient amount in trading account
+        #     (Available Balance - Total Margin). Negative or zero indicates sufficient margin
+        #   - **:brokerage** [Float] Brokerage charges for executing the order
+        #   - **:leverage** [String] Margin leverage provided for the order as per product type
+        #
+        # @example Calculate margin for CNC equity order
+        #   margin = DhanHQ::Models::Margin.calculate(
+        #     dhan_client_id: "1000000132",
+        #     exchange_segment: "NSE_EQ",
+        #     transaction_type: "BUY",
+        #     quantity: 5,
+        #     product_type: "CNC",
+        #     security_id: "1333",
+        #     price: 1428.0
+        #   )
+        #   puts "Total Margin: ₹#{margin.total_margin}"
+        #   puts "Brokerage: ₹#{margin.brokerage}"
+        #
+        # @example Calculate margin for intraday order
+        #   margin = DhanHQ::Models::Margin.calculate(
+        #     dhan_client_id: "1000000132",
+        #     exchange_segment: "NSE_EQ",
+        #     transaction_type: "SELL",
+        #     quantity: 10,
+        #     product_type: "INTRADAY",
+        #     security_id: "1333",
+        #     price: 1500.0
+        #   )
+        #   puts "Leverage: #{margin.leverage}x"
+        #   puts "SPAN Margin: ₹#{margin.span_margin}"
+        #
+        # @example Calculate margin for stop-loss order
+        #   margin = DhanHQ::Models::Margin.calculate(
+        #     dhan_client_id: "1000000132",
+        #     exchange_segment: "NSE_EQ",
+        #     transaction_type: "BUY",
+        #     quantity: 5,
+        #     product_type: "INTRADAY",
+        #     security_id: "1333",
+        #     price: 1428.0,
+        #     trigger_price: 1427.0
+        #   )
+        #
+        # @raise [DhanHQ::ValidationError] If validation fails for any parameter
         def calculate(params)
           formatted_params = camelize_keys(params)
           validate_params!(formatted_params, DhanHQ::Contracts::MarginCalculatorContract)
@@ -34,9 +142,26 @@ module DhanHQ
       end
 
       ##
-      # Convert model attributes to a hash.
+      # Converts the Margin model attributes to a hash representation.
+      #
+      # Useful for serialization, logging, or passing margin data to other methods.
+      #
+      # @return [Hash{Symbol => Float, String}] Hash representation of the Margin model containing:
+      #   - **:total_margin** [Float] Total margin required
+      #   - **:span_margin** [Float] SPAN margin
+      #   - **:exposure_margin** [Float] Exposure margin
+      #   - **:available_balance** [Float] Available balance
+      #   - **:variable_margin** [Float] Variable margin
+      #   - **:insufficient_balance** [Float] Insufficient balance amount
+      #   - **:brokerage** [Float] Brokerage charges
+      #   - **:leverage** [String] Leverage as string
+      #
+      # @example Convert margin to hash
+      #   margin = DhanHQ::Models::Margin.calculate(params)
+      #   margin_hash = margin.to_h
+      #   puts margin_hash[:total_margin]  # => 2800.00
+      #   puts margin_hash[:leverage]       # => "4.00"
       #
-      # @return [Hash] Hash representation of the Margin model.
       def to_h
         {
           total_margin: total_margin,

data/lib/DhanHQ/models/market_feed.rb

@@ -2,39 +2,203 @@
 
 module DhanHQ
   module Models
-    # Lightweight wrapper exposing market feed resources.
+    ##
+    # Model for fetching real-time market snapshots for multiple instruments.
+    #
+    # The Market Feed API provides snapshots of multiple instruments at once. You can fetch
+    # LTP (Last Traded Price), OHLC (Open, High, Low, Close), or Market Depth (quote) data
+    # for instruments via a single API request. Data is returned in real-time at the time
+    # of the API request.
+    #
+    # @note **Rate Limits**: You can fetch up to 1000 instruments in a single API request
+    #   with a rate limit of 1 request per second. The client's internal rate limiter
+    #   automatically throttles calls to prevent exceeding limits.
+    #
+    # @example Fetch LTP for multiple instruments
+    #   payload = {
+    #     "NSE_EQ" => [11536, 3456],
+    #     "NSE_FNO" => [49081, 49082]
+    #   }
+    #   response = DhanHQ::Models::MarketFeed.ltp(payload)
+    #   nse_eq_data = response[:data]["NSE_EQ"]
+    #   puts "TCS LTP: ₹#{nse_eq_data["11536"][:last_price]}"
+    #
+    # @example Fetch OHLC data for equity instruments
+    #   payload = {
+    #     "NSE_EQ" => [11536]
+    #   }
+    #   response = DhanHQ::Models::MarketFeed.ohlc(payload)
+    #   tcs_data = response[:data]["NSE_EQ"]["11536"]
+    #   puts "Open: ₹#{tcs_data[:ohlc][:open]}"
+    #   puts "High: ₹#{tcs_data[:ohlc][:high]}"
+    #
+    # @example Fetch full market depth quote
+    #   payload = {
+    #     "NSE_FNO" => [49081]
+    #   }
+    #   response = DhanHQ::Models::MarketFeed.quote(payload)
+    #   quote_data = response[:data]["NSE_FNO"]["49081"]
+    #   puts "Volume: #{quote_data[:volume]}"
+    #   puts "Open Interest: #{quote_data[:oi]}"
+    #
     class MarketFeed < BaseModel
       class << self
-        # Fetches last traded price snapshots.
+        ##
+        # Provides a shared instance of the MarketFeed resource.
+        #
+        # @return [DhanHQ::Resources::MarketFeed] The MarketFeed resource client instance
+        def resource
+          @resource ||= DhanHQ::Resources::MarketFeed.new
+        end
+
+        ##
+        # Fetches Last Traded Price (LTP) snapshots for multiple instruments.
+        #
+        # Retrieves the last traded price for a list of instruments with a single API request.
+        # Supports up to 1000 instruments per request, organized by exchange segment.
+        #
+        # @param params [Hash{String => Array<Integer>}] Request payload mapping exchange segments
+        #   to arrays of security IDs. Exchange segments are keys (e.g., "NSE_EQ", "NSE_FNO", "BSE_EQ").
+        #   Values are arrays of security IDs (integer identifiers for each scrip).
+        #   Valid exchange segment values: "NSE_EQ", "NSE_FNO", "BSE_EQ", "BSE_FNO", etc.
+        #
+        # @return [HashWithIndifferentAccess] Response hash containing market data.
+        #   Response structure:
+        #   - **:data** [Hash{String => Hash{String => Hash}}] Market data organized by exchange segment
+        #     and security ID. Each instrument's data contains:
+        #     - **:last_price** [Float] Last traded price of the instrument
+        #   - **:status** [String] Response status (typically "success")
+        #
+        # @example Fetch LTP for equity and F&O instruments
+        #   payload = {
+        #     "NSE_EQ" => [11536],
+        #     "NSE_FNO" => [49081, 49082]
+        #   }
+        #   response = DhanHQ::Models::MarketFeed.ltp(payload)
+        #   tcs_ltp = response[:data]["NSE_EQ"]["11536"][:last_price]
+        #   puts "TCS LTP: ₹#{tcs_ltp}"
+        #
+        # @example Access data from response
+        #   response = DhanHQ::Models::MarketFeed.ltp("NSE_EQ" => [11536])
+        #   data = response[:data]["NSE_EQ"]["11536"]
+        #   puts "Last Price: ₹#{data[:last_price]}"
         #
-        # @param params [Hash]
-        # @return [Hash]
         def ltp(params)
           resource.ltp(params)
         end
 
-        # Fetches OHLC data for the requested instruments.
+        ##
+        # Fetches OHLC (Open, High, Low, Close) data along with LTP for specified instruments.
+        #
+        # Retrieves the open, high, low, and close prices along with the last traded price
+        # for a list of instruments. Supports up to 1000 instruments per request.
+        #
+        # @param params [Hash{String => Array<Integer>}] Request payload mapping exchange segments
+        #   to arrays of security IDs. Exchange segments are keys (e.g., "NSE_EQ", "NSE_FNO", "BSE_EQ").
+        #   Values are arrays of security IDs (integer identifiers for each scrip).
+        #   Valid exchange segment values: "NSE_EQ", "NSE_FNO", "BSE_EQ", "BSE_FNO", etc.
+        #
+        # @return [HashWithIndifferentAccess] Response hash containing OHLC market data.
+        #   Response structure:
+        #   - **:data** [Hash{String => Hash{String => Hash}}] Market data organized by exchange segment
+        #     and security ID. Each instrument's data contains:
+        #     - **:last_price** [Float] Last traded price of the instrument
+        #     - **:ohlc** [Hash{Symbol => Float}] OHLC data:
+        #       - **:open** [Float] Market opening price of the day
+        #       - **:close** [Float] Market closing price of the day (previous day close for current session)
+        #       - **:high** [Float] Day high price
+        #       - **:low** [Float] Day low price
+        #   - **:status** [String] Response status (typically "success")
+        #
+        # @note For newly listed instruments or instruments without trading activity,
+        #   OHLC values may be 0. The close price typically represents the previous day's
+        #   closing price during the current trading session.
+        #
+        # @example Fetch OHLC for equity instruments
+        #   payload = {
+        #     "NSE_EQ" => [11536]
+        #   }
+        #   response = DhanHQ::Models::MarketFeed.ohlc(payload)
+        #   tcs_data = response[:data]["NSE_EQ"]["11536"]
+        #   puts "Open: ₹#{tcs_data[:ohlc][:open]}"
+        #   puts "High: ₹#{tcs_data[:ohlc][:high]}"
+        #   puts "Low: ₹#{tcs_data[:ohlc][:low]}"
+        #   puts "Close: ₹#{tcs_data[:ohlc][:close]}"
+        #   puts "LTP: ₹#{tcs_data[:last_price]}"
         #
-        # @param params [Hash]
-        # @return [Hash]
         def ohlc(params)
           resource.ohlc(params)
         end
 
-        # Fetches full quote depth and analytics.
+        ##
+        # Fetches full market depth data including OHLC, Open Interest, Volume, and order book depth.
+        #
+        # Retrieves comprehensive market data including market depth (buy/sell orders), OHLC data,
+        # Open Interest (for derivatives), Volume, circuit limits, and other trading analytics
+        # for specified instruments. Supports up to 1000 instruments per request.
+        #
+        # @param params [Hash{String => Array<Integer>}] Request payload mapping exchange segments
+        #   to arrays of security IDs. Exchange segments are keys (e.g., "NSE_EQ", "NSE_FNO", "BSE_EQ").
+        #   Values are arrays of security IDs (integer identifiers for each scrip).
+        #   Valid exchange segment values: "NSE_EQ", "NSE_FNO", "BSE_EQ", "BSE_FNO", etc.
+        #
+        # @return [HashWithIndifferentAccess] Response hash containing full quote market data.
+        #   Response structure:
+        #   - **:data** [Hash{String => Hash{String => Hash}}] Market data organized by exchange segment
+        #     and security ID. Each instrument's data contains:
+        #     - **:last_price** [Float] Last traded price of the instrument
+        #     - **:last_quantity** [Integer] Last traded quantity
+        #     - **:last_trade_time** [String] Timestamp of last trade in "DD/MM/YYYY HH:MM:SS" format
+        #     - **:average_price** [Float] Volume weighted average price (VWAP) of the day
+        #     - **:buy_quantity** [Integer] Total buy order quantity pending at the exchange
+        #     - **:sell_quantity** [Integer] Total sell order quantity pending at the exchange
+        #     - **:volume** [Integer] Total traded volume for the day
+        #     - **:oi** [Integer] Open Interest in the contract (for derivatives)
+        #     - **:oi_day_high** [Integer] Highest Open Interest for the day (only for NSE_FNO)
+        #     - **:oi_day_low** [Integer] Lowest Open Interest for the day (only for NSE_FNO)
+        #     - **:net_change** [Float] Absolute change in LTP from previous day closing price
+        #     - **:upper_circuit_limit** [Float] Current upper circuit limit
+        #     - **:lower_circuit_limit** [Float] Current lower circuit limit
+        #     - **:ohlc** [Hash{Symbol => Float}] OHLC data:
+        #       - **:open** [Float] Market opening price of the day
+        #       - **:close** [Float] Market closing price of the day
+        #       - **:high** [Float] Day high price
+        #       - **:low** [Float] Day low price
+        #     - **:depth** [Hash{Symbol => Array<Hash>}] Market depth (order book) data:
+        #       - **:buy** [Array<Hash{Symbol => Integer, Float}>] Buy side depth levels (up to 5 levels):
+        #         - **:quantity** [Integer] Number of quantity at this price depth
+        #         - **:orders** [Integer] Number of open BUY orders at this price depth
+        #         - **:price** [Float] Price at which the BUY depth stands
+        #       - **:sell** [Array<Hash{Symbol => Integer, Float}>] Sell side depth levels (up to 5 levels):
+        #         - **:quantity** [Integer] Number of quantity at this price depth
+        #         - **:orders** [Integer] Number of open SELL orders at this price depth
+        #         - **:price** [Float] Price at which the SELL depth stands
+        #   - **:status** [String] Response status (typically "success")
+        #
+        # @note This endpoint uses a separate quote API with stricter rate limits (1 request per second).
+        #   The client automatically handles rate limiting for quote requests.
+        #
+        # @example Fetch full quote for futures contract
+        #   payload = {
+        #     "NSE_FNO" => [49081]
+        #   }
+        #   response = DhanHQ::Models::MarketFeed.quote(payload)
+        #   quote = response[:data]["NSE_FNO"]["49081"]
+        #   puts "LTP: ₹#{quote[:last_price]}"
+        #   puts "Volume: #{quote[:volume]}"
+        #   puts "Open Interest: #{quote[:oi]}"
+        #   puts "Day High OI: #{quote[:oi_day_high]}"
+        #
+        # @example Access market depth (order book)
+        #   response = DhanHQ::Models::MarketFeed.quote("NSE_FNO" => [49081])
+        #   quote = response[:data]["NSE_FNO"]["49081"]
+        #   buy_depth = quote[:depth][:buy]
+        #   puts "Best Buy Price: ₹#{buy_depth[0][:price]}"
+        #   puts "Best Buy Quantity: #{buy_depth[0][:quantity]}"
         #
-        # @param params [Hash]
-        # @return [Hash]
         def quote(params)
           resource.quote(params)
         end
-
-        # Shared market feed resource instance.
-        #
-        # @return [DhanHQ::Resources::MarketFeed]
-        def resource
-          @resource ||= DhanHQ::Resources::MarketFeed.new
-        end
       end
     end
   end