DhanHQ 2.2.2 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09510cd95013213714d5ba4878e87dfa6bd5968cb90ea4e0a539ddb0d05bc2b0'
-  data.tar.gz: 459c316d0f2c68ad8b0556518dfd70762e460e5c68ef063439e73f68ca33ba02
+  metadata.gz: 26a3e58a35f27dcc1902c2ec1c6849f0e03f80b5123c6ac310588c8e7a0d3a58
+  data.tar.gz: 516cc99f9e3a61f8ec261788babc4309f1b6acc97b1c0ef98f5dbe22b1499217
 SHA512:
-  metadata.gz: d54cf0cc58e82d1566f525303ea25fddd051b1c838152da39f12509435a16e4005f55417d5516c52f6222b4ba6286c421202d0a148f743be7ca4127b7ef03bae
-  data.tar.gz: ea522dfeb54054d8162d00ead357efb4c444c3dd0c4c182c4d688a2bd9a484d44af7b2bab221476c93fded44511bfff7e8cf4b75d6e962fc8191486bee5440b1
+  metadata.gz: ce920dd5a3804a4b7ddc41867f742ea187fe38255c1468c4a0f1528641dc144752571591de74812241b2d985c40381604a235032250eb4580d6e3b4ad2ffc0bc
+  data.tar.gz: 418f01c9b4bebc8bda9e8d20567dc6d157b60fad7e00eda2522106fd9abfdea607142179e50f2c79c7cfa45a246941be252263354737a8279cb8ab7152d0b9b3

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## [Unreleased]
 
+---
+
+## [2.3.0] - 2026-02-04
+
+### Added
+- **Alert Orders**: `DhanHQ::Resources::AlertOrders` (BaseResource) and `DhanHQ::Models::AlertOrder` with full CRUD. Endpoints: GET/POST `/alerts/orders`, GET/PUT/DELETE `/alerts/orders/{id}` (per API docs). Validation via `DhanHQ::Contracts::AlertOrderContract`.
+- **IP Setup**: `DhanHQ::Resources::IPSetup` (resource-only). Methods: `current` (GET `/ip/getIP`), `set(ip:)` (POST `/ip/setIP`), `update(ip:)` (PUT `/ip/modifyIP`) per API docs.
+- **Trader Control (Kill Switch)**: `DhanHQ::Resources::TraderControl` (resource-only). Methods: `status` (GET `/trader-control`), `enable` (POST action ENABLE), `disable` (POST action DISABLE). `DhanHQ::Resources::KillSwitch` and `DhanHQ::Models::KillSwitch` remain for backward compatibility.
+- **docs/API_VERIFICATION.md**: Documents alignment with [dhanhq.co/docs/v2](https://dhanhq.co/docs/v2/) and [api.dhan.co/v2](https://api.dhan.co/v2/#/) for EDIS, Alert Orders, IP Setup.
+
+### Changed
+- **EDIS**: Resource-only, aligned with [dhanhq.co/docs/v2/edis](https://dhanhq.co/docs/v2/edis/). Use `DhanHQ::Resources::Edis`: `form(params)` (POST `/edis/form`; isin, qty, exchange, segment, bulk), `bulk_form(params)` (POST `/edis/bulkform`), `tpin` (GET `/edis/tpin`), `inquire(isin)` (GET `/edis/inquire/{isin}`).
+- **BaseResource**: Fixed path building: `all`/`find`/`create`/`update`/`delete` now pass relative endpoints (`""`, `"/#{id}"`) so the base path is not doubled.
+
+---
+
 ## [2.2.2] - 2026-01-31
 
 ### Contracts (date validation)

data/GUIDE.md

@@ -641,33 +641,75 @@ profile.active_segment   # => "Equity, Derivative, Currency, Commodity"
 
 If the credentials are invalid the helper raises `DhanHQ::InvalidAuthenticationError`.
 
-### EDIS (Electronic Delivery Instruction Slip)
+### Alert Orders
 
 ```ruby
-# Generate a CDSL form for a single ISIN
-form = DhanHQ::Models::Edis.form(
-  isin: "INE0ABCDE123",
-  qty: 1,
-  exchange: "NSE",
-  segment: "EQ",
-  bulk: false
+# Model (CRUD)
+DhanHQ::Models::AlertOrder.all
+alert = DhanHQ::Models::AlertOrder.find("alert-id")
+alert = DhanHQ::Models::AlertOrder.create(
+  exchange_segment: "NSE_EQ",
+  security_id: "11536",
+  condition: "GTE",
+  trigger_price: 100.0,
+  transaction_type: "BUY",
+  quantity: 10
 )
+alert.save
+alert.destroy
 
-# Prepare a bulk file
-bulk_form = DhanHQ::Models::Edis.bulk_form(
-  isin: %w[INE0ABCDE123 INE0XYZ89012],
-  exchange: "NSE",
-  segment: "EQ"
-)
+# Resource only
+DhanHQ::Resources::AlertOrders.new.all
+```
+
+### EDIS (Electronic Delivery Instruction Slip)
+
+EDIS is resource-only (no model). Use `DhanHQ::Resources::Edis` per [dhanhq.co/docs/v2/edis](https://dhanhq.co/docs/v2/edis/):
+
+```ruby
+edis = DhanHQ::Resources::Edis.new
+
+# Generate T-PIN (GET /edis/tpin)
+edis.tpin
+
+# Retrieve form & enter T-PIN (POST /edis/form): isin, qty, exchange, segment, bulk
+edis.form(isin: "INE733E01010", qty: 1, exchange: "NSE", segment: "EQ", bulk: false)
 
-# Manage T-PIN and status inquiries
-DhanHQ::Models::Edis.tpin                    # => {"status"=>"TPIN sent"}
-authorisations = DhanHQ::Models::Edis.inquire("ALL")
+# Bulk form (POST /edis/bulkform)
+edis.bulk_form(exchange: "NSE", segment: "EQ", bulk: true)
+
+# Inquire status (GET /edis/inquire/{isin})
+edis.inquire("INE002A01018")
+edis.inquire("ALL")
+```
+
+Params use snake_case; the client camelizes them before calling `/edis/...`.
+
+### IP Setup
+
+Resource-only (account configuration) per API docs: GET /ip/getIP, POST /ip/setIP, PUT /ip/modifyIP.
+
+```ruby
+ip = DhanHQ::Resources::IPSetup.new
+ip.current              # GET /ip/getIP
+ip.set(ip: "103.21.58.121")
+ip.update(ip: "103.21.58.121")
+```
+
+### Trader Control (Kill Switch)
+
+Resource-only control toggle:
+
+```ruby
+tc = DhanHQ::Resources::TraderControl.new
+tc.status               # GET /trader-control
+tc.disable             # Kill switch ON — trading blocked
+tc.enable              # Trading resumed
 ```
 
-All helpers accept snake_case keys; the client camelizes them before calling `/v2/edis/...`.
+### Kill Switch (model)
 
-### Kill Switch
+Existing model API for backward compatibility:
 
 ```ruby
 activate_payload   = DhanHQ::Models::KillSwitch.activate

data/README.md

@@ -4,7 +4,7 @@ A clean Ruby client for **Dhan API v2** with ORM-like models (Orders, Positions,
 
 * ActiveRecord-style models: `find`, `all`, `where`, `save`, `update`, `cancel`
 * Validations & errors exposed via ActiveModel-like interfaces
-* REST coverage: Orders, Super Orders, Forever Orders, Trades, Positions, Holdings, Funds/Margin, HistoricalData, OptionChain, MarketFeed, ExpiredOptionsData
+* REST coverage: Orders, Alert Orders, Super Orders, Forever Orders, Trades, Positions, Holdings, Funds/Margin, HistoricalData, OptionChain, MarketFeed, ExpiredOptionsData, EDIS, IP Setup, Trader Control (Kill Switch)
 * **WebSocket**: Orders, Market Feed, Market Depth - subscribe/unsubscribe dynamically, auto-reconnect with backoff, 429 cool-off, idempotent subs, header+payload binary parsing, normalized ticks
 
 ## ⚠️ BREAKING CHANGE NOTICE

data/docs/API_VERIFICATION.md

@@ -0,0 +1,67 @@
+# API Verification (Dhan v2)
+
+This document records how the gem’s implementation aligns with the official Dhan API v2 docs.
+
+**Sources:**
+
+- [dhanhq.co/docs/v2](https://dhanhq.co/docs/v2/) – main docs
+- [dhanhq.co/docs/v2/edis](https://dhanhq.co/docs/v2/edis/) – EDIS
+- [api.dhan.co/v2](https://api.dhan.co/v2/#/) – Developer Kit (when available)
+- In-repo: `CODE_REVIEW_ISSUES.md` (Alert Orders, IP Setup paths)
+
+---
+
+## EDIS
+
+**Doc:** [dhanhq.co/docs/v2/edis](https://dhanhq.co/docs/v2/edis/)
+
+| Doc endpoint              | Method | Gem method   | Path / behaviour |
+|---------------------------|--------|--------------|-------------------|
+| Generate T-PIN            | GET    | `#tpin`      | `/edis/tpin`      |
+| Retrieve form & enter T-PIN | POST | `#form(params)` | `/edis/form`; body: `isin`, `qty`, `exchange`, `segment`, `bulk` |
+| Bulk form                 | POST   | `#bulk_form(params)` | `/edis/bulkform` (aligned with TODO-1 / legacy) |
+| Inquire status            | GET    | `#inquire(isin)` | `/edis/inquire/{isin}` |
+
+**Request (form):** `isin`, `qty`, `exchange` (NSE/BSE), `segment` (EQ), `bulk` (boolean).
+
+---
+
+## Alert Orders
+
+**Doc ref:** `CODE_REVIEW_ISSUES.md` (§31) – Alert Orders endpoints.
+
+| Doc path                  | Gem resource              | Path used        |
+|---------------------------|---------------------------|------------------|
+| `/alerts/orders`          | `Resources::AlertOrders`  | `HTTP_PATH = "/alerts/orders"` |
+| GET/POST `/alerts/orders` | `#all`, `#create`         | BaseResource     |
+| GET/PUT/DELETE `/alerts/orders/{trigger-id}` | `#find`, `#update`, `#delete` | `/{id}` |
+
+Model: `Models::AlertOrder`; ID attribute `alert_id` (response field name may be `alertId` or `triggerId` depending on API; adjust if production returns `triggerId`).
+
+---
+
+## IP Setup
+
+**Doc ref:** `CODE_REVIEW_ISSUES.md` (§32) – IP Setup endpoints.
+
+| Doc path        | Gem method     | Path used     |
+|-----------------|----------------|---------------|
+| GET /ip/getIP   | `#current`     | `get("/getIP")`   |
+| POST /ip/setIP  | `#set(ip:)`    | `post("/setIP", params: { ip: ip })` |
+| PUT /ip/modifyIP| `#update(ip:)` | `put("/modifyIP", params: { ip: ip })` |
+
+---
+
+## Trader Control / Kill Switch
+
+- **Existing:** `Resources::KillSwitch`, `Models::KillSwitch` – path `/v2/killswitch`.
+- **Added:** `Resources::TraderControl` – path `/trader-control`; `#status`, `#enable`, `#disable`.  
+  Not found on the public docs pages checked; kept for compatibility with design that referenced trader-control.
+
+---
+
+## Base URL and paths
+
+- Default base URL: `https://api.dhan.co/v2`.
+- Resource `HTTP_PATH` values are relative to that base (e.g. `/edis`, `/alerts/orders`, `/ip`).
+- Order API resources use `API_TYPE = :order_api`.

data/docs/TESTING_GUIDE.md

@@ -922,65 +922,63 @@ end
 
 ### EDIS
 
-#### Get EDIS Form
+EDIS is resource-only per [dhanhq.co/docs/v2/edis](https://dhanhq.co/docs/v2/edis/). Use `DhanHQ::Resources::Edis`.
+
+#### Get TPIN (GET /edis/tpin)
 
 ```ruby
-# Get EDIS form
-edis_form = DhanHQ::Models::Edis.form
-puts "EDIS Form:"
-puts "  ISIN: #{edis_form[:isin]}"
-puts "  Quantity: #{edis_form[:quantity]}"
+edis = DhanHQ::Resources::Edis.new
+tpin_response = edis.tpin
+puts "TPIN: #{tpin_response}"
 ```
 
-#### Get Bulk EDIS Form
+#### Form (POST /edis/form)
 
 ```ruby
-# Get bulk EDIS form
-bulk_form = DhanHQ::Models::Edis.bulk_form
-puts "Bulk Form: #{bulk_form.size} entries"
+edis = DhanHQ::Resources::Edis.new
+response = edis.form(isin: "INE467B01029", qty: 10, exchange: "NSE", segment: "EQ", bulk: false)
+puts "EDIS form: #{response.is_a?(Hash) ? 'OK' : response.class}"
 ```
 
-#### Generate TPIN
+#### Bulk form (POST /edis/bulkform)
 
 ```ruby
-# Generate TPIN
-tpin = DhanHQ::Models::Edis.generate_tpin
-puts "TPIN: #{tpin[:tpin]}"
+edis = DhanHQ::Resources::Edis.new
+response = edis.bulk_form(exchange: "NSE", segment: "EQ", bulk: true)
+puts "EDIS bulk form: #{response.is_a?(Hash) ? 'OK' : response.class}"
 ```
 
-#### Inquire EDIS Status
+#### Inquire (GET /edis/inquire/{isin})
 
 ```ruby
-# Inquire EDIS status by ISIN
-isin = "INE467B01029"  # Example ISIN
-status = DhanHQ::Models::Edis.inquire(isin: isin)
-puts "EDIS Status: #{status[:status]}"
+edis = DhanHQ::Resources::Edis.new
+status = edis.inquire("INE467B01029")
+puts "EDIS status: #{status}"
+# Or pass "ALL" for all holdings
+all_status = edis.inquire("ALL")
 ```
 
 ### Kill Switch
 
-#### Activate Kill Switch
+#### Trader Control (resource-only)
 
 ```ruby
-# Activate kill switch
-result = DhanHQ::Models::KillSwitch.update(status: "ACTIVATE")
-if result
-  puts "Kill switch activated"
-else
-  puts "Failed to activate kill switch"
-end
+tc = DhanHQ::Resources::TraderControl.new
+tc.disable   # Kill switch ON
+tc.enable    # Trading resumed
+tc.status
 ```
 
-#### Deactivate Kill Switch
+#### Kill Switch (model, backward compatible)
 
 ```ruby
+# Activate kill switch
+result = DhanHQ::Models::KillSwitch.update("ACTIVATE")
+puts result[:kill_switch_status] if result.is_a?(Hash)
+
 # Deactivate kill switch
-result = DhanHQ::Models::KillSwitch.update(status: "DEACTIVATE")
-if result
-  puts "Kill switch deactivated"
-else
-  puts "Failed to deactivate kill switch"
-end
+result = DhanHQ::Models::KillSwitch.update("DEACTIVATE")
+puts result[:kill_switch_status] if result.is_a?(Hash)
 ```
 
 ### Expired Options Data

data/lib/DhanHQ/contracts/alert_order_contract.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module DhanHQ
+  module Contracts
+    # Validates alert order payloads for create/update (exchange_segment, security_id,
+    # condition, trigger_price, transaction_type, quantity; optional price, order_type).
+    class AlertOrderContract < BaseContract
+      params do
+        required(:exchange_segment).filled(:string)
+        required(:security_id).filled(:string)
+        required(:condition).filled(:string)
+        required(:trigger_price).filled(:float)
+        required(:transaction_type).filled(:string, included_in?: %w[BUY SELL])
+        required(:quantity).filled(:integer, gt?: 0)
+        optional(:price).maybe(:float)
+        optional(:order_type).maybe(:string)
+      end
+    end
+  end
+end

data/lib/DhanHQ/core/base_resource.rb

@@ -11,7 +11,7 @@ module DhanHQ
     #
     # @return [Array<Hash>, Hash]
     def all
-      get(self.class::HTTP_PATH)
+      get("")
     end
 
     # Retrieves a single resource by identifier.
@@ -19,7 +19,7 @@ module DhanHQ
     # @param id [String, Integer]
     # @return [Hash]
     def find(id)
-      get("#{self.class::HTTP_PATH}/#{id}")
+      get("/#{id}")
     end
 
     # Creates a new resource instance.
@@ -27,7 +27,7 @@ module DhanHQ
     # @param params [Hash]
     # @return [Hash]
     def create(params)
-      post(self.class::HTTP_PATH, params: params)
+      post("", params: params)
     end
 
     # Updates an existing resource.
@@ -36,7 +36,7 @@ module DhanHQ
     # @param params [Hash]
     # @return [Hash]
     def update(id, params)
-      put("#{self.class::HTTP_PATH}/#{id}", params: params)
+      put("/#{id}", params: params)
     end
 
     # Deletes a resource by identifier.
@@ -44,7 +44,7 @@ module DhanHQ
     # @param id [String, Integer]
     # @return [Hash]
     def delete(id)
-      super("#{self.class::HTTP_PATH}/#{id}")
+      super("/#{id}")
     end
   end
 end

data/lib/DhanHQ/models/alert_order.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require_relative "../contracts/alert_order_contract"
+
+module DhanHQ
+  module Models
+    # Model for alert/conditional orders. CRUD via AlertOrders resource; validated by AlertOrderContract.
+    class AlertOrder < BaseModel
+      HTTP_PATH = "/alerts/orders"
+
+      attributes :alert_id, :exchange_segment, :security_id, :condition,
+                 :trigger_price, :order_type, :transaction_type, :quantity,
+                 :price, :status, :created_at
+
+      class << self
+        def api_type
+          :order_api
+        end
+
+        def resource
+          @resource ||= DhanHQ::Resources::AlertOrders.new
+        end
+
+        def validation_contract
+          Contracts::AlertOrderContract
+        end
+
+        def all
+          response = resource.all
+          return [] unless response.is_a?(Array)
+
+          response.map { |attrs| new(attrs, skip_validation: true) }
+        end
+
+        def find(alert_id)
+          response = resource.find(alert_id)
+          return nil unless response.is_a?(Hash) || (response.is_a?(Array) && response.any?)
+
+          payload = response.is_a?(Array) ? response.first : response
+          new(payload, skip_validation: true)
+        end
+
+        def create(params)
+          normalized = snake_case(params)
+          validate_params!(normalized, DhanHQ::Contracts::AlertOrderContract)
+          response = resource.create(camelize_keys(normalized))
+          return nil unless response.is_a?(Hash) && response["alertId"]
+
+          find(response["alertId"])
+        end
+      end
+
+      def id
+        alert_id&.to_s
+      end
+
+      def save # rubocop:disable Naming/PredicateMethod
+        return false unless valid?
+
+        payload = to_request_params
+        response = if new_record?
+                     self.class.resource.create(camelize_keys(payload))
+                   else
+                     self.class.resource.update(id, camelize_keys(payload))
+                   end
+        return false if new_record? && !(response.is_a?(Hash) && response["alertId"])
+        return false if !new_record? && !success_response?(response)
+
+        @attributes.merge!(normalize_keys(response))
+        assign_attributes
+        true
+      end
+
+      def destroy # rubocop:disable Naming/PredicateMethod
+        return false if new_record?
+
+        response = self.class.resource.delete(id)
+        success_response?(response)
+      end
+      alias delete destroy
+    end
+  end
+end

data/lib/DhanHQ/resources/alert_orders.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DhanHQ
+  module Resources
+    # Resource for alert/conditional orders per API docs: /alerts/orders (GET/POST/PUT/DELETE).
+    class AlertOrders < BaseResource
+      API_TYPE  = :order_api
+      HTTP_PATH = "/alerts/orders"
+    end
+  end
+end

data/lib/DhanHQ/resources/edis.rb

@@ -2,40 +2,25 @@
 
 module DhanHQ
   module Resources
-    # Resource client for electronic DIS flows.
+    # Resource for EDIS per https://dhanhq.co/docs/v2/edis/
+    # GET /edis/tpin, POST /edis/form (body: isin, qty, exchange, segment, bulk),
+    # POST /edis/bulkform, GET /edis/inquire/{isin}.
     class Edis < BaseAPI
-      # EDIS endpoints are served from the trading API.
-      API_TYPE = :order_api
-      # Base path for EDIS endpoints.
-      HTTP_PATH = "/v2/edis"
+      API_TYPE  = :order_api
+      HTTP_PATH = "/edis"
 
-      # Creates a TPIN request form.
-      #
-      # @param params [Hash]
-      # @return [Hash]
       def form(params)
         post("/form", params: params)
       end
 
-      # Bulk EDIS form submission.
-      #
-      # @param params [Hash]
-      # @return [Hash]
       def bulk_form(params)
         post("/bulkform", params: params)
       end
 
-      # Generates a TPIN for the client.
-      #
-      # @return [Hash]
       def tpin
         get("/tpin")
       end
 
-      # Checks the EDIS status for a given ISIN.
-      #
-      # @param isin [String]
-      # @return [Hash]
       def inquire(isin)
         get("/inquire/#{isin}")
       end

data/lib/DhanHQ/resources/ip_setup.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module DhanHQ
+  module Resources
+    # Resource for IP whitelist per API docs: GET /ip/getIP, POST /ip/setIP, PUT /ip/modifyIP.
+    class IPSetup < BaseAPI
+      API_TYPE  = :order_api
+      HTTP_PATH = "/ip"
+
+      def current
+        get("/getIP")
+      end
+
+      def set(ip:)
+        post("/setIP", params: { ip: ip })
+      end
+
+      def update(ip:)
+        put("/modifyIP", params: { ip: ip })
+      end
+    end
+  end
+end

data/lib/DhanHQ/resources/trader_control.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module DhanHQ
+  module Resources
+    # Resource for trader control (kill switch): status (GET), enable/disable (POST /trader-control).
+    class TraderControl < BaseAPI
+      API_TYPE  = :order_api
+      HTTP_PATH = "/trader-control"
+
+      def status
+        get("")
+      end
+
+      def enable
+        post("", params: { action: "ENABLE" })
+      end
+
+      def disable
+        post("", params: { action: "DISABLE" })
+      end
+    end
+  end
+end

data/lib/DhanHQ/version.rb

@@ -2,5 +2,5 @@
 
 module DhanHQ
   # Semantic version of the DhanHQ client gem.
-  VERSION = "2.2.2"
+  VERSION = "2.3.0"
 end

data/lib/dhan_hq.rb

@@ -33,6 +33,7 @@ require_relative "DhanHQ/contracts/position_conversion_contract"
 require_relative "DhanHQ/contracts/slice_order_contract"
 require_relative "DhanHQ/contracts/trade_contract"
 require_relative "DhanHQ/contracts/expired_options_data_contract"
+require_relative "DhanHQ/contracts/alert_order_contract"
 
 # Resources
 require_relative "DhanHQ/resources/option_chain"
@@ -48,12 +49,16 @@ require_relative "DhanHQ/resources/historical_data"
 require_relative "DhanHQ/resources/margin_calculator"
 require_relative "DhanHQ/resources/market_feed"
 require_relative "DhanHQ/resources/instruments"
+require_relative "DhanHQ/resources/alert_orders"
 require_relative "DhanHQ/resources/edis"
+require_relative "DhanHQ/resources/ip_setup"
 require_relative "DhanHQ/resources/kill_switch"
+require_relative "DhanHQ/resources/trader_control"
 require_relative "DhanHQ/resources/profile"
 require_relative "DhanHQ/resources/expired_options_data"
 
 # Models
+require_relative "DhanHQ/models/alert_order"
 require_relative "DhanHQ/models/order"
 require_relative "DhanHQ/models/funds"
 require_relative "DhanHQ/models/option_chain"
@@ -67,7 +72,6 @@ require_relative "DhanHQ/models/holding"
 require_relative "DhanHQ/models/ledger_entry"
 require_relative "DhanHQ/models/trade"
 require_relative "DhanHQ/models/margin"
-require_relative "DhanHQ/models/edis"
 require_relative "DhanHQ/models/kill_switch"
 require_relative "DhanHQ/models/profile"
 require_relative "DhanHQ/models/order_update"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: DhanHQ
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 2.3.0
 platform: ruby
 authors:
 - Shubham Taywade
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-31 00:00:00.000000000 Z
+date: 2026-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -183,6 +183,7 @@ files:
 - core
 - diagram.html
 - diagram.md
+- docs/API_VERIFICATION.md
 - docs/AUTHENTICATION.md
 - docs/DATA_API_PARAMETERS.md
 - docs/PR_2.2.0.md
@@ -207,6 +208,7 @@ files:
 - lib/DhanHQ/config.rb
 - lib/DhanHQ/configuration.rb
 - lib/DhanHQ/constants.rb
+- lib/DhanHQ/contracts/alert_order_contract.rb
 - lib/DhanHQ/contracts/base_contract.rb
 - lib/DhanHQ/contracts/expired_options_data_contract.rb
 - lib/DhanHQ/contracts/historical_data_contract.rb
@@ -232,7 +234,7 @@ files:
 - lib/DhanHQ/helpers/response_helper.rb
 - lib/DhanHQ/helpers/validation_helper.rb
 - lib/DhanHQ/json_loader.rb
-- lib/DhanHQ/models/edis.rb
+- lib/DhanHQ/models/alert_order.rb
 - lib/DhanHQ/models/expired_options_data.rb
 - lib/DhanHQ/models/forever_order.rb
 - lib/DhanHQ/models/funds.rb
@@ -255,6 +257,7 @@ files:
 - lib/DhanHQ/requests/optionchain/nifty.json
 - lib/DhanHQ/requests/optionchain/nifty_expiries.json
 - lib/DhanHQ/requests/orders/create.json
+- lib/DhanHQ/resources/alert_orders.rb
 - lib/DhanHQ/resources/edis.rb
 - lib/DhanHQ/resources/expired_options_data.rb
 - lib/DhanHQ/resources/forever_orders.rb
@@ -262,6 +265,7 @@ files:
 - lib/DhanHQ/resources/historical_data.rb
 - lib/DhanHQ/resources/holdings.rb
 - lib/DhanHQ/resources/instruments.rb
+- lib/DhanHQ/resources/ip_setup.rb
 - lib/DhanHQ/resources/kill_switch.rb
 - lib/DhanHQ/resources/margin_calculator.rb
 - lib/DhanHQ/resources/market_feed.rb
@@ -271,6 +275,7 @@ files:
 - lib/DhanHQ/resources/profile.rb
 - lib/DhanHQ/resources/statements.rb
 - lib/DhanHQ/resources/super_orders.rb
+- lib/DhanHQ/resources/trader_control.rb
 - lib/DhanHQ/resources/trades.rb
 - lib/DhanHQ/version.rb
 - lib/DhanHQ/ws.rb

data/lib/DhanHQ/models/edis.rb

@@ -1,194 +0,0 @@
-# frozen_string_literal: true
-
-module DhanHQ
-  module Models
-    ##
-    # Model wrapper for electronic DIS (Delivery Instruction Slip) flows.
-    #
-    # To sell holding stocks, one needs to complete the CDSL eDIS flow:
-    # 1. Generate T-PIN using {tpin}
-    # 2. Retrieve escaped HTML form using {form} and enter T-PIN to mark stock for EDIS approval
-    # 3. Check status using {inquire} to verify if stock is approved and marked for sell action
-    #
-    # You can get ISIN (International Securities Identification Number) of portfolio stocks
-    # from the holdings API response.
-    #
-    # @example Generate T-PIN
-    #   response = DhanHQ::Models::Edis.tpin
-    #   # Returns 202 Accepted status
-    #
-    # @example Generate eDIS form for a single stock
-    #   response = DhanHQ::Models::Edis.form(
-    #     isin: "INE733E01010",
-    #     qty: 1,
-    #     exchange: "NSE",
-    #     segment: "EQ",
-    #     bulk: false
-    #   )
-    #   # => {
-    #   #   dhan_client_id: "1000000401",
-    #   #   edis_form_html: "<!DOCTYPE html>..."
-    #   # }
-    #
-    # @example Check EDIS status for an ISIN
-    #   status = DhanHQ::Models::Edis.inquire("INE00IN01015")
-    #   # => {
-    #   #   client_id: "1000000401",
-    #   #   isin: "INE00IN01015",
-    #   #   total_qty: "10",
-    #   #   aprvd_qty: "4",
-    #   #   status: "SUCCESS",
-    #   #   remarks: "eDIS transaction done successfully"
-    #   # }
-    #
-    class Edis < BaseModel
-      # Base path backing the model operations.
-      HTTP_PATH = "/v2/edis"
-
-      class << self
-        ##
-        # Shared resource client used by the model helpers.
-        #
-        # @return [DhanHQ::Resources::Edis] The EDIS resource client instance
-        def resource
-          @resource ||= DhanHQ::Resources::Edis.new
-        end
-
-        ##
-        # Retrieves escaped HTML form of CDSL and enters T-PIN to mark the stock for EDIS approval.
-        #
-        # User has to render this form at their end to unescape. The form contains hidden fields
-        # that will automatically submit to CDSL's eDIS verification endpoint.
-        #
-        # @param params [Hash{Symbol => String, Integer, Boolean}] The EDIS form request parameters
-        #   @option params [String] :isin (required) International Securities Identification Number
-        #     (12-digit alphanumeric code). You can get ISIN from the holdings API response.
-        #   @option params [Integer] :qty (required) Number of shares to mark for EDIS transaction
-        #   @option params [String] :exchange (required) Exchange identifier. Must be either "NSE" or "BSE"
-        #   @option params [String] :segment (required) Segment identifier. Must be "EQ"
-        #   @option params [Boolean] :bulk (optional, default: false) Set to true to mark EDIS for
-        #     all stocks in portfolio. When true, other parameters may be ignored.
-        #
-        # @return [Hash{Symbol => String}] The EDIS form response containing escaped HTML form.
-        #   Response keys are normalized to snake_case:
-        #   - **:dhan_client_id** [String] User-specific identification generated by Dhan
-        #   - **:edis_form_html** [String] Escaped HTML form that needs to be rendered and unescaped
-        #
-        # @example Generate form for a single stock
-        #   response = DhanHQ::Models::Edis.form(
-        #     isin: "INE733E01010",
-        #     qty: 1,
-        #     exchange: "NSE",
-        #     segment: "EQ",
-        #     bulk: false
-        #   )
-        #   html_form = response[:edis_form_html]
-        #   # Render and unescape the HTML form to complete EDIS approval
-        #
-        # @example Generate form for bulk EDIS
-        #   response = DhanHQ::Models::Edis.form(
-        #     isin: "",
-        #     qty: 0,
-        #     exchange: "NSE",
-        #     segment: "EQ",
-        #     bulk: true
-        #   )
-        def form(params)
-          resource.form(params)
-        end
-
-        ##
-        # Submits a bulk EDIS form request for multiple stocks.
-        #
-        # This is an alternative to using {form} with `bulk: true`. The exact parameter
-        # structure may differ from the single form request.
-        #
-        # @param params [Hash{Symbol => String, Integer, Boolean}] The bulk EDIS form request parameters
-        #   @option params [String] :isin (optional) International Securities Identification Number.
-        #     May be ignored for bulk requests
-        #   @option params [Integer] :qty (optional) Number of shares. May be ignored for bulk requests
-        #   @option params [String] :exchange (required) Exchange identifier ("NSE" or "BSE")
-        #   @option params [String] :segment (required) Segment identifier ("EQ")
-        #   @option params [Boolean] :bulk (optional, default: true) Set to true for bulk operations
-        #
-        # @return [Hash{Symbol => String}] The bulk EDIS form response containing escaped HTML form.
-        #   Response keys are normalized to snake_case:
-        #   - **:dhan_client_id** [String] User-specific identification generated by Dhan
-        #   - **:edis_form_html** [String] Escaped HTML form that needs to be rendered and unescaped
-        #
-        # @example Bulk EDIS form request
-        #   response = DhanHQ::Models::Edis.bulk_form(
-        #     exchange: "NSE",
-        #     segment: "EQ",
-        #     bulk: true
-        #   )
-        def bulk_form(params)
-          resource.bulk_form(params)
-        end
-
-        ##
-        # Generates a T-PIN (Transaction PIN) for the configured client.
-        #
-        # T-PIN is sent to the user's registered mobile number. This T-PIN is required
-        # when submitting the EDIS form to mark stocks for sell action.
-        #
-        # @return [Hash{Symbol => String}] The T-PIN generation response. The T-PIN itself is sent
-        #   to the registered mobile number and not returned in the response. Response typically
-        #   contains a status indicating successful generation (e.g., "202 Accepted").
-        #
-        # @example Generate T-PIN
-        #   response = DhanHQ::Models::Edis.tpin
-        #   # T-PIN will be sent to registered mobile number
-        #   # Check your mobile for the T-PIN before submitting the EDIS form
-        #
-        # @note This is a GET request with no body parameters required
-        def tpin
-          resource.tpin
-        end
-
-        ##
-        # Inquires the EDIS status for a specific ISIN to check if stock is approved and marked for sell action.
-        #
-        # You can check whether a stock has been approved through the EDIS process and is ready
-        # for sell action. Alternatively, you can pass "ALL" instead of an ISIN to get EDIS status
-        # of all holdings in your portfolio.
-        #
-        # @param isin [String] International Securities Identification Number (12-digit alphanumeric code).
-        #   You can get ISIN from the holdings API response. Alternatively, pass "ALL" to get status
-        #   for all holdings in your portfolio.
-        #
-        # @return [Hash{Symbol => String}] The EDIS inquiry response containing status information.
-        #   Response keys are normalized to snake_case:
-        #   - **:client_id** [String] User-specific identification
-        #   - **:isin** [String] International Securities Identification Number that was queried
-        #   - **:total_qty** [String] Total number of shares for the given stock
-        #   - **:aprvd_qty** [String] Number of approved stocks that are marked for EDIS
-        #   - **:status** [String] Status of the EDIS order (e.g., "SUCCESS", "PENDING", "FAILED")
-        #   - **:remarks** [String] Remarks about the order status (e.g., "eDIS transaction done successfully")
-        #
-        # @example Check status for a specific ISIN
-        #   status = DhanHQ::Models::Edis.inquire("INE00IN01015")
-        #   puts status[:status]       # => "SUCCESS"
-        #   puts status[:aprvd_qty]    # => "4"
-        #   puts status[:total_qty]     # => "10"
-        #
-        # @example Check status for all holdings
-        #   all_status = DhanHQ::Models::Edis.inquire("ALL")
-        #   # Returns status for all holdings in portfolio
-        #
-        # @note This is a GET request with no body parameters. The ISIN is passed in the URL path.
-        def inquire(isin)
-          resource.inquire(isin)
-        end
-      end
-
-      ##
-      # EDIS payloads are validated upstream so no contract is applied.
-      #
-      # @return [nil] No validation contract is needed for EDIS operations
-      def validation_contract
-        nil
-      end
-    end
-  end
-end