DhanHQ 2.1.5 → 2.1.6

data/examples/comprehensive_websocket_examples.rb

@@ -0,0 +1,148 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Comprehensive WebSocket Examples
+# This script demonstrates all three DhanHQ WebSocket types:
+# 1. Market Feed WebSocket - Real-time market data
+# 2. Order Update WebSocket - Real-time order updates
+# 3. Market Depth WebSocket - Real-time market depth
+# NOTE: Uses sequential connections to avoid rate limiting
+
+require "dhan_hq"
+
+# Configure DhanHQ
+DhanHQ.configure do |config|
+  config.client_id = ENV["CLIENT_ID"] || "your_client_id"
+  config.access_token = ENV["ACCESS_TOKEN"] || "your_access_token"
+  config.ws_user_type = ENV["DHAN_WS_USER_TYPE"] || "SELF"
+end
+
+puts "DhanHQ Comprehensive WebSocket Examples"
+puts "======================================="
+puts "Demonstrates all three WebSocket types:"
+puts "1. Market Feed - Real-time market data for indices"
+puts "2. Order Update - Real-time order status updates"
+puts "3. Market Depth - Real-time bid/ask levels"
+puts ""
+puts "NOTE: Uses sequential connections to avoid rate limiting (429 errors)"
+puts "Dhan allows up to 5 WebSocket connections per user"
+puts ""
+
+# Example 1: Market Feed WebSocket
+puts "1. Market Feed WebSocket Example"
+puts "================================"
+
+puts "Creating Market Feed WebSocket connection..."
+market_client = DhanHQ::WS.connect(mode: :ticker) do |tick|
+  timestamp = tick[:ts] ? Time.at(tick[:ts]) : Time.now
+  puts "Market Data: #{tick[:segment]}:#{tick[:security_id]} = #{tick[:ltp]} at #{timestamp}"
+end
+
+# Subscribe to major Indian indices
+puts "\nSubscribing to major Indian indices:"
+puts "- Security ID 13: NIFTY (Nifty 50)"
+puts "- Security ID 25: BANKNIFTY (Nifty Bank)"
+puts "- Security ID 29: NIFTYIT (Nifty IT)"
+puts "- Security ID 51: SENSEX (Sensex)"
+
+market_client.subscribe_one(segment: "IDX_I", security_id: "13")  # NIFTY
+market_client.subscribe_one(segment: "IDX_I", security_id: "25")  # BANKNIFTY
+market_client.subscribe_one(segment: "IDX_I", security_id: "29")  # NIFTYIT
+market_client.subscribe_one(segment: "IDX_I", security_id: "51")  # SENSEX
+
+puts "\nMarket Feed WebSocket connected successfully!"
+puts "Waiting 10 seconds to receive market data..."
+sleep(10)
+
+puts "Stopping Market Feed WebSocket to prevent rate limiting..."
+market_client.stop
+sleep(2)
+
+# Example 2: Order Update WebSocket
+puts "\n2. Order Update WebSocket Example"
+puts "=================================="
+
+puts "Creating Order Update WebSocket connection..."
+orders_client = DhanHQ::WS::Orders.connect do |order_update|
+  puts "Order Update: #{order_update.order_no} - #{order_update.status}"
+  puts "  Symbol: #{order_update.symbol}"
+  puts "  Quantity: #{order_update.quantity}"
+  puts "  Traded Qty: #{order_update.traded_qty}"
+  puts "  Price: #{order_update.price}"
+  puts "  Execution: #{order_update.execution_percentage}%"
+  puts "  ---"
+end
+
+# Add event handlers
+orders_client.on(:update) { |order| puts "📝 Order Updated: #{order.order_no}" }
+orders_client.on(:execution) { |exec| puts "✅ Execution: #{exec[:new_traded_qty]} shares" }
+orders_client.on(:order_rejected) { |order| puts "❌ Order Rejected: #{order.order_no}" }
+
+puts "\nOrder Update WebSocket connected successfully!"
+puts "Waiting 10 seconds to receive order updates..."
+sleep(10)
+
+puts "Stopping Order Update WebSocket to prevent rate limiting..."
+orders_client.stop
+sleep(2)
+
+# Example 3: Market Depth WebSocket
+puts "\n3. Market Depth WebSocket Example"
+puts "=================================="
+
+puts "Creating Market Depth WebSocket connection..."
+
+# Find instruments using the new .find method (now uses underlying_symbol for equity)
+reliance_instrument = DhanHQ::Models::Instrument.find("NSE_EQ", "RELIANCE")
+tcs_instrument = DhanHQ::Models::Instrument.find("NSE_EQ", "TCS")
+
+# Define symbols with correct exchange segments and security IDs
+symbols = []
+if reliance_instrument
+  symbols << { symbol: "RELIANCE", exchange_segment: reliance_instrument.exchange_segment,
+               security_id: reliance_instrument.security_id }
+  puts "✅ Found RELIANCE: #{reliance_instrument.symbol_name} (#{reliance_instrument.exchange_segment}:#{reliance_instrument.security_id})"
+end
+
+if tcs_instrument
+  symbols << { symbol: "TCS", exchange_segment: tcs_instrument.exchange_segment,
+               security_id: tcs_instrument.security_id }
+  puts "✅ Found TCS: #{tcs_instrument.symbol_name} (#{tcs_instrument.exchange_segment}:#{tcs_instrument.security_id})"
+end
+
+depth_client = DhanHQ::WS::MarketDepth.connect(symbols: symbols) do |depth_data|
+  puts "Market Depth: #{depth_data[:symbol]}"
+  puts "  Best Bid: #{depth_data[:best_bid]}"
+  puts "  Best Ask: #{depth_data[:best_ask]}"
+  puts "  Spread: #{depth_data[:spread]}"
+  puts "  Bid Levels: #{depth_data[:bids].size}"
+  puts "  Ask Levels: #{depth_data[:asks].size}"
+  puts "  ---"
+end
+
+puts "\nMarket Depth WebSocket connected successfully!"
+puts "Waiting 10 seconds to receive market depth data..."
+sleep(10)
+
+puts "Stopping Market Depth WebSocket to prevent rate limiting..."
+depth_client.stop
+sleep(2)
+
+# Final cleanup
+puts "\n4. Final Cleanup"
+puts "================"
+
+puts "Ensuring all WebSocket connections are closed..."
+DhanHQ::WS.disconnect_all_local!
+
+puts "\nAll WebSocket connections closed."
+puts "Comprehensive example completed!"
+puts ""
+puts "Summary:"
+puts "- Successfully demonstrated all three WebSocket types:"
+puts "  * Market Feed: Real-time index data (NIFTY, BANKNIFTY, NIFTYIT, SENSEX)"
+puts "  * Order Update: Real-time order status tracking"
+puts "  * Market Depth: Real-time bid/ask levels (RELIANCE, TCS) - dynamically resolved"
+puts "- Used sequential connections to avoid rate limiting (429 errors)"
+puts "- Proper connection cleanup prevents resource leaks"
+puts "- No multiple connection issues!"

data/examples/instrument_finder_test.rb

@@ -0,0 +1,195 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Test script for the new DhanHQ::Models::Instrument.find method
+# This script demonstrates how to use the new .find and .find_anywhere methods
+
+require "dhan_hq"
+
+# Configure DhanHQ
+DhanHQ.configure do |config|
+  config.client_id = ENV["CLIENT_ID"] || "your_client_id"
+  config.access_token = ENV["ACCESS_TOKEN"] || "your_access_token"
+  config.ws_user_type = ENV["DHAN_WS_USER_TYPE"] || "SELF"
+end
+
+puts "DhanHQ Instrument Finder Test"
+puts "============================="
+puts "Testing the new .find and .find_anywhere methods"
+puts ""
+
+# Test 1: Find specific instruments in known segments
+puts "1. Finding instruments in specific segments:"
+puts "-" * 40
+
+# Find RELIANCE in NSE_EQ (now uses underlying_symbol for equity)
+reliance = DhanHQ::Models::Instrument.find("NSE_EQ", "RELIANCE")
+if reliance
+  puts "✅ RELIANCE:"
+  puts "   Symbol Name: #{reliance.symbol_name}"
+  puts "   Underlying Symbol: #{reliance.underlying_symbol}"
+  puts "   Security ID: #{reliance.security_id}"
+  puts "   Display Name: #{reliance.display_name}"
+  puts "   Exchange Segment: #{reliance.exchange_segment}"
+else
+  puts "❌ RELIANCE not found"
+end
+
+puts
+
+# Find TCS in NSE_EQ (now uses underlying_symbol for equity)
+tcs = DhanHQ::Models::Instrument.find("NSE_EQ", "TCS")
+if tcs
+  puts "✅ TCS:"
+  puts "   Symbol Name: #{tcs.symbol_name}"
+  puts "   Underlying Symbol: #{tcs.underlying_symbol}"
+  puts "   Security ID: #{tcs.security_id}"
+  puts "   Display Name: #{tcs.display_name}"
+  puts "   Exchange Segment: #{tcs.exchange_segment}"
+else
+  puts "❌ TCS not found"
+end
+
+puts
+
+# Find NIFTY in IDX_I
+nifty = DhanHQ::Models::Instrument.find("IDX_I", "NIFTY")
+if nifty
+  puts "✅ NIFTY:"
+  puts "   Security ID: #{nifty.security_id}"
+  puts "   Display Name: #{nifty.display_name}"
+  puts "   Exchange Segment: #{nifty.exchange_segment}"
+else
+  puts "❌ NIFTY not found"
+end
+
+puts
+
+# Find BANKNIFTY in IDX_I
+banknifty = DhanHQ::Models::Instrument.find("IDX_I", "BANKNIFTY")
+if banknifty
+  puts "✅ BANKNIFTY:"
+  puts "   Security ID: #{banknifty.security_id}"
+  puts "   Display Name: #{banknifty.display_name}"
+  puts "   Exchange Segment: #{banknifty.exchange_segment}"
+else
+  puts "❌ BANKNIFTY not found"
+end
+
+puts
+
+# Test 2: Find instruments anywhere (cross-segment search)
+puts "2. Finding instruments anywhere (cross-segment search):"
+puts "-" * 50
+
+# Find RELIANCE anywhere (now uses underlying_symbol for equity)
+reliance_anywhere = DhanHQ::Models::Instrument.find_anywhere("RELIANCE", exact_match: true)
+if reliance_anywhere
+  puts "✅ RELIANCE found anywhere:"
+  puts "   Symbol Name: #{reliance_anywhere.symbol_name}"
+  puts "   Underlying Symbol: #{reliance_anywhere.underlying_symbol}"
+  puts "   Security ID: #{reliance_anywhere.security_id}"
+  puts "   Display Name: #{reliance_anywhere.display_name}"
+  puts "   Exchange Segment: #{reliance_anywhere.exchange_segment}"
+else
+  puts "❌ RELIANCE not found anywhere"
+end
+
+puts
+
+# Find TCS anywhere (now uses underlying_symbol for equity)
+tcs_anywhere = DhanHQ::Models::Instrument.find_anywhere("TCS", exact_match: true)
+if tcs_anywhere
+  puts "✅ TCS found anywhere:"
+  puts "   Symbol Name: #{tcs_anywhere.symbol_name}"
+  puts "   Underlying Symbol: #{tcs_anywhere.underlying_symbol}"
+  puts "   Security ID: #{tcs_anywhere.security_id}"
+  puts "   Display Name: #{tcs_anywhere.display_name}"
+  puts "   Exchange Segment: #{tcs_anywhere.exchange_segment}"
+else
+  puts "❌ TCS not found anywhere"
+end
+
+puts
+
+# Find NIFTY anywhere
+nifty_anywhere = DhanHQ::Models::Instrument.find_anywhere("NIFTY", exact_match: true)
+if nifty_anywhere
+  puts "✅ NIFTY found anywhere:"
+  puts "   Security ID: #{nifty_anywhere.security_id}"
+  puts "   Display Name: #{nifty_anywhere.display_name}"
+  puts "   Exchange Segment: #{nifty_anywhere.exchange_segment}"
+else
+  puts "❌ NIFTY not found anywhere"
+end
+
+puts
+
+# Test 3: Advanced search options
+puts "3. Testing advanced search options:"
+puts "-" * 35
+
+# Test partial match
+reliance_partial = DhanHQ::Models::Instrument.find("NSE_EQ", "RELIANCE")
+if reliance_partial
+  puts "✅ RELIANCE (partial match):"
+  puts "   Symbol: #{reliance_partial.symbol_name}"
+  puts "   Security ID: #{reliance_partial.security_id}"
+else
+  puts "❌ RELIANCE (partial match) not found"
+end
+
+puts
+
+# Test case insensitive search
+reliance_case = DhanHQ::Models::Instrument.find("NSE_EQ", "reliance industries ltd", case_sensitive: false)
+if reliance_case
+  puts "✅ RELIANCE (case insensitive):"
+  puts "   Symbol: #{reliance_case.symbol_name}"
+  puts "   Security ID: #{reliance_case.security_id}"
+else
+  puts "❌ RELIANCE (case insensitive) not found"
+end
+
+puts
+
+# Test 4: Practical usage for WebSocket subscriptions
+puts "4. Practical usage for WebSocket subscriptions:"
+puts "-" * 45
+
+# Find instruments for Market Depth WebSocket
+puts "Finding instruments for Market Depth WebSocket:"
+
+market_depth_symbols = []
+symbols_to_find = [
+  { segment: "NSE_EQ", symbol: "RELIANCE", name: "RELIANCE" },
+  { segment: "NSE_EQ", symbol: "TCS", name: "TCS" }
+]
+
+symbols_to_find.each do |search|
+  instrument = DhanHQ::Models::Instrument.find(search[:segment], search[:symbol])
+  if instrument
+    market_depth_symbols << {
+      symbol: search[:name],
+      exchange_segment: instrument.exchange_segment,
+      security_id: instrument.security_id
+    }
+    puts "✅ #{search[:name]}: #{instrument.exchange_segment}:#{instrument.security_id}"
+  else
+    puts "❌ #{search[:name]}: Not found"
+  end
+end
+
+puts
+puts "Market Depth WebSocket symbols array:"
+puts market_depth_symbols.inspect
+
+puts
+puts "Test completed!"
+puts "==============="
+puts "The new .find and .find_anywhere methods make it easy to:"
+puts "- Find instruments by exchange segment and symbol"
+puts "- Search across multiple segments"
+puts "- Use exact or partial matching"
+puts "- Perform case-sensitive or case-insensitive searches"
+puts "- Dynamically resolve symbols for WebSocket subscriptions"

data/examples/live_order_updates.rb

@@ -0,0 +1,118 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Live Order Updates Example
+# Demonstrates comprehensive order state tracking via WebSocket
+
+require_relative "lib/dhan_hq"
+
+# Configure DhanHQ
+DhanHQ.configure_with_env
+
+puts "🚀 DhanHQ Live Order Updates Example"
+puts "====================================="
+
+# Create order tracking client
+client = DhanHQ::WS::Orders.client
+
+# Track order statistics
+stats = {
+  total_orders: 0,
+  status_counts: Hash.new(0),
+  executions: 0
+}
+
+# Set up comprehensive event handling
+client.on(:update) do |order|
+  stats[:total_orders] += 1
+  stats[:status_counts][order.status] += 1
+
+  puts "\n📋 Order Update: #{order.order_no}"
+  puts "   Symbol: #{order.symbol} (#{order.display_name})"
+  puts "   Status: #{order.status}"
+  puts "   Type: #{order.txn_type} #{order.order_type}"
+  puts "   Quantity: #{order.traded_qty}/#{order.quantity} (#{order.execution_percentage}%)"
+  puts "   Price: #{order.price} | Avg: #{order.avg_traded_price}"
+
+  puts "   Super Order Leg: #{order.leg_no}" if order.super_order?
+end
+
+client.on(:status_change) do |data|
+  order = data[:order_update]
+  puts "\n🔄 Status Change: #{order.order_no}"
+  puts "   #{data[:previous_status]} -> #{data[:new_status]}"
+end
+
+client.on(:execution) do |data|
+  order = data[:order_update]
+  stats[:executions] += 1
+
+  puts "\n💰 Execution: #{order.order_no}"
+  puts "   #{data[:previous_traded_qty]} -> #{data[:new_traded_qty]} shares"
+  puts "   Execution: #{data[:execution_percentage]}%"
+end
+
+client.on(:order_traded) do |order|
+  puts "\n✅ Order Fully Executed: #{order.order_no}"
+  puts "   Symbol: #{order.symbol} | Quantity: #{order.traded_qty}"
+  puts "   Average Price: #{order.avg_traded_price}"
+end
+
+client.on(:order_rejected) do |order|
+  puts "\n❌ Order Rejected: #{order.order_no}"
+  puts "   Reason: #{order.reason_description}"
+end
+
+client.on(:order_cancelled) do |order|
+  puts "\n🚫 Order Cancelled: #{order.order_no}"
+end
+
+client.on(:raw) do |msg|
+  # Uncomment for debugging raw messages
+  # puts "Raw: #{msg}"
+end
+
+# Start monitoring
+puts "\n🔌 Connecting to order updates WebSocket..."
+client.start
+
+puts "✅ Connected! Monitoring order updates..."
+puts "Press Ctrl+C to stop\n"
+
+# Print periodic summaries
+summary_timer = Thread.new do
+  loop do
+    sleep 30
+
+    puts "\n📊 Order Summary (Last 30 seconds):"
+    puts "   Total Updates: #{stats[:total_orders]}"
+    puts "   Executions: #{stats[:executions]}"
+    puts "   Status Distribution:"
+    stats[:status_counts].each do |status, count|
+      puts "     #{status}: #{count}"
+    end
+
+    # Show current order states
+    all_orders = client.all_orders
+    if all_orders.any?
+      puts "   Current Orders:"
+      all_orders.each do |order_no, order|
+        puts "     #{order_no}: #{order.symbol} - #{order.status} (#{order.execution_percentage}%)"
+      end
+    end
+
+    puts "\n" + ("=" * 50)
+  end
+end
+
+# Keep running until interrupted
+begin
+  loop do
+    sleep 1
+  end
+rescue Interrupt
+  puts "\n\n🛑 Shutting down..."
+  client.stop
+  summary_timer.kill
+  puts "✅ Disconnected. Goodbye!"
+end

data/examples/market_depth_example.rb

@@ -0,0 +1,144 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Market Depth WebSocket Example
+# This script demonstrates how to use the DhanHQ Market Depth WebSocket
+# Receives real-time market depth data (bid/ask levels) for specific symbols
+# NOTE: Uses a SINGLE connection to avoid rate limiting
+
+require "dhan_hq"
+
+# Configure DhanHQ
+DhanHQ.configure do |config|
+  config.client_id = ENV["CLIENT_ID"] || "your_client_id"
+  config.access_token = ENV["ACCESS_TOKEN"] || "your_access_token"
+  config.ws_user_type = ENV["DHAN_WS_USER_TYPE"] || "SELF"
+end
+
+puts "DhanHQ Market Depth WebSocket Example"
+puts "===================================="
+puts "Receives real-time market depth data including:"
+puts "- Bid/Ask levels"
+puts "- Order book information"
+puts "- Market depth snapshots"
+puts "- Depth updates"
+puts ""
+puts "Subscribing to popular stocks:"
+puts "- RELIANCE (Reliance Industries) - NSE_EQ:2885"
+puts "- TCS (Tata Consultancy Services) - NSE_EQ:11536"
+puts ""
+puts "NOTE: Using SINGLE connection to avoid rate limiting (429 errors)"
+puts "Dhan allows up to 5 WebSocket connections per user"
+puts ""
+
+# Market Depth WebSocket Connection
+puts "Market Depth WebSocket Connection"
+puts "================================="
+
+# Create a single market depth WebSocket connection
+puts "Creating Market Depth WebSocket connection..."
+
+# Find instruments using the new .find method (now uses underlying_symbol for equity)
+reliance_instrument = DhanHQ::Models::Instrument.find("NSE_EQ", "RELIANCE")
+tcs_instrument = DhanHQ::Models::Instrument.find("NSE_EQ", "TCS")
+
+# Define symbols with correct exchange segments and security IDs
+symbols = []
+if reliance_instrument
+  symbols << { symbol: "RELIANCE", exchange_segment: reliance_instrument.exchange_segment,
+               security_id: reliance_instrument.security_id }
+  puts "✅ Found RELIANCE: #{reliance_instrument.symbol_name} (#{reliance_instrument.exchange_segment}:#{reliance_instrument.security_id})"
+else
+  puts "❌ Could not find RELIANCE INDUSTRIES LTD"
+end
+
+if tcs_instrument
+  symbols << { symbol: "TCS", exchange_segment: tcs_instrument.exchange_segment,
+               security_id: tcs_instrument.security_id }
+  puts "✅ Found TCS: #{tcs_instrument.symbol_name} (#{tcs_instrument.exchange_segment}:#{tcs_instrument.security_id})"
+else
+  puts "❌ Could not find TATA CONSULTANCY SERV LT"
+end
+
+if symbols.empty?
+  puts "❌ No symbols found. Exiting..."
+  exit(1)
+end
+
+depth_client = DhanHQ::WS::MarketDepth.connect(symbols: symbols) do |depth_data|
+  puts "Market Depth: #{depth_data[:symbol]}"
+  puts "  Best Bid: #{depth_data[:best_bid]}"
+  puts "  Best Ask: #{depth_data[:best_ask]}"
+  puts "  Spread: #{depth_data[:spread]}"
+  puts "  Bid Levels: #{depth_data[:bids].size}"
+  puts "  Ask Levels: #{depth_data[:asks].size}"
+
+  # Show top 3 bid/ask levels if available
+  if depth_data[:bids] && depth_data[:bids].size > 0
+    puts "  Top Bids:"
+    depth_data[:bids].first(3).each_with_index do |bid, i|
+      puts "    #{i + 1}. Price: #{bid[:price]}, Qty: #{bid[:quantity]}"
+    end
+  end
+
+  if depth_data[:asks] && depth_data[:asks].size > 0
+    puts "  Top Asks:"
+    depth_data[:asks].first(3).each_with_index do |ask, i|
+      puts "    #{i + 1}. Price: #{ask[:price]}, Qty: #{ask[:quantity]}"
+    end
+  end
+
+  puts "  ---"
+end
+
+# Add event handlers for different depth events
+puts "\nSetting up event handlers..."
+
+depth_client.on(:depth_update) do |update_data|
+  puts "📊 Depth Update: #{update_data[:symbol]} - #{update_data[:side]} side updated"
+end
+
+depth_client.on(:depth_snapshot) do |snapshot_data|
+  puts "📸 Depth Snapshot: #{snapshot_data[:symbol]} - Full order book received"
+end
+
+depth_client.on(:error) do |error|
+  puts "⚠️  WebSocket Error: #{error}"
+end
+
+depth_client.on(:close) do |close_info|
+  if close_info.is_a?(Hash)
+    puts "🔌 WebSocket Closed: #{close_info[:code]} - #{close_info[:reason]}"
+  else
+    puts "🔌 WebSocket Closed: #{close_info}"
+  end
+end
+
+puts "\nMarket Depth WebSocket connected successfully!"
+puts "Waiting 30 seconds to receive market depth data..."
+puts "Press Ctrl+C to stop early"
+puts ""
+
+# Wait for market depth data
+begin
+  sleep(30)
+rescue Interrupt
+  puts "\nStopping early due to user interrupt..."
+end
+
+# Graceful shutdown
+puts "\nShutting down Market Depth WebSocket connection..."
+depth_client.stop
+
+puts "Market Depth WebSocket connection closed."
+puts "Example completed!"
+puts ""
+puts "Summary:"
+puts "- Successfully demonstrated Market Depth WebSocket"
+puts "- Real-time bid/ask level tracking:"
+puts "  * RELIANCE (Reliance Industries) - dynamically resolved using .find method"
+puts "  * TCS (Tata Consultancy Services) - dynamically resolved using .find method"
+puts "- Order book depth visualization"
+puts "- Used single connection to avoid rate limiting (429 errors)"
+puts "- Proper connection cleanup prevents resource leaks"
+puts "- Dynamic symbol resolution using DhanHQ::Models::Instrument.find"

data/examples/market_feed_example.rb

@@ -0,0 +1,81 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Market Feed WebSocket Example
+# This script demonstrates how to use the DhanHQ Market Feed WebSocket
+# Subscribes to major Indian indices (NIFTY, BANKNIFTY, NIFTYIT, SENSEX)
+# NOTE: Uses a SINGLE connection to avoid rate limiting
+
+require "dhan_hq"
+
+# Configure DhanHQ
+DhanHQ.configure do |config|
+  config.client_id = ENV["CLIENT_ID"] || "your_client_id"
+  config.access_token = ENV["ACCESS_TOKEN"] || "your_access_token"
+  config.ws_user_type = ENV["DHAN_WS_USER_TYPE"] || "SELF"
+end
+
+puts "DhanHQ Market Feed WebSocket Example"
+puts "===================================="
+puts "Subscribing to major Indian indices:"
+puts "- NIFTY (Nifty 50)"
+puts "- BANKNIFTY (Nifty Bank)"
+puts "- NIFTYIT (Nifty IT)"
+puts "- SENSEX (Sensex)"
+puts ""
+puts "NOTE: Using SINGLE connection to avoid rate limiting (429 errors)"
+puts "Dhan allows up to 5 WebSocket connections per user"
+puts ""
+
+# Market Feed WebSocket Connection
+puts "Market Feed WebSocket Connection"
+puts "================================"
+
+# Create a single market feed WebSocket connection
+puts "Creating Market Feed WebSocket connection..."
+market_client = DhanHQ::WS.connect(mode: :ticker) do |tick|
+  timestamp = tick[:ts] ? Time.at(tick[:ts]) : Time.now
+  puts "Market Data: #{tick[:segment]}:#{tick[:security_id]} = #{tick[:ltp]} at #{timestamp}"
+end
+
+# Subscribe to specific IDX_I instruments only
+# Note: IDX_I is the correct segment for index instruments
+puts "\nSubscribing to IDX_I instruments:"
+puts "- Security ID 13: NIFTY (Nifty 50)"
+puts "- Security ID 25: BANKNIFTY (Nifty Bank)"
+puts "- Security ID 29: NIFTYIT (Nifty IT)"
+puts "- Security ID 51: SENSEX (Sensex)"
+
+market_client.subscribe_one(segment: "IDX_I", security_id: "13")  # NIFTY (Nifty 50)
+market_client.subscribe_one(segment: "IDX_I", security_id: "25")  # BANKNIFTY (Nifty Bank)
+market_client.subscribe_one(segment: "IDX_I", security_id: "29")  # NIFTYIT (Nifty IT)
+market_client.subscribe_one(segment: "IDX_I", security_id: "51")  # SENSEX (Sensex)
+
+puts "\nMarket Feed WebSocket connected successfully!"
+puts "Waiting 15 seconds to receive market data..."
+puts "Press Ctrl+C to stop early"
+puts ""
+
+# Wait for market data
+begin
+  sleep(15)
+rescue Interrupt
+  puts "\nStopping early due to user interrupt..."
+end
+
+# Graceful shutdown
+puts "\nShutting down WebSocket connection..."
+market_client.stop
+
+puts "WebSocket connection closed."
+puts "Example completed!"
+puts ""
+puts "Summary:"
+puts "- Successfully demonstrated IDX_I subscriptions:"
+puts "  * Security ID 13: NIFTY (Nifty 50)"
+puts "  * Security ID 25: BANKNIFTY (Nifty Bank)"
+puts "  * Security ID 29: NIFTYIT (Nifty IT)"
+puts "  * Security ID 51: SENSEX (Sensex)"
+puts "- Used single connection to avoid rate limiting (429 errors)"
+puts "- Proper connection cleanup prevents resource leaks"
+puts "- No multiple connection issues!"