DhanHQ 2.5.0 → 2.6.1

data/examples/live_order_updates.rb

@@ -1,118 +0,0 @@
-#!/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

@@ -1,144 +0,0 @@
-#!/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["DHAN_CLIENT_ID"] || "your_client_id"
-  config.access_token = ENV["DHAN_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]&.size&.positive?
-    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]&.size&.positive?
-    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

@@ -1,81 +0,0 @@
-#!/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["DHAN_CLIENT_ID"] || "your_client_id"
-  config.access_token = ENV["DHAN_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!"

data/examples/order_update_example.rb

@@ -1,105 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Order Update WebSocket Example
-# This script demonstrates how to use the DhanHQ Order Update WebSocket
-# Receives real-time order status updates and execution notifications
-# NOTE: Uses a SINGLE connection to avoid rate limiting
-
-require "dhan_hq"
-
-# Configure DhanHQ
-DhanHQ.configure do |config|
-  config.client_id = ENV["DHAN_CLIENT_ID"] || "your_client_id"
-  config.access_token = ENV["DHAN_ACCESS_TOKEN"] || "your_access_token"
-  config.ws_user_type = ENV["DHAN_WS_USER_TYPE"] || "SELF"
-end
-
-puts "DhanHQ Order Update WebSocket Example"
-puts "====================================="
-puts "Receives real-time order updates including:"
-puts "- Order status changes"
-puts "- Execution notifications"
-puts "- Order rejections"
-puts "- Trade confirmations"
-puts ""
-puts "NOTE: Using SINGLE connection to avoid rate limiting (429 errors)"
-puts "Dhan allows up to 5 WebSocket connections per user"
-puts ""
-
-# Order Update WebSocket Connection
-puts "Order Update WebSocket Connection"
-puts "================================="
-
-# Create a single order update WebSocket connection
-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 for different order events
-puts "\nSetting up event handlers..."
-
-orders_client.on(:update) do |order_update|
-  puts "📝 Order Updated: #{order_update.order_no} - #{order_update.status}"
-end
-
-orders_client.on(:status_change) do |change_data|
-  puts "🔄 Status Changed: #{change_data[:previous_status]} -> #{change_data[:new_status]}"
-end
-
-orders_client.on(:execution) do |execution_data|
-  puts "✅ Execution: #{execution_data[:new_traded_qty]} shares executed"
-end
-
-orders_client.on(:order_traded) do |order_update|
-  puts "💰 Order Traded: #{order_update.order_no} - #{order_update.symbol}"
-end
-
-orders_client.on(:order_rejected) do |order_update|
-  puts "❌ Order Rejected: #{order_update.order_no} - #{order_update.reason_description}"
-end
-
-orders_client.on(:error) do |error|
-  puts "⚠️  WebSocket Error: #{error}"
-end
-
-orders_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 "\nOrder Update WebSocket connected successfully!"
-puts "Waiting 30 seconds to receive order updates..."
-puts "Press Ctrl+C to stop early"
-puts ""
-
-# Wait for order updates
-begin
-  sleep(30)
-rescue Interrupt
-  puts "\nStopping early due to user interrupt..."
-end
-
-# Graceful shutdown
-puts "\nShutting down Order Update WebSocket connection..."
-orders_client.stop
-
-puts "Order Update WebSocket connection closed."
-puts "Example completed!"
-puts ""
-puts "Summary:"
-puts "- Successfully demonstrated Order Update WebSocket"
-puts "- Real-time order status tracking"
-puts "- Multiple event handlers for different order events"
-puts "- Used single connection to avoid rate limiting (429 errors)"
-puts "- Proper connection cleanup prevents resource leaks"

data/examples/trading_fields_example.rb

@@ -1,215 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# DhanHQ Trading Fields Example
-# This script demonstrates how to use the new trading fields in the Instrument model
-# for practical trading operations and risk management
-
-require "dhan_hq"
-
-# Configure DhanHQ
-DhanHQ.configure do |config|
-  config.client_id = ENV["DHAN_CLIENT_ID"] || "your_client_id"
-  config.access_token = ENV["DHAN_ACCESS_TOKEN"] || "your_access_token"
-  config.ws_user_type = ENV["DHAN_WS_USER_TYPE"] || "SELF"
-end
-
-puts "DhanHQ Trading Fields Example"
-puts "============================="
-puts "Demonstrating essential trading fields for risk management and order validation"
-puts ""
-
-# Helper method to display trading information
-def display_trading_info(instrument, name)
-  return unless instrument
-
-  puts "✅ #{name} Trading Information:"
-  puts "   Symbol: #{instrument.symbol_name}"
-  puts "   Underlying Symbol: #{instrument.underlying_symbol}" if instrument.underlying_symbol
-  puts "   Security ID: #{instrument.security_id}"
-  puts "   ISIN: #{instrument.isin}"
-  puts "   Instrument Type: #{instrument.instrument_type}"
-  puts "   Exchange Segment: #{instrument.exchange_segment}"
-  puts "   Lot Size: #{instrument.lot_size}"
-  puts "   Tick Size: #{instrument.tick_size}"
-  puts "   Expiry Flag: #{instrument.expiry_flag}"
-  puts "   Bracket Flag: #{instrument.bracket_flag}"
-  puts "   Cover Flag: #{instrument.cover_flag}"
-  puts "   ASM/GSM Flag: #{instrument.asm_gsm_flag}"
-  puts "   ASM/GSM Category: #{instrument.asm_gsm_category}" if instrument.asm_gsm_category != "NA"
-  puts "   Buy/Sell Indicator: #{instrument.buy_sell_indicator}"
-  puts "   Buy CO Min Margin %: #{instrument.buy_co_min_margin_per}"
-  puts "   Sell CO Min Margin %: #{instrument.sell_co_min_margin_per}"
-  puts "   MTF Leverage: #{instrument.mtf_leverage}"
-  puts ""
-end
-
-# Helper method to check trading eligibility
-def check_trading_eligibility(instrument, name)
-  return unless instrument
-
-  puts "🔍 #{name} Trading Eligibility Check:"
-
-  # Check if instrument allows trading
-  if instrument.buy_sell_indicator == "A"
-    puts "   ✅ Trading Allowed"
-  else
-    puts "   ❌ Trading Not Allowed"
-    return
-  end
-
-  # Check bracket orders
-  if instrument.bracket_flag == "Y"
-    puts "   ✅ Bracket Orders Allowed"
-  else
-    puts "   ❌ Bracket Orders Not Allowed"
-  end
-
-  # Check cover orders
-  if instrument.cover_flag == "Y"
-    puts "   ✅ Cover Orders Allowed"
-  else
-    puts "   ❌ Cover Orders Not Allowed"
-  end
-
-  # Check ASM/GSM status
-  if instrument.asm_gsm_flag == "Y"
-    puts "   ⚠️  ASM/GSM Applied: #{instrument.asm_gsm_category}"
-  else
-    puts "   ✅ No ASM/GSM Restrictions"
-  end
-
-  # Check expiry
-  if instrument.expiry_flag == "Y"
-    puts "   ⚠️  Instrument Has Expiry: #{instrument.expiry_date}"
-  else
-    puts "   ✅ No Expiry (Perpetual)"
-  end
-
-  puts ""
-end
-
-# Helper method to calculate margin requirements
-def calculate_margin_requirements(instrument, name, quantity, price)
-  return unless instrument
-
-  puts "💰 #{name} Margin Calculation:"
-  puts "   Quantity: #{quantity}"
-  puts "   Price: ₹#{price}"
-  puts "   Lot Size: #{instrument.lot_size}"
-
-  total_value = quantity * price * instrument.lot_size
-  puts "   Total Value: ₹#{total_value}"
-
-  # Calculate margin requirements
-  buy_margin = total_value * (instrument.buy_co_min_margin_per / 100.0)
-  sell_margin = total_value * (instrument.sell_co_min_margin_per / 100.0)
-
-  puts "   Buy CO Margin Required: ₹#{buy_margin}"
-  puts "   Sell CO Margin Required: ₹#{sell_margin}"
-
-  # Calculate MTF leverage
-  if instrument.mtf_leverage.positive?
-    mtf_value = total_value * instrument.mtf_leverage
-    puts "   MTF Leverage: #{instrument.mtf_leverage}x"
-    puts "   MTF Value: ₹#{mtf_value}"
-  end
-
-  puts ""
-end
-
-puts "1. Finding Instruments with Trading Fields"
-puts "=" * 50
-
-# Find popular trading instruments
-reliance = DhanHQ::Models::Instrument.find("NSE_EQ", "RELIANCE")
-tcs = DhanHQ::Models::Instrument.find("NSE_EQ", "TCS")
-hdfc = DhanHQ::Models::Instrument.find("NSE_EQ", "HDFC")
-nifty = DhanHQ::Models::Instrument.find("IDX_I", "NIFTY")
-banknifty = DhanHQ::Models::Instrument.find("IDX_I", "BANKNIFTY")
-
-# Display trading information
-display_trading_info(reliance, "RELIANCE")
-display_trading_info(tcs, "TCS")
-display_trading_info(hdfc, "HDFC")
-display_trading_info(nifty, "NIFTY")
-display_trading_info(banknifty, "BANKNIFTY")
-
-puts "2. Trading Eligibility Checks"
-puts "=" * 40
-
-# Check trading eligibility
-check_trading_eligibility(reliance, "RELIANCE")
-check_trading_eligibility(tcs, "TCS")
-check_trading_eligibility(nifty, "NIFTY")
-
-puts "3. Margin Calculations"
-puts "=" * 25
-
-# Calculate margin requirements for different scenarios
-calculate_margin_requirements(reliance, "RELIANCE", 10, 2500)
-calculate_margin_requirements(tcs, "TCS", 5, 3500)
-calculate_margin_requirements(nifty, "NIFTY", 1, 20_000)
-
-puts "4. Practical Trading Scenarios"
-puts "=" * 35
-
-# Scenario 1: Check if instrument supports bracket orders
-puts "Scenario 1: Bracket Order Support"
-puts "-" * 30
-instruments = [reliance, tcs, hdfc, nifty, banknifty]
-instruments.each do |instrument|
-  next unless instrument
-
-  puts "#{instrument.underlying_symbol || instrument.symbol_name}: #{instrument.bracket_flag == "Y" ? "✅ Supports" : "❌ No Support"}"
-end
-puts ""
-
-# Scenario 2: Find instruments with ASM/GSM restrictions
-puts "Scenario 2: ASM/GSM Restricted Instruments"
-puts "-" * 40
-asm_instruments = instruments.select { |i| i&.asm_gsm_flag == "Y" }
-if asm_instruments.any?
-  asm_instruments.each do |instrument|
-    puts "#{instrument.underlying_symbol || instrument.symbol_name}: #{instrument.asm_gsm_category}"
-  end
-else
-  puts "No ASM/GSM restricted instruments found in sample"
-end
-puts ""
-
-# Scenario 3: Find instruments with high MTF leverage
-puts "Scenario 3: High MTF Leverage Instruments"
-puts "-" * 40
-high_leverage = instruments.select { |i| i&.mtf_leverage && i.mtf_leverage > 3.0 }
-if high_leverage.any?
-  high_leverage.each do |instrument|
-    puts "#{instrument.underlying_symbol || instrument.symbol_name}: #{instrument.mtf_leverage}x leverage"
-  end
-else
-  puts "No high leverage instruments found in sample"
-end
-puts ""
-
-puts "5. Trading Field Summary"
-puts "=" * 25
-puts "Essential trading fields now available:"
-puts "✅ ISIN - International Securities Identification Number"
-puts "✅ Instrument Type - Classification (ES, INDEX, etc.)"
-puts "✅ Expiry Flag - Whether instrument has expiry"
-puts "✅ Bracket Flag - Bracket order support"
-puts "✅ Cover Flag - Cover order support"
-puts "✅ ASM/GSM Flag - Additional Surveillance Measure status"
-puts "✅ Buy/Sell Indicator - Trading permission"
-puts "✅ Margin Requirements - CO minimum margin percentages"
-puts "✅ MTF Leverage - Margin Trading Facility leverage"
-puts ""
-
-puts "Example completed!"
-puts "=================="
-puts "These trading fields enable:"
-puts "- Order validation and eligibility checks"
-puts "- Margin requirement calculations"
-puts "- Risk management and compliance"
-puts "- Trading strategy implementation"
-puts "- Regulatory compliance monitoring"