DhanHQ v2 API Bridge Connector Sample Script for MT5

//+------------------------------------------------------------------+
//|                                                  Sample_Dhan.mq5 |
//|            Sample script exercising the DhanHQ v2 API bridge.    |
//|                                                                   |
//|  BEFORE RUNNING:                                                 |
//|  1. Compile Library_Dhan.mq5 into MQL5\Libraries\Library_Dhan.ex5 |
//|  2. In MetaTrader 5: Tools -> Options -> Expert Advisors,         |
//|     tick "Allow WebRequest for listed URL" and add:              |
//|        https://api.dhan.co                                       |
//|  3. Generate a 24h Access Token from web.dhan.co (My Profile ->  |
//|     Access DhanHQ APIs) and copy your Dhan Client ID.            |
//|     Docs: https://docs.dhanhq.co/api/v2/guides/authentication    |
//|  4. Static IP whitelisting is MANDATORY for order placement/     |
//|     modification/cancellation per SEBI rules. Set InpStaticIpEnabled
//|     = true and provide your ISP static IP, or configure it once  |
//|     from web.dhan.co and leave it disabled here.                 |
//|     Docs: https://docs.dhanhq.co/api/v2/authentication/set-ip    |
//+------------------------------------------------------------------+
#property copyright "Copyright 2026"
#property link      "https://docs.dhanhq.co"
#property version   "1.0"
#property script_show_inputs

struct DhanConfig {
   string            api_url;
   string            access_token;
   string            client_id;
   bool              static_ip_enabled;
   string            static_ip;
   string            static_ip_flag;
   bool              debug;
};

#import "..\Libraries\Library_Dhan.ex5"
void   Dhan_Init(DhanConfig &config);
string GetProfile();
// Static IP
string SetStaticIP(string ip, string ip_flag);
string ModifyStaticIP(string ip, string ip_flag);
string GetStaticIP();
string ApplyStaticIP();
// Orders
string PlaceOrder(string transaction_type, string exchange_segment, string product_type, string order_type, string validity, string security_id, long quantity, double price, double trigger_price, long disclosed_quantity, bool after_market_order, string amo_time, string correlation_id);
string OrderMarket(string transaction_type, string exchange_segment, string product_type, string security_id, long quantity);
string OrderLimit(string transaction_type, string exchange_segment, string product_type, string security_id, long quantity, double price, string validity);
string OrderStopLoss(string transaction_type, string exchange_segment, string product_type, string security_id, long quantity, double price, double trigger_price);
string OrderStopLossMarket(string transaction_type, string exchange_segment, string product_type, string security_id, long quantity, double trigger_price);
string ModifyOrder(string order_id, string order_type, string validity, long quantity, double price, double trigger_price, long disclosed_quantity, string leg_name);
string CancelOrder(string order_id);
string GetOrders();
string GetOrderById(string order_id);
string GetOrderByCorrelationId(string correlation_id);
string SliceOrder(string transaction_type, string exchange_segment, string product_type, string order_type, string validity, string security_id, long quantity, double price, double trigger_price, long disclosed_quantity, bool after_market_order, string amo_time, string correlation_id);
string GetTrades();
string GetTradesByOrderId(string order_id);
// Super orders
string PlaceSuperOrder(string transaction_type, string exchange_segment, string product_type, string order_type, string security_id, long quantity, double price, double target_price, double stop_loss_price, double trailing_jump, string correlation_id);
string ModifySuperOrder(string order_id, string order_type, string leg_name, long quantity, double price, double target_price, double stop_loss_price, double trailing_jump);
string CancelSuperOrderLeg(string order_id, string order_leg);
string GetSuperOrders();
// Portfolio
string GetHoldings();
string GetPositions();
string ConvertPosition(string exchange_segment, string from_product_type, string to_product_type, string position_type, string security_id, long convert_qty);
string ExitAllPositions();
// Funds
string GetFundLimits();
string CalculateMargin(string exchange_segment, string transaction_type, string product_type, string security_id, long quantity, double price, double trigger_price);
// Trader's control
string ManageKillSwitch(string kill_switch_status);
// Helpers
string ParseOrderId(string response);
string ParseOrderStatus(string response);
#import

//--- Connection / auth
input string InpApiUrl          = "https://api.dhan.co/v2";
input string InpAccessToken     = "PASTE_YOUR_ACCESS_TOKEN";   // 24h JWT from web.dhan.co
input string InpClientId        = "PASTE_YOUR_CLIENT_ID";      // Dhan Client ID
input bool   InpDebug           = true;

//--- Static IP (mandatory for order placement/modify/cancel)
input bool   InpStaticIpEnabled = false;                       // enable/disable IP whitelisting
input string InpStaticIp        = "";                          // your ISP static IPv4/IPv6
input string InpStaticIpFlag    = "PRIMARY";                   // PRIMARY or SECONDARY

//--- Sample order parameters
input string InpExchangeSegment = "NSE_EQ";                    // e.g. NSE_EQ, NSE_FNO
input string InpProductType     = "INTRADAY";                  // CNC, INTRADAY, MARGIN, MTF
input string InpSecurityId      = "1333";                      // 1333 = HDFC Bank on NSE_EQ
input long   InpQuantity        = 1;
input double InpLimitPrice      = 1500.0;

//+------------------------------------------------------------------+
void OnStart() {
   DhanConfig cfg;
   cfg.api_url           = InpApiUrl;
   cfg.access_token      = InpAccessToken;
   cfg.client_id         = InpClientId;
   cfg.static_ip_enabled = InpStaticIpEnabled;
   cfg.static_ip         = InpStaticIp;
   cfg.static_ip_flag    = InpStaticIpFlag;
   cfg.debug             = InpDebug;
   Dhan_Init(cfg);

   Print("=== Authentication check ===");
   Print("Profile: ", GetProfile());

   Print("=== Static IP setup ===");
   // ApplyStaticIP() is a no-op unless InpStaticIpEnabled = true.
   Print("ApplyStaticIP: ", ApplyStaticIP());
   Print("Current IPs: ", GetStaticIP());

   Print("=== Account / Funds ===");
   Print("Fund limits: ", GetFundLimits());
   Print("Positions: ", GetPositions());
   Print("Holdings: ", GetHoldings());

   Print("=== Order book / Trade book ===");
   Print("Orders: ", GetOrders());
   Print("Trades: ", GetTrades());

   Print("=== Margin calculation ===");
   Print("Margin: ", CalculateMargin(InpExchangeSegment, "BUY", InpProductType,
                                      InpSecurityId, InpQuantity, InpLimitPrice, 0));

   // ---------------------------------------------------------------
   // The trading calls below are commented out for safety. Uncomment
   // to place REAL orders. Static IP whitelisting must be active.
   // ---------------------------------------------------------------
   //
   // string limitResp = OrderLimit("BUY", InpExchangeSegment, InpProductType,
   //                               InpSecurityId, InpQuantity, InpLimitPrice, "DAY");
   // Print("Limit order: ", limitResp);
   // string orderId = ParseOrderId(limitResp);
   // Print("New order id: ", orderId, " status=", ParseOrderStatus(limitResp));
   //
   // Print("Market order: ", OrderMarket("BUY", InpExchangeSegment, InpProductType,
   //                                     InpSecurityId, InpQuantity));
   //
   // Print("Stop-loss order: ", OrderStopLoss("SELL", InpExchangeSegment, InpProductType,
   //                              InpSecurityId, InpQuantity, InpLimitPrice * 0.95, InpLimitPrice * 0.96));
   //
   // Print("Stop-loss market: ", OrderStopLossMarket("SELL", InpExchangeSegment, InpProductType,
   //                              InpSecurityId, InpQuantity, InpLimitPrice * 0.95));
   //
   // if(StringLen(orderId) > 0) {
   //    Print("Order by id: ", GetOrderById(orderId));
   //    Print("Modify order: ", ModifyOrder(orderId, "LIMIT", "DAY", InpQuantity,
   //                                         InpLimitPrice * 1.01, 0, 0, ""));
   //    Print("Trades for order: ", GetTradesByOrderId(orderId));
   //    Print("Cancel order: ", CancelOrder(orderId));
   // }
   //
   // Print("Slice order: ", SliceOrder("BUY", "NSE_FNO", InpProductType, "LIMIT", "DAY",
   //                        InpSecurityId, 1800, InpLimitPrice, 0, 0, false, "", ""));
   //
   // Print("=== Super order (bracket) ===");
   // string superResp = PlaceSuperOrder("BUY", InpExchangeSegment, InpProductType, "LIMIT",
   //                    InpSecurityId, InpQuantity, InpLimitPrice,
   //                    InpLimitPrice * 1.05, InpLimitPrice * 0.95, 1.0, "");
   // Print("Super order: ", superResp);
   // string superId = ParseOrderId(superResp);
   // if(StringLen(superId) > 0) {
   //    Print("Modify super (target leg): ", ModifySuperOrder(superId, "LIMIT", "TARGET_LEG",
   //                                          0, 0, InpLimitPrice * 1.06, 0, 0));
   //    Print("Cancel super target leg: ", CancelSuperOrderLeg(superId, "TARGET_LEG"));
   // }
   // Print("Super orders: ", GetSuperOrders());
   //
   // Print("=== Portfolio management ===");
   // Print("Convert position: ", ConvertPosition(InpExchangeSegment, "INTRADAY", "CNC",
   //                              "LONG", InpSecurityId, InpQuantity));
   // Print("Exit all positions: ", ExitAllPositions());
   //
   // Print("=== Trader's control ===");
   // Print("Kill switch ACTIVATE: ", ManageKillSwitch("ACTIVATE"));

   Print("Sample finished.");
}
//+------------------------------------------------------------------+