用途:DhanHQ 是 Dhan 官方 Python SDK,用于在印度交易所(NSE、BSE、MCX)进行股票、F&O、商品与货币交易,以及获取行情、历史数据、期权链和账户组合信息。
主要能力:下单、切片大单、改单、撤单、订单簿与成交记录、超级订单、永久订单、持仓与持仓转换、eDIS、资金限额、保证金计算、日线/分钟历史、过期期权数据、行情快照、到期日列表、期权链、证券主数据、实时行情与订单更新、全市场深度、Kill Switch。
使用方式:安装 pip install dhanhq(需新 v2 能力时用 pip install --upgrade dhanhq)。初始化:from dhanhq import DhanContext, dhanhq;dhan_context = DhanContext("YOUR_CLIENT_ID", "YOUR_ACCESS_TOKEN");dhan = dhanhq(dhan_context)。也可用环境变量 DHAN_CLIENT_ID、DHAN_ACCESS_TOKEN。仓库脚本建议用 from scripts.dhan_helpers import get_client。
安全规则:实盘下单前确认;执行前展示可读订单预览;默认 LIMIT,除非用户明确要 MARKET;名义金额超 5 万卢比时警告;F&O 下单前校验手数;F&O、商品、货币段禁用 CNC 或 MTF;不得硬编码凭证;modify_order、cancel_order、kill_switch 及多腿实盘执行前需确认。
限制与注意:下单、改单、撤单、超级订单、永久订单需配置静态 IP 白名单;行情 API 限 1 次/秒;订单 API 10 次/秒、250 次/分、1000 次/时、7000 次/天;数据 API 5 次/秒、10 万次/天;非交易 API 20 次/秒。响应统一为 status/remarks/data,各端点结构不同。历史时间戳为 epoch,需显式转换。当前 SDK 方法为 intraday_minute_data,不要引用 historical_minute_data。expiry_code 文档为 0、1、2,SDK 校验含 3。交易 API 对 Dhan 用户免费,数据 API 需有效数据计划;若报 DH-902 或 806,需在 web.dhan.co 检查 dataPlan 并重新生成访问令牌。手数与冻结数量会变化,硬编码值仅作回退。基本面、技术指标等 Dhan 未提供的数据需借助 ScanX。