Introducing: Dhan Python API Library for Trading APIs

Naman · September 23, 2022, 4:31am

Hello Traders,

At Dhan, we always build to deliver a lightning-fast experience to our users, be it on our own platforms (Dhan App, Options Trading App, Dhan Web) or deeply integrated platforms (Dhan TradingView integration on tv.dhan.co, smallcase, stratzy, and more) or via our APIs that are used by partners or traders.

We use similar APIs formats and structures that we have extended to our Fast Trading APIs platform - Dhan HQ, we promised to deliver seamless integration to the Dhan experience. And it gives us immense delight to see new traders and platforms leveraging DhanHQ APIs every day to build better investing and trading experiences - many custom experiences that are built for systematic traders or who believe in building their own trading platforms to their choices.

Not just on Dhan, we are also improving on our APIs all this while. As we onboard more and more trade and tech geeks, we also recognize the need to diligently improvise our product to provide an effortless integration. We have already added comprehensive documentation for our APIs (here) and machine-generated code (here) along with documentation in 18 programming languages for our user’s convenience. Recently Dhan also introduced our API Bridge
for traders who want to trade with systems like Amibroker, MetaTrader, NinjaTrader and likes.

Introducing Dhan Python API Library

We are taking the next step in this direction. For our superfast users, we are minimising the steps between their codebase and our data & trading APIs. Today, we are announcing the launch of our first DhanHQ package for Python. This will help all our users and partners to install and start exploring the whole Dhan experience as quickly as they want.

Where can you find it?
We have added the python package to PyPI so that our users can search for and install the package with ease. This acts as a one-step integration that installs this package directly on your system and you can start communicating with the Dhan API within a matter of seconds.

Why a Python Package?
Python is considered to be the most accessible, high-level language which is used widely by traders. A Python library helps you to remove the step of adding and running individual APIs in your codebase. To integrate with Dhan HQ using the package, you will need Python 3.9 or above.

While building Dhan HQ and our API platforms, we also would like to acknowledge the benefits of FOSS and we intend to keep our library open for users to build on top of it. This shall also enable many individual traders to leverage APIs from Dhan HQ as we offer our trading APIs completely for free. If you are an open source developer and have ideas on building on top of these Python libraries and innovate or simplify further, we would love to connect with you and hope to build some good stuff together

We are constantly bridging the gap for our users, enabling them to trade using our platform as well as their own, all built on the same core principles that we follow. This is a step forward, and we will also aim to bring another suite of APIs to you soon.

Meanwhile, load up your Python libraries and start experiencing Dhan.
Happy Trading!

Thank you

Naman.
-Product team

t7support · September 23, 2022, 5:40am

Hi @naman

Is statement api available ?

sac777 · September 23, 2022, 7:03am

Good to hear Dhan is advancing.

But want to know if WebSocket is ready?

PravinJ · September 23, 2022, 9:37am

Hi @sac777 Welcome to Dhan community. Are you referring to Markets Feeds APIs or something else?

ssn · September 26, 2022, 4:44am

Thanks. Please resolve this BUG. For positions API, both realized and unrealized fields are coming as zero for open position

‘realizedProfit’: 0.0, ‘unrealizedProfit’: 0.0,

PravinJ · September 26, 2022, 5:27am

Hi @ssn

These values need to be computed using the APIs itself on the frontend. Its simple sum of all the positions in either states. We will update the documentation to ensure this is communicated as well.

t7support · September 27, 2022, 11:25am

@Naman @PravinJ @Dhan_Help

Is statement API available for use ?

PravinJ · September 27, 2022, 1:45pm

hi @t7support we usually release APIs after achieving product-market fit. At this point of time, we are enhancing a lot on backend systems and calculations and more. Will release once we are at a comfortable stage.

t7support · September 27, 2022, 1:57pm

K noted thanks @PravinJ

ssn · September 28, 2022, 3:06am

thanks @PravinJ . This comes for a single leg/position.

bsjhala · October 9, 2022, 4:36am

I am trying to use the Dhan Pyhton API for creating a Algo.

As per Documentation , I am trying to connect to API and getting the Holdings.
It is taking almost 1-2 minutes to give the Holdings.{Refer ScreenShot Below}

Further, when I am trying to place a Buy Order as per the Documentation following message is appearing:{refer screenShot below}

Whats the issue ??
Why results are displaying so late…

Documentation needs to be improved. Other Brokers are providing very good documentation for every function for easier understanding of API and implementation

Market_Wizard · October 9, 2022, 3:39pm

Hi, you can try the sample code below. There are couple of things in the Documentation that need to be fixed.

exchange_seg= ‘NSE_EQ’ should be exchange_segment=‘NSE_EQ’
There is no argument option for passing corelationID

from dhanhq import dhanhq


client_id = "Enter your client_id here "
access_token = "Enter your access_token here "
dhan = dhanhq(client_id, access_token)

# Place an order (hdfc bank- 1333)
market_order = dhan.place_order(
    security_id='1333',
    exchange_segment='NSE_EQ',
    transaction_type='BUY',
    order_type='MARKET',
    product_type='INTRADAY',
    quantity=10,
    price=0,
    trigger_price=0,
    validity='DAY',
    after_market_order='False'
)
print(market_order)

# Place limit order
limit_order = dhan.place_order(
    security_id='1333',
    exchange_segment='NSE_EQ',
    transaction_type='BUY',
    order_type='LIMIT',
    product_type='INTRADAY',
    quantity=10,
    price=100,
    trigger_price=0,
    validity='DAY',
    after_market_order='False'
)
print(limit_order)

# Place StopLoss Order
SL_Buy_order = dhan.place_order(
    security_id='1333',
    exchange_segment='NSE_EQ',
    transaction_type='BUY',
    order_type='STOP_LOSS',
    product_type='INTRADAY',
    quantity=1,
    price=110,
    trigger_price=100,
    validity='DAY',
    after_market_order='False'
)
print(SL_Buy_order)

# Intraday daily minute charts
intra_data = dhan.intraday_daily_minute_charts('11536', 'NSE_EQ', 'EQUITY')
print(intra_data)

# Fetch all orders
dhan.get_order_list()
print(dhan.get_order_list())

# Get positions
dhan.get_positions()

# Get holdings
dhan.get_holdings()

# Get fund limits
dhan.get_fund_limits()
print(dhan.get_fund_limits())

bsjhala · October 9, 2022, 5:01pm

Market_Wizard:

# Place an order (hdfc bank- 1333)
market_order = dhan.place_order(
    security_id='1333',
    exchange_segment='NSE_EQ',
    transaction_type='BUY',
    order_type='MARKET',
    product_type='INTRADAY',
    quantity=10,
    price=0,
    trigger_price=0,
    validity='DAY',
    after_market_order='False'
)
print(market_order)

@Market_Wizard

Sample Code worked. But as suggested by you, Lot of corrections required in documentation.
Code as per recent documents not working.

One More thing why Code is running extrmely slow. Taking more than a minute …

What is the cause and solution for the same.

Market_Wizard · October 10, 2022, 2:24am

I ran the same sample code at my end and it took less than a second. You need to check at your end what is causing the delay.

Hardik · October 10, 2022, 6:51am

Thank you @Market_Wizard for helping with the clarification here.

We have noted and will make the changes. For correlation ID, it is an optional field and can be added at user’s end if required.

9985243221 · October 11, 2022, 7:55am

yes, It is taking very long for first API call almost 1 min plus. subsequent API calls happening quickly

Hardik · October 11, 2022, 1:02pm

Hello @9985243221
Welcome to Dhan Community!

We have added some fixes in our python library - here. This will help with the delayed API response. Hence, we request you to reinstall the library in order to get updated version.

stanly_thomas · January 12, 2023, 12:35pm

Hi @Hardik , when can we expect the order slicing option to come to python library?

Hardik · January 13, 2023, 5:31am

Hello @stanly_thomas

Our team is working on releasing next version of Python library which will include order slicing and couple of other APIs in the library as well. We will keep you updated here.

Dhanu · February 7, 2023, 7:32am

Dear Dhan team, it’s very good to use your python API. But most of the functions are not able to access as the parameter type mismatches. I want to remind you that providing an API is useless if you don’t provide clear documentation for the API. It is very difficult to use your API without documentation.