DhanHQ Agent Skills

Use DhanHQ APIs inside AI agents like Claude Code, Codex or any other agent of your choice.

Dhan-native agent skill for NSE/BSE equities, F&O, and commodity trading.

Give your AI agent the ability to place live orders, read real portfolio data, stream market feeds, and access the full instrument universe of Indian exchanges — all through DhanHQ’s APIs.

Built for the Agent Skills open standard and compatible with Claude Code, Codex, and any agent that supports SKILL.md.

---

Installation

You don’t need to clone the repository. Install the skill directly with npx.

Global install

npm install -g skills
skills add dhan-oss/dhanhq-skills --skill dhanhq

Claude Code or Codex

npx skills add dhan-oss/dhanhq-skills --skill dhanhq

OR

npx @dhan-oss/dhanhq-skill

---

After Installation

Once installed, your AI agent can automatically use the dhanhq skill when your prompt involves DhanHQ APIs, Indian market data, portfolio, orders, funds, or trading workflows.

Example prompts:

• Show my holdings
• Get daily OHLC for RELIANCE for the last 6 months
• Show Nifty option chain for nearest expiry
• Check margin required to sell 1 lot of Nifty

Requirements

• Python 3.8+ and pip install dhanhq
• Order APIs: static IP whitelisting on Dhan required
• Data APIs: active Dhan Data Plan required
• Credentials via environment variables: DHAN_CLIENT_ID and DHAN_ACCESS_TOKEN

---

What’s Included

skills/
└── dhanhq/
    ├── SKILL.md                          # Entry point — setup, safety rules, core patterns
    │
    ├── references/                       # Deep-dive docs loaded on demand
    │   ├── orders.md                     # Order lifecycle (regular, super, forever, AMO)
    │   ├── portfolio.md                  # Holdings, positions, convert position, eDIS
    │   ├── market-data.md                # Historical OHLC, intraday, quotes
    │   ├── option-chain.md               # Option chain with Greeks, expiry list
    │   ├── instruments.md                # Security master, symbol resolution
    │   ├── funds.md                      # Fund limits and margin calculator
    │   ├── live-feed.md                  # WebSocket: MarketFeed, OrderUpdate, FullDepth
    │   ├── error-codes.md                # Error codes, rate limits, retry patterns
    │   ├── scanx-data.md                 # ScanX real-time scanner data
    │   ├── common-workflows.md           # Multi-step patterns (rebalance, iron condor, P&L)
    │   ├── options-analysis-patterns.md  # PCR, max pain, payoff diagrams, IV skew
    │   └── backtesting-with-dhan.md      # Equity + F&O backtest patterns with cost model
    │
    ├── scripts/
    │   ├── dhan_helpers.py               # Composable helper library
    │   ├── resolve_security.py           # Human name → security_id resolver