Dhan
Dhan is a new-generation financial services platform that empowers traders and investors to build, automate, and execute their trading strategies. Through DhanHQ APIs, users can connect their Dhan account with tools like OpenAlgo and create their own trading automation setup — fully self-hosted and secure.
Overview
Dhan provides two main types of APIs:
Trading APIs
Order Placement, Position Management, Portfolio & Funds, Order Postbacks, Statement Reports
Free of Cost
Data APIs
Real-time Prices, Historical Data (5 years), 20-Level Market Depth, Option Chain APIs, Expired Options Data
₹499/month or ₹399/month (₹4,788/year)
Steps for Integration
Step 1: Log in to Dhan Web Portal
Visit web.dhan.co and sign in to your Dhan account.
Step 2: Access DhanHQ APIs
Click on your profile icon at the top-right and select “Access DhanHQ APIs”.
From this page, you can:
Generate API Keys
Enable TOTP
Setup Static IP
Manage Trading & Data APIs

Step 3: Switch to API Key Mode
By default, DhanHQ opens in Access Token mode. Use the toggle on the top-right to switch to API Key Mode.

Step 4: Generate a New API Key
Under Generate new API Key, enter:
Application Name → e.g.
openalgo
Redirect URL →
http://127.0.0.1:5000/dhan/callback
(Optional) Postback URL if your system supports order postbacks
Click Generate API Key.
Copy your:
API Key
API Secret

Step 5: Retrieve Client ID
From the same profile menu, select “My Profile on Dhan.”
Scroll to Profile Details and copy your Client ID. This will be used as part of your API credentials.

Step 6: Enable TOTP (Mandatory)
Under Optional Settings - down below the API Key section, click Set-up TOTP.
Follow the instructions to configure two-factor authentication for API access.
This is mandatory for all Dhan API users.
Step 7: Setup Static IP (Optional / Mandatory from Jan 2026)
Click Static IP Setting under Optional Settings.
Add up to two IP addresses (e.g., your server or office IP).
You can update these every 7 days.
From January 2026, setting at least one Static IP will become mandatory.

Environment Configuration
Once your credentials are generated, configure them in your .env
file:
BROKER_API_KEY = 'your_dhan_clientid:::your_dhan_apikey'
BROKER_API_SECRET = 'your_dhan_apisecret'
REDIRECT_URL = 'http://127.0.0.1:5000/dhan/callback'
API Costs Summary
Trading APIs
Order, Position, Portfolio, Funds & Report APIs
✅ Free of Cost
Data APIs
Real-time + Historical Data (5 years), Market Depth, Option Chain
💸 ₹499/month (or ₹399/month billed yearly)
Best Practices
Keep your API Key, Secret, and Client ID private.
Do not share credentials with third-party applications.
Always enable TOTP for added security.
Use Static IPs when deploying in production environments.
Daily login to OpenAlgo Portal is mandatory.
Integrating with DhanHQ APIs unlocks the ability to automate strategies, execute trades, and analyze data directly within your own infrastructure. When used with OpenAlgo, you can self-host and run your entire algo trading stack — with full control and zero vendor lock-in.
Last updated
Was this helpful?