# TradeHull Dhan Codebase Project
This project is built to interact with the **Dhan API** using the `Dhan_Tradehull` library. It provides a comprehensive suite of tools for trading, fetching market data, placing orders, and analyzing options.
---
## Features
- **Fetch Market Data**: Get Live Trading Price (LTP), historical data, and intraday data.
- **Order Placement**: Place, modify, or cancel orders with various parameters.
- **Option Greeks**: Retrieve Greeks like Delta, Theta, Gamma, and Vega for options.
- **Option Strike Selection**: Automate ATM, ITM, and OTM strike price identification.
- **Portfolio Management**: Fetch holdings, positions, and balances.
- **Option Chain**: Retrieve and analyze option chain data.
- **Advanced Order Types**: Supports sliced orders, bracket orders, and stop-loss orders.
---
## Installation
1. pip install Dhan-Tradehull
2. Install required dependencies:
pip install -r requirement.txt
## Usage
### Dhan API Authentication
Update the client_code and token_id with your Dhan API credentials:
```python
from Dhan_Tradehull import Tradehull
client_code = "your_client_code"
token_id = "your_token_id"
tsl = Tradehull(client_code, token_id)
```
## Key Functionalities
1. **Fetch Live Market Data**
Get the latest trading price (LTP) or quote data:
*Get LTP*
- tsl.get_ltp_data(names: list or str, debug: str = "NO")
- Arguments:
- names (list or str): List of instrument names or a single instrument name to fetch the LTP.
- debug (optional, str): Set to "YES" to enable detailed API response logging. Default is "NO".
- Sample Code:
```python
data = tsl.get_ltp_data(names=['CRUDEOIL', 'NIFTY'])
crudeoil_ltp = data['CRUDEOIL']
```
*Get Quotes*
- tsl.get_quote_data(names: list or str, debug: str = "NO")
- Arguments:
- names (list or str): List of instrument names or a single instrument name to fetch the Quote data.
- debug (optional, str): Set to "YES" to enable detailed API response logging. Default is "NO".
- Sample Code:
```python
data = tsl.get_quote_data(names=['CRUDEOIL', 'NIFTY'])
crudeoil_quote_data = data['CRUDEOIL']
```
*Get OHLC*
- tsl.get_ohlc_data(names: list or str, debug: str = "NO")
- Arguments:
- names (list or str): List of instrument names or a single instrument name to fetch the OHLC data.
- debug (optional, str): Set to "YES" to enable detailed API response logging. Default is "NO".
- Sample Code:
```python
data = tsl.get_ohlc_data(names=['CRUDEOIL', 'NIFTY'])
crudeoil_ohlc_data = data['CRUDEOIL']
```
---
2. **Fetch Historical Data**
Retrieve historical or intraday data:
*Get Historical Data*
- tsl.get_historical_data(tradingsymbol: str, exchange: str, timeframe: str, debug: str = "NO")
- Arguments:
- tradingsymbol (str): The trading symbol for the instrument you want to fetch data for (e.g., 'NIFTY', 'ACC').
- exchange (str): The exchange where the instrument is traded (e.g., 'NSE', 'INDEX').
- timeframe (str): The timeframe for the data. It can be:
- '1' for 1-minute candles
- '5' for 5-minute candles
- '15' for 15-minute candles
- '25' for 25-minute candles
- '60' for 60-minute candles
- 'DAY' for daily candles
- debug (optional, str): Set to "YES" to enable detailed API response logging. Default is "NO".
- Sample Code:
```python
data = tsl.get_historical_data(tradingsymbol='NIFTY', exchange='INDEX', timeframe="DAY")
data = tsl.get_historical_data(tradingsymbol='ACC', exchange='NSE', timeframe="1")
```
*Get Intraday Data*
- tsl.get_intraday_data(tradingsymbol: str, exchange: str, timeframe: int, debug: str = "NO")
- Arguments:
- tradingsymbol (str): The trading symbol for the instrument you want to fetch data for (e.g., 'NIFTY', 'ACC').
- exchange (str): The exchange where the instrument is traded (e.g., 'NSE', 'INDEX').
- timeframe (int): The timeframe for the data in minutes. It can be:
- 1 for 1-minute candles
- 2 for 2-minute candles
- 3 for 3-minute candles
- 5 for 5-minute candles
- 10 for 10-minute candles
- 15 for 15-minute candles
- 30 for 30-minute candles
- 60 for 60-minute candles
- debug (optional, str): Set to "YES" to enable detailed API response logging. Default is "NO".
- Sample Code:
```python
data = tsl.get_intraday_data(tradingsymbol='NIFTY', exchange='INDEX', timeframe=10)
```
---
3. **Option Strike Selection**
ATM/ITM/OTM strike selection:
*Get ATM Strikes*
- tsl.ATM_Strike_Selection(Underlying: str, Expiry: int)
- Arguments:
- Underlying (str): The index or instrument name for which you want to find the ATM strike prices (e.g., 'NIFTY', 'BANKNIFTY').
- Expiry (int): The expiry to select.
- 0 - Current week/month (depending on expiry type)
- 1 - Next week/month (depending on expiry type)
- and so on for subsequent weeks/months.
- Returns:
- CE_symbol_name (str): The option symbol for the Call strike.
- PE_symbol_name (str): The option symbol for the Put strike.
- strike (int): The ATM strike price.
- Sample Code:
```python
CE_symbol_name, PE_symbol_name, strike_price = tsl.ATM_Strike_Selection(Underlying='NIFTY', Expiry=0)
```
*Get OTM Strikes*
- tsl.OTM_Strike_Selection(Underlying: str, Expiry: int, OTM_count: int)
- Arguments:
- Underlying (str): The index or instrument name for which you want to find the OTM strike prices (e.g., 'NIFTY', 'BANKNIFTY').
- Expiry (int): The expiry to select.
- 0 - Current week/month (depending on expiry type)
- 1 - Next week/month (depending on expiry type)
- and so on for subsequent weeks/months.
- OTM_count (int): The number of steps to move away from the ATM strike to find the OTM strike prices (e.g., 5 means 5 steps away).
- Returns:
- CE_symbol_name (str): The option symbol for the OTM Call strike.
- PE_symbol_name (str): The option symbol for the OTM Put strike.
- CE_OTM_price (int): The OTM Call strike price.
- PE_OTM_price (int): The OTM Put strike price.
- Sample Code:
```python
CE_symbol_name, PE_symbol_name, CE_OTM_price, PE_OTM_price = tsl.OTM_Strike_Selection(Underlying='NIFTY', Expiry=0, OTM_count=5)
```
*Get ITM Strikes*
- tsl.ITM_Strike_Selection(Underlying: str, Expiry: int, ITM_count: int)
- Arguments:
- Underlying (str): The index or instrument name for which you want to find the ITM strike prices (e.g., 'NIFTY', 'BANKNIFTY').
- Expiry (int): The expiry to select.
- 0 - Current week/month (depending on expiry type)
- 1 - Next week/month (depending on expiry type)
- and so on for subsequent weeks/months.
- ITM_count (int): The number of steps to move away from the ATM strike to find the ITM strike prices (e.g., 1 means 1 step closer to the underlying price).
- Returns:
- CE_symbol_name (str): The option symbol for the ITM Call strike.
- PE_symbol_name (str): The option symbol for the ITM Put strike.
- CE_ITM_price (int): The ITM Call strike price.
- PE_ITM_price (int): The ITM Put strike price.
- Sample Code:
```python
CE_symbol_name, PE_symbol_name, CE_ITM_price, PE_ITM_price = tsl.ITM_Strike_Selection(Underlying='NIFTY', Expiry=0, ITM_count=1)
```
---
4. **Option Greeks**
Fetch Greeks for a specific option:
*Get Option Greek*
- tsl.get_option_greek(strike: int, expiry: int, asset: str, interest_rate: float, flag: str, scrip_type: str)
- Arguments:
- strike (int): The strike price of the option.
- expiry (int): The expiry to select.
- 0 - Current week/month (depending on expiry type).
- 1 - Next week/month (depending on expiry type).
- and so on for subsequent weeks/months.
- asset (str): The underlying asset for the option (e.g., 'NIFTY').
- interest_rate (float): The interest rate to be used in calculations (e.g., 10).
- flag (str): The Greek value to fetch.
- 'price' - Option price.
- 'delta' - Delta value.
- 'delta2' - Second-order delta.
- 'theta' - Theta value.
- 'rho' - Rho value.
- 'vega' - Vega value.
- 'gamma' - Gamma value.
- 'all_val' - All Greeks values in a dictionary.
- scrip_type (str): The option type ('CE' for Call options, 'PE' for Put options).
- Returns:
- Depending on the flag, it returns the requested Greek value or all Greek values in a dictionary.
- Sample Code:
```python
all_values = tsl.get_option_greek(strike=24400, expiry=0, asset='NIFTY', interest_rate=10, flag='all_val', scrip_type='CE')
```
---
5. **Order Placement and Management**
Place, modify, or cancel orders:
*Get Order Placement*
- tsl.order_placement(tradingsymbol: str, exchange: str, quantity: int, price: int, trigger_price: int,
order_type: str, transaction_type: str, trade_type: str, disclosed_quantity=0, after_market_order=False,
validity='DAY', amo_time='OPEN', bo_profit_value=None, bo_stop_loss_value=None) -> str
- Arguments:
- tradingsymbol (str): The trading symbol (e.g., 'NIFTY 21 NOV 23300 CALL').
- exchange (str): The exchange (e.g., 'NFO', 'MCX', 'NSE').
- quantity (int): The number of contracts to buy/sell.
- price (int): The price at which to place the order.
- trigger_price (int): The trigger price for stop orders.
- order_type (str): Type of order ('MARKET', 'LIMIT', 'STOPLIMIT', 'STOPMARKET').
- transaction_type (str): Type of transaction ('BUY' or 'SELL').
- trade_type (str): Type of trade ('MIS', 'MARGIN', 'MTF', 'CO', 'BO', 'CNC').
- disclosed_quantity (int, optional): Quantity disclosed to the market (default is 0).
- after_market_order (bool, optional): Whether it is an after-market order (default is False).
- validity (str, optional): Validity of the order ('DAY', 'IOC').
- amo_time (str, optional): AMO time ('PRE_OPEN', 'OPEN', 'OPEN_30', 'OPEN_60') if after-market order.
- bo_profit_value (float, optional): Profit value for BO orders (default is None).
- bo_stop_loss_value (float, optional): Stop loss value for BO orders (default is None).
- Returns:
- str: The order ID if the order is placed successfully, or None if there was an error.
- Sample Orders:
```python
orderid1 = tsl.order_placement('NIFTY 21 NOV 24400 CALL','NFO',25, 0.05, 0, 'LIMIT', 'BUY', 'MIS')
print(orderid1)
orderid2 = tsl.order_placement('YESBANK','NSE', 1, 0, 0, 'MARKET', 'BUY', 'MIS')
print(orderid2)
orderid = tsl.order_placement('SENSEX 06 SEP 81900 PUT','BFO',10, 0, 0, 'MARKET', 'BUY', 'MIS')
orderid = tsl.order_placement('ACC','NSE', 1, 0, 0, 'MARKET', 'BUY', 'MIS')
orderid = tsl.order_placement('CRUEDOIL DEC FUT','MCX', 1, 4567, 0, 'LIMIT', 'BUY', 'CNC')
orderid = tsl.order_placement('ACC','NSE', 1, 2674, 2670, 'STOPLIMIT', 'BUY', 'MIS')
orderid = tsl.order_placement('ACC','NSE', 1, 0, 2670, 'STOPMARKET', 'BUY', 'MIS')
```
- Sample Code:
```python
orderid = tsl.order_placement(tradingsymbol='NIFTY 19 DEC 23300 CALL', exchange='NFO', quantity=25, price=0.05, trigger_price=0,order_type='LIMIT', transaction_type='BUY', trade_type='MIS')
```
*Get Order Modification*
- tsl.modify_order(order_id, order_type, quantity, price=0, trigger_price=0, disclosed_quantity=0, validity='DAY', leg_name=None) -> str
- Arguments:
- order_id (str): The unique ID of the order to be modified.
- order_type (str): Type of the order. Options include:
- 'LIMIT': Limit order.
- 'MARKET': Market order.
- 'STOPLIMIT': Stop-loss limit order.
- 'STOPMARKET': Stop-loss market order.
- quantity (int): The updated quantity for the order.
- price (float, optional): The updated price for the order (default is 0).
- trigger_price (float, optional): The updated trigger price for the order (default is 0).
- disclosed_quantity (int, optional): The quantity to disclose (default is 0).
- validity (str, optional): Validity of the order. Options are:
- 'DAY': Order remains valid for the trading day (default).
- 'IOC': Immediate or cancel.
- leg_name (str, optional): The specific leg to modify (used for bracket/CO orders). Options are:
- 'ENTRY_LEG': Entry leg of the order.
- 'TARGET_LEG': Target leg of the order.
- 'STOP_LOSS_LEG': Stop-loss leg of the order.
- If not applicable, leave as None.
- Returns:
- str: The modified order ID if the modification is successful.
- Raises an exception if the modification fails.
- Sample Code:
```python
orderid = '12241210603927'
modified_order_id = tsl.modify_order(order_id=orderid,order_type="LIMIT",quantity=50,price=0.1,trigger_price=0)
```
*Get Order Cancelation*
- tsl.cancel_order(OrderID: str) -> None
- Arguments:
- OrderID (str): The unique ID of the order to be canceled.
- Returns:
- str: The status of the canceled order if successful (e.g., "Cancelled").
- Raises an exception if the cancellation fails.
- Sample Code:
```python
orderid = '12241210603927'
order_status = tsl.cancel_order(OrderID=orderid)
```
*Get All Intraday Order Cancelation and Intraday Position Close*
- To cancell all the intraday open and trigger pending orders, square off all the positions
- tsl.cancel_all_orders()
- Sample Code:
```python
order_details = tsl.cancel_all_orders()
```
*Get Place Order Sliced*
- tsl.place_slice_order(tradingsymbol: str, exchange: str, transaction_type: str, quantity: int, order_type: str, trade_type: str, price: float, trigger_price: float = 0, disclosed_quantity: int = 0, after_market_order: bool = False, validity: str = 'DAY', amo_time: str = 'OPEN', bo_profit_value: float = None, bo_stop_loss_Value: float = None ) -> str | list
- Arguments:
- tradingsymbol (str): The symbol for the instrument to trade.
- exchange (str): The exchange where the order is placed (e.g., NSE, NFO, MCX).
- transaction_type (str): "BUY" or "SELL".
- quantity (int): Total quantity to be ordered.
- order_type (str): Type of order ("LIMIT", "MARKET", "STOPLIMIT", "STOPMARKET").
- trade_type (str): Type of trade ("MIS", "CNC", "CO", "BO", etc.).
- price (float): Price for the order (used for LIMIT orders).
- trigger_price (float): Trigger price for stop-loss orders (default is 0).
- disclosed_quantity (int): Quantity to disclose (default is 0).
- after_market_order (bool): If true, places the order as an after-market order.
- validity (str): Validity of the order ("DAY", "IOC").
- amo_time (str): Timing for after-market orders ("PRE_OPEN", "OPEN", etc.).
- bo_profit_value (float): Profit target value for bracket orders (default is None).
- bo_stop_loss_Value (float): Stop-loss value for bracket orders (default is None).
- Returns:
- str: A single order ID if the order is not sliced.
- list: A list of order IDs if the order involves multiple slices.
- None: Returns None if an exception occurs.
- Sample Code:
```python
order_ids = tsl.place_slice_order(tradingsymbol="NIFTY 19 DEC 18000 CALL",exchange="NFO",transaction_type="BUY",quantity=1875,order_type="LIMIT",trade_type="MIS",price=0.05)
```
*Get Order Details*
- Get detailed information about a specific order
- tsl.get_order_detail(orderid:str)
- Arguments:
- orderid: The unique identifier of the order.
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- Dictionary containing details of the order, such as price, quantity, status, etc.
- Sample Code:
```python
orderid = '12241210603927'
order_details = tsl.get_order_detail(orderid=orderid)
```
*Get Order Status*
- Get the current status of a specific order
- tsl.get_order_status(orderid:str)
- Arguments:
- orderid: The unique identifier of the order.
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- String representing the status of the order (e.g., 'Pending', 'Completed').
- Sample Code:
```python
orderid = '12241210603927'
order_status = tsl.get_order_status(orderid=orderid)
```
*Get Order Executed Price*
- Get the average traded price of an executed order
- tsl.get_executed_price(orderid:str)
- Arguments:
- orderid: The unique identifier of the order.
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- Integer representing the average price at which the order was executed.
- Sample Code:
```python
orderid = '12241210603927'
order_price = tsl.get_executed_price(orderid=orderid)
```
*Get Order Exchange Time*
- Get the exchange timestamp for a specific order
- order_time = tsl.get_exchange_time(orderid=orderid)
- Arguments:
- orderid: The unique identifier of the order.
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- String with the timestamp of the order execution as recorded by the exchange.
- Sample Code:
```python
orderid = '12241210603927'
order_time = tsl.get_exchange_time(orderid=orderid)
```
---
6. **Portfolio Management**
Fetch holdings, positions, and balances:
*Get Holdings*
- Fetch current holdings
- tsl.get_holdings(debug="NO")
- Arguments:
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- pd.DataFrame: A DataFrame containing the list of holdings, including details like symbol, quantity, and average price.
- In case of an error, returns a dictionary with 'status' as 'failure', error message, and data.
- Sample Code:
```python
holdings = tsl.get_holdings()
```
*Get Positions*
- Fetch current open positions
- tsl.get_positions(debug="NO")
- Arguments:
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- pd.DataFrame: A DataFrame containing the list of open positions with details like symbol, quantity, average price, etc.
- In case of an error, returns a dictionary with 'status' as 'failure', error message, and data.
- Sample Code:
```python
positions = tsl.get_positions()
```
*Get Orderbook*
- Fetch the order book
- tsl.get_orderbook(debug="NO")
- Arguments:
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- pd.DataFrame: A DataFrame containing the list of all orders placed, including details such as symbol, quantity, status, and price.
- In case of an error, returns a dictionary with 'status' as 'failure', error message, and data.
- Sample Code:
```python
orderbook = tsl.get_orderbook()
```
*Get Tradebook*
- Fetch the trade book
- tsl.get_trade_book(debug="NO")
- Arguments:
- debug (str, optional): Set to "YES" to print debug information (default is "NO").
- Returns:
- pd.DataFrame: A DataFrame containing the list of all completed trades with details such as symbol, quantity, price, and trade time.
- In case of an error, returns a dictionary with 'status' as 'failure', error message, and data.
- Sample Code:
```python
tradebook = tsl.get_trade_book()
```
*Get Balance*
- To get the available balance from the Dhan API client
- tsl.get_balance()
- Sample Code:
```python
available_balance = tsl.get_balance()
```
*Get Live PNL*
- To get the live PNL of current positions
- tsl.get_live_pnl()
- Sample Code:
```python
PNL = tsl.get_live_pnl()
```
*Get Lot Size*
- To get the lot size for the futures and options
- tsl.get_lot_size(Tradingsymbol: str)
- Sample Code:
```python
lot_size = tsl.get_lot_size(tradingsymbol = 'NIFTY 19 DEC 24400 CALL')
```
*Get Margin for Tradingsymbol*
- To get the margin for the stocks, futures and options
- tsl.margin_calculator(tradingsymbol: str, exchange: str, transaction_type: str, quantity: int, trade_type: str, price: float, trigger_price:float)
- Sample Code:
```python
Margin = tsl.margin_calculator(tradingsymbol='NIFTY DEC FUT', exchange='NFO', transaction_type='BUY', quantity=25, trade_type='MARGIN', price=24350, trigger_price=0)
```
---
7. **Option Chain Analysis**
Retrieve and analyze the option chain:
*Get Option Chain*
- tsl.get_option_chain(Underlying: str, exchange: str, expiry: int) -> pd.DataFrame | None
- Arguments:
- Underlying (str): The symbol of the underlying asset (e.g., "NIFTY", "BANKNIFTY", "RELIANCE").
- exchange (str): The exchange where the options are traded (e.g., "NSE", "NFO", "MCX").
- expiry (int): Index of the expiry date in the list of available expiry dates (0 for the nearest expiry).
- Returns:
- pd.DataFrame: A formatted DataFrame containing the option chain data with details like strike price, call/put LTP, OI, volume, etc.
- None: Returns None if there is an error or no expiry data is found.
- Sample Code:
```python
option_chain = tsl.get_option_chain(Underlying="NIFTY", exchange="INDEX", expiry=0)
```
---
8. **Alerts via Telegram**
send a Alerts via Telegram
*Send Telegram Alerts*
- tsl.send_telegram_alert(message: str,receiver_chat_id: str,bot_token: str) -> None
- Arguments:
- message (str): The text message to send. Supports basic text formatting.
- receiver_chat_id (str): The unique chat ID of the Telegram user or group.
- For individual users: Use their chat ID.
- For groups: Use the group’s chat ID (ensure the bot is added to the group).
- bot_token (str): The authorization token of the Telegram bot.
- Obtainable when creating a bot via the Telegram BotFather.
- Returns:
- None: The function prints a success or failure message in the console.
- Sample Code:
```python
tsl.send_telegram_alert(message="Order executed: BUY 50 shares of RELIANCE",receiver_chat_id="123456789",bot_token="123456789:ABCDEFGHIJKLMNOPQRSTUVWXYZ")
```
---
### Notes
Ensure your token_id is valid for the session. Tokens expire after a set period.
Always verify the data and status of API responses before processing.
For debugging, use Python's pdb or enable debug mode in API calls by setting debug="YES".
### License
This project is licensed under the MIT License. See the LICENSE file for details.
### Contact
For queries or issues, please contact: contact.tradehull@gmail.com.
Raw data
{
"_id": null,
"home_page": "https://github.com/TradeHull/Dhan_Tradehull",
"name": "Dhan-Tradehull",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "TradeHull",
"author_email": "contact.tradehull@gmail.com",
"download_url": null,
"platform": null,
"description": "# TradeHull Dhan Codebase Project\r\n\r\nThis project is built to interact with the **Dhan API** using the `Dhan_Tradehull` library. It provides a comprehensive suite of tools for trading, fetching market data, placing orders, and analyzing options.\r\n\r\n---\r\n\r\n## Features\r\n- **Fetch Market Data**: Get Live Trading Price (LTP), historical data, and intraday data.\r\n- **Order Placement**: Place, modify, or cancel orders with various parameters.\r\n- **Option Greeks**: Retrieve Greeks like Delta, Theta, Gamma, and Vega for options.\r\n- **Option Strike Selection**: Automate ATM, ITM, and OTM strike price identification.\r\n- **Portfolio Management**: Fetch holdings, positions, and balances.\r\n- **Option Chain**: Retrieve and analyze option chain data.\r\n- **Advanced Order Types**: Supports sliced orders, bracket orders, and stop-loss orders.\r\n\r\n---\r\n\r\n## Installation\r\n1. pip install Dhan-Tradehull\r\n\r\n2. Install required dependencies:\r\n\tpip install -r requirement.txt\r\n\r\n\r\n\r\n## Usage\r\n\r\n### Dhan API Authentication\r\nUpdate the client_code and token_id with your Dhan API credentials:\r\n\r\n```python\r\nfrom Dhan_Tradehull import Tradehull\r\n\r\nclient_code = \"your_client_code\"\r\ntoken_id = \"your_token_id\"\r\ntsl = Tradehull(client_code, token_id)\r\n\r\n```\r\n\r\n\r\n## Key Functionalities\r\n\r\n1. **Fetch Live Market Data**\r\n\r\n Get the latest trading price (LTP) or quote data:\r\n\r\n *Get LTP*\r\n\r\n - tsl.get_ltp_data(names: list or str, debug: str = \"NO\")\r\n\r\n - Arguments:\r\n - names (list or str): List of instrument names or a single instrument name to fetch the LTP.\r\n - debug (optional, str): Set to \"YES\" to enable detailed API response logging. Default is \"NO\".\r\n\r\n - Sample Code:\r\n ```python\r\n data = tsl.get_ltp_data(names=['CRUDEOIL', 'NIFTY'])\r\n crudeoil_ltp = data['CRUDEOIL']\r\n ```\r\n \r\n *Get Quotes*\r\n\r\n - tsl.get_quote_data(names: list or str, debug: str = \"NO\")\r\n\r\n - Arguments:\r\n - names (list or str): List of instrument names or a single instrument name to fetch the Quote data.\r\n - debug (optional, str): Set to \"YES\" to enable detailed API response logging. Default is \"NO\".\r\n\r\n - Sample Code:\r\n ```python\r\n data = tsl.get_quote_data(names=['CRUDEOIL', 'NIFTY'])\r\n crudeoil_quote_data = data['CRUDEOIL']\r\n ```\r\n \r\n *Get OHLC*\r\n\r\n - tsl.get_ohlc_data(names: list or str, debug: str = \"NO\")\r\n\r\n - Arguments:\r\n - names (list or str): List of instrument names or a single instrument name to fetch the OHLC data.\r\n - debug (optional, str): Set to \"YES\" to enable detailed API response logging. Default is \"NO\".\r\n\r\n - Sample Code:\r\n ```python\r\n data = tsl.get_ohlc_data(names=['CRUDEOIL', 'NIFTY'])\r\n crudeoil_ohlc_data = data['CRUDEOIL']\r\n ``` \r\n\r\n---\r\n\r\n2. **Fetch Historical Data**\r\n\r\n Retrieve historical or intraday data:\r\n\r\n *Get Historical Data*\r\n \r\n - tsl.get_historical_data(tradingsymbol: str, exchange: str, timeframe: str, debug: str = \"NO\")\r\n\r\n - Arguments:\r\n - tradingsymbol (str): The trading symbol for the instrument you want to fetch data for (e.g., 'NIFTY', 'ACC').\r\n - exchange (str): The exchange where the instrument is traded (e.g., 'NSE', 'INDEX').\r\n - timeframe (str): The timeframe for the data. It can be:\r\n - '1' for 1-minute candles\r\n - '5' for 5-minute candles\r\n - '15' for 15-minute candles\r\n - '25' for 25-minute candles\r\n - '60' for 60-minute candles\r\n - 'DAY' for daily candles\r\n - debug (optional, str): Set to \"YES\" to enable detailed API response logging. Default is \"NO\".\r\n \r\n - Sample Code:\r\n ```python\r\n data = tsl.get_historical_data(tradingsymbol='NIFTY', exchange='INDEX', timeframe=\"DAY\")\r\n data = tsl.get_historical_data(tradingsymbol='ACC', exchange='NSE', timeframe=\"1\")\r\n ```\r\n\r\n\r\n *Get Intraday Data*\r\n\r\n - tsl.get_intraday_data(tradingsymbol: str, exchange: str, timeframe: int, debug: str = \"NO\")\r\n \r\n - Arguments:\r\n - tradingsymbol (str): The trading symbol for the instrument you want to fetch data for (e.g., 'NIFTY', 'ACC').\r\n - exchange (str): The exchange where the instrument is traded (e.g., 'NSE', 'INDEX').\r\n - timeframe (int): The timeframe for the data in minutes. It can be:\r\n - 1 for 1-minute candles\r\n - 2 for 2-minute candles\r\n - 3 for 3-minute candles\r\n - 5 for 5-minute candles\r\n - 10 for 10-minute candles\r\n - 15 for 15-minute candles\r\n - 30 for 30-minute candles\r\n - 60 for 60-minute candles\r\n - debug (optional, str): Set to \"YES\" to enable detailed API response logging. Default is \"NO\".\r\n\r\n - Sample Code: \r\n ```python\r\n data = tsl.get_intraday_data(tradingsymbol='NIFTY', exchange='INDEX', timeframe=10)\r\n ```\r\n---\r\n\r\n\r\n3. **Option Strike Selection**\r\n\r\n ATM/ITM/OTM strike selection:\r\n\r\n *Get ATM Strikes*\r\n\r\n - tsl.ATM_Strike_Selection(Underlying: str, Expiry: int)\r\n\r\n - Arguments:\r\n - Underlying (str): The index or instrument name for which you want to find the ATM strike prices (e.g., 'NIFTY', 'BANKNIFTY').\r\n - Expiry (int): The expiry to select. \r\n - 0 - Current week/month (depending on expiry type)\r\n - 1 - Next week/month (depending on expiry type)\r\n - and so on for subsequent weeks/months.\r\n\r\n - Returns:\r\n - CE_symbol_name (str): The option symbol for the Call strike.\r\n - PE_symbol_name (str): The option symbol for the Put strike.\r\n - strike (int): The ATM strike price.\r\n\r\n - Sample Code: \r\n ```python \r\n CE_symbol_name, PE_symbol_name, strike_price = tsl.ATM_Strike_Selection(Underlying='NIFTY', Expiry=0)\r\n ```\r\n \r\n\r\n\r\n *Get OTM Strikes*\r\n\r\n - tsl.OTM_Strike_Selection(Underlying: str, Expiry: int, OTM_count: int)\r\n\r\n - Arguments:\r\n - Underlying (str): The index or instrument name for which you want to find the OTM strike prices (e.g., 'NIFTY', 'BANKNIFTY').\r\n - Expiry (int): The expiry to select. \r\n - 0 - Current week/month (depending on expiry type)\r\n - 1 - Next week/month (depending on expiry type)\r\n - and so on for subsequent weeks/months.\r\n - OTM_count (int): The number of steps to move away from the ATM strike to find the OTM strike prices (e.g., 5 means 5 steps away).\r\n\r\n - Returns:\r\n - CE_symbol_name (str): The option symbol for the OTM Call strike.\r\n - PE_symbol_name (str): The option symbol for the OTM Put strike.\r\n - CE_OTM_price (int): The OTM Call strike price.\r\n - PE_OTM_price (int): The OTM Put strike price.\r\n\r\n - Sample Code: \r\n ```python \r\n CE_symbol_name, PE_symbol_name, CE_OTM_price, PE_OTM_price = tsl.OTM_Strike_Selection(Underlying='NIFTY', Expiry=0, OTM_count=5)\r\n ``` \r\n\r\n \r\n\r\n *Get ITM Strikes*\r\n\r\n - tsl.ITM_Strike_Selection(Underlying: str, Expiry: int, ITM_count: int)\r\n\r\n - Arguments:\r\n - Underlying (str): The index or instrument name for which you want to find the ITM strike prices (e.g., 'NIFTY', 'BANKNIFTY').\r\n - Expiry (int): The expiry to select.\r\n - 0 - Current week/month (depending on expiry type)\r\n - 1 - Next week/month (depending on expiry type)\r\n - and so on for subsequent weeks/months.\r\n - ITM_count (int): The number of steps to move away from the ATM strike to find the ITM strike prices (e.g., 1 means 1 step closer to the underlying price).\r\n \r\n - Returns:\r\n - CE_symbol_name (str): The option symbol for the ITM Call strike.\r\n - PE_symbol_name (str): The option symbol for the ITM Put strike.\r\n - CE_ITM_price (int): The ITM Call strike price.\r\n - PE_ITM_price (int): The ITM Put strike price.\r\n \r\n - Sample Code: \r\n ```python \r\n CE_symbol_name, PE_symbol_name, CE_ITM_price, PE_ITM_price = tsl.ITM_Strike_Selection(Underlying='NIFTY', Expiry=0, ITM_count=1)\r\n ``` \r\n\r\n---\r\n\r\n\r\n\r\n4. **Option Greeks**\r\n\r\n Fetch Greeks for a specific option:\r\n\r\n *Get Option Greek*\r\n\r\n - tsl.get_option_greek(strike: int, expiry: int, asset: str, interest_rate: float, flag: str, scrip_type: str)\r\n\r\n - Arguments:\r\n - strike (int): The strike price of the option.\r\n - expiry (int): The expiry to select. \r\n - 0 - Current week/month (depending on expiry type).\r\n - 1 - Next week/month (depending on expiry type).\r\n - and so on for subsequent weeks/months.\r\n - asset (str): The underlying asset for the option (e.g., 'NIFTY').\r\n - interest_rate (float): The interest rate to be used in calculations (e.g., 10).\r\n - flag (str): The Greek value to fetch.\r\n - 'price' - Option price.\r\n - 'delta' - Delta value.\r\n - 'delta2' - Second-order delta.\r\n - 'theta' - Theta value.\r\n - 'rho' - Rho value.\r\n - 'vega' - Vega value.\r\n - 'gamma' - Gamma value.\r\n - 'all_val' - All Greeks values in a dictionary.\r\n - scrip_type (str): The option type ('CE' for Call options, 'PE' for Put options).\r\n\r\n - Returns:\r\n - Depending on the flag, it returns the requested Greek value or all Greek values in a dictionary.\r\n\r\n - Sample Code: \r\n ```python \r\n all_values = tsl.get_option_greek(strike=24400, expiry=0, asset='NIFTY', interest_rate=10, flag='all_val', scrip_type='CE')\r\n ``` \r\n\r\n---\r\n\r\n\r\n\r\n5. **Order Placement and Management**\r\n\r\n Place, modify, or cancel orders:\r\n\r\n *Get Order Placement*\r\n\r\n - tsl.order_placement(tradingsymbol: str, exchange: str, quantity: int, price: int, trigger_price: int, \r\n order_type: str, transaction_type: str, trade_type: str, disclosed_quantity=0, after_market_order=False, \r\n validity='DAY', amo_time='OPEN', bo_profit_value=None, bo_stop_loss_value=None) -> str\r\n - Arguments:\r\n - tradingsymbol (str): The trading symbol (e.g., 'NIFTY 21 NOV 23300 CALL').\r\n - exchange (str): The exchange (e.g., 'NFO', 'MCX', 'NSE').\r\n - quantity (int): The number of contracts to buy/sell.\r\n - price (int): The price at which to place the order.\r\n - trigger_price (int): The trigger price for stop orders.\r\n - order_type (str): Type of order ('MARKET', 'LIMIT', 'STOPLIMIT', 'STOPMARKET').\r\n - transaction_type (str): Type of transaction ('BUY' or 'SELL').\r\n - trade_type (str): Type of trade ('MIS', 'MARGIN', 'MTF', 'CO', 'BO', 'CNC').\r\n - disclosed_quantity (int, optional): Quantity disclosed to the market (default is 0).\r\n - after_market_order (bool, optional): Whether it is an after-market order (default is False).\r\n - validity (str, optional): Validity of the order ('DAY', 'IOC').\r\n - amo_time (str, optional): AMO time ('PRE_OPEN', 'OPEN', 'OPEN_30', 'OPEN_60') if after-market order.\r\n - bo_profit_value (float, optional): Profit value for BO orders (default is None).\r\n - bo_stop_loss_value (float, optional): Stop loss value for BO orders (default is None).\r\n - Returns:\r\n - str: The order ID if the order is placed successfully, or None if there was an error.\r\n\r\n - Sample Orders:\r\n ```python \r\n orderid1 = tsl.order_placement('NIFTY 21 NOV 24400 CALL','NFO',25, 0.05, 0, 'LIMIT', 'BUY', 'MIS')\r\n print(orderid1)\r\n orderid2 = tsl.order_placement('YESBANK','NSE', 1, 0, 0, 'MARKET', 'BUY', 'MIS')\r\n print(orderid2)\r\n\r\n orderid = tsl.order_placement('SENSEX 06 SEP 81900 PUT','BFO',10, 0, 0, 'MARKET', 'BUY', 'MIS')\r\n orderid = tsl.order_placement('ACC','NSE', 1, 0, 0, 'MARKET', 'BUY', 'MIS')\r\n orderid = tsl.order_placement('CRUEDOIL DEC FUT','MCX', 1, 4567, 0, 'LIMIT', 'BUY', 'CNC')\r\n orderid = tsl.order_placement('ACC','NSE', 1, 2674, 2670, 'STOPLIMIT', 'BUY', 'MIS')\r\n orderid = tsl.order_placement('ACC','NSE', 1, 0, 2670, 'STOPMARKET', 'BUY', 'MIS')\r\n ```\r\n\r\n - Sample Code:\r\n ```python \r\n orderid = tsl.order_placement(tradingsymbol='NIFTY 19 DEC 23300 CALL', exchange='NFO', quantity=25, price=0.05, trigger_price=0,order_type='LIMIT', transaction_type='BUY', trade_type='MIS')\r\n ```\r\n\r\n\r\n\r\n *Get Order Modification*\r\n\r\n - tsl.modify_order(order_id, order_type, quantity, price=0, trigger_price=0, disclosed_quantity=0, validity='DAY', leg_name=None) -> str\r\n\r\n - Arguments:\r\n - order_id (str): The unique ID of the order to be modified.\r\n - order_type (str): Type of the order. Options include:\r\n - 'LIMIT': Limit order.\r\n - 'MARKET': Market order.\r\n - 'STOPLIMIT': Stop-loss limit order.\r\n - 'STOPMARKET': Stop-loss market order.\r\n - quantity (int): The updated quantity for the order.\r\n - price (float, optional): The updated price for the order (default is 0).\r\n - trigger_price (float, optional): The updated trigger price for the order (default is 0).\r\n - disclosed_quantity (int, optional): The quantity to disclose (default is 0).\r\n - validity (str, optional): Validity of the order. Options are:\r\n - 'DAY': Order remains valid for the trading day (default).\r\n - 'IOC': Immediate or cancel.\r\n - leg_name (str, optional): The specific leg to modify (used for bracket/CO orders). Options are:\r\n - 'ENTRY_LEG': Entry leg of the order.\r\n - 'TARGET_LEG': Target leg of the order.\r\n - 'STOP_LOSS_LEG': Stop-loss leg of the order.\r\n - If not applicable, leave as None.\r\n\r\n - Returns:\r\n - str: The modified order ID if the modification is successful.\r\n - Raises an exception if the modification fails.\r\n\r\n - Sample Code:\r\n ```python \r\n orderid = '12241210603927'\r\n modified_order_id = tsl.modify_order(order_id=orderid,order_type=\"LIMIT\",quantity=50,price=0.1,trigger_price=0)\r\n ```\r\n\r\n\r\n\r\n *Get Order Cancelation*\r\n\r\n - tsl.cancel_order(OrderID: str) -> None\r\n\r\n - Arguments:\r\n - OrderID (str): The unique ID of the order to be canceled.\r\n\r\n - Returns:\r\n - str: The status of the canceled order if successful (e.g., \"Cancelled\").\r\n - Raises an exception if the cancellation fails.\r\n\r\n - Sample Code:\r\n ```python \r\n orderid = '12241210603927'\r\n order_status = tsl.cancel_order(OrderID=orderid)\r\n ```\r\n\r\n\r\n\r\n *Get All Intraday Order Cancelation and Intraday Position Close*\r\n \r\n - To cancell all the intraday open and trigger pending orders, square off all the positions \r\n \r\n - tsl.cancel_all_orders()\r\n\r\n - Sample Code:\r\n ```python \r\n order_details = tsl.cancel_all_orders()\r\n ``` \r\n\r\n\r\n\r\n *Get Place Order Sliced*\r\n\r\n - tsl.place_slice_order(tradingsymbol: str, exchange: str, transaction_type: str, quantity: int, order_type: str, trade_type: str, price: float, trigger_price: float = 0, disclosed_quantity: int = 0, after_market_order: bool = False, validity: str = 'DAY', amo_time: str = 'OPEN', bo_profit_value: float = None, bo_stop_loss_Value: float = None ) -> str | list\r\n\r\n - Arguments:\r\n - tradingsymbol (str): The symbol for the instrument to trade.\r\n - exchange (str): The exchange where the order is placed (e.g., NSE, NFO, MCX).\r\n - transaction_type (str): \"BUY\" or \"SELL\".\r\n - quantity (int): Total quantity to be ordered.\r\n - order_type (str): Type of order (\"LIMIT\", \"MARKET\", \"STOPLIMIT\", \"STOPMARKET\").\r\n - trade_type (str): Type of trade (\"MIS\", \"CNC\", \"CO\", \"BO\", etc.).\r\n - price (float): Price for the order (used for LIMIT orders).\r\n - trigger_price (float): Trigger price for stop-loss orders (default is 0).\r\n - disclosed_quantity (int): Quantity to disclose (default is 0).\r\n - after_market_order (bool): If true, places the order as an after-market order.\r\n - validity (str): Validity of the order (\"DAY\", \"IOC\").\r\n - amo_time (str): Timing for after-market orders (\"PRE_OPEN\", \"OPEN\", etc.).\r\n - bo_profit_value (float): Profit target value for bracket orders (default is None).\r\n - bo_stop_loss_Value (float): Stop-loss value for bracket orders (default is None).\r\n\r\n - Returns:\r\n - str: A single order ID if the order is not sliced.\r\n - list: A list of order IDs if the order involves multiple slices.\r\n - None: Returns None if an exception occurs.\r\n\r\n\r\n - Sample Code:\r\n ```python \r\n order_ids = tsl.place_slice_order(tradingsymbol=\"NIFTY 19 DEC 18000 CALL\",exchange=\"NFO\",transaction_type=\"BUY\",quantity=1875,order_type=\"LIMIT\",trade_type=\"MIS\",price=0.05)\r\n ```\r\n \r\n\r\n\r\n *Get Order Details*\r\n\r\n - Get detailed information about a specific order\r\n\r\n - tsl.get_order_detail(orderid:str)\r\n\r\n - Arguments:\r\n - orderid: The unique identifier of the order.\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n\r\n - Returns:\r\n - Dictionary containing details of the order, such as price, quantity, status, etc.\r\n\r\n\r\n - Sample Code:\r\n ```python\r\n orderid = '12241210603927' \r\n order_details = tsl.get_order_detail(orderid=orderid)\r\n ```\r\n\r\n\r\n*Get Order Status* \r\n\r\n - Get the current status of a specific order\r\n\r\n - tsl.get_order_status(orderid:str)\r\n \r\n - Arguments:\r\n - orderid: The unique identifier of the order.\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n\r\n - Returns:\r\n - String representing the status of the order (e.g., 'Pending', 'Completed').\r\n\r\n - Sample Code:\r\n ```python\r\n orderid = '12241210603927' \r\n order_status = tsl.get_order_status(orderid=orderid) \r\n ```\r\n\r\n\r\n\r\n *Get Order Executed Price* \r\n\r\n - Get the average traded price of an executed order\r\n\r\n - tsl.get_executed_price(orderid:str)\r\n\r\n - Arguments:\r\n - orderid: The unique identifier of the order.\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n\r\n - Returns:\r\n - Integer representing the average price at which the order was executed.\r\n\r\n - Sample Code:\r\n ```python\r\n orderid = '12241210603927' \r\n order_price = tsl.get_executed_price(orderid=orderid)\r\n ```\r\n\r\n\r\n\r\n *Get Order Exchange Time* \r\n\r\n - Get the exchange timestamp for a specific order\r\n \r\n - order_time = tsl.get_exchange_time(orderid=orderid)\r\n \r\n - Arguments:\r\n - orderid: The unique identifier of the order.\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n - Returns:\r\n - String with the timestamp of the order execution as recorded by the exchange.\r\n\r\n - Sample Code:\r\n ```python\r\n orderid = '12241210603927' \r\n order_time = tsl.get_exchange_time(orderid=orderid)\r\n ```\r\n\r\n---\r\n\r\n\r\n6. **Portfolio Management**\r\n\r\n Fetch holdings, positions, and balances:\r\n\r\n *Get Holdings*\r\n\r\n - Fetch current holdings\r\n \r\n - tsl.get_holdings(debug=\"NO\") \r\n\r\n - Arguments:\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n \r\n - Returns:\r\n - pd.DataFrame: A DataFrame containing the list of holdings, including details like symbol, quantity, and average price.\r\n - In case of an error, returns a dictionary with 'status' as 'failure', error message, and data.\r\n\r\n - Sample Code:\r\n ```python \r\n holdings = tsl.get_holdings()\r\n ```\r\n\r\n\r\n\r\n *Get Positions*\r\n\r\n - Fetch current open positions\r\n\r\n - tsl.get_positions(debug=\"NO\")\r\n - Arguments:\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n\r\n - Returns:\r\n - pd.DataFrame: A DataFrame containing the list of open positions with details like symbol, quantity, average price, etc.\r\n - In case of an error, returns a dictionary with 'status' as 'failure', error message, and data.\r\n\r\n - Sample Code:\r\n ```python \r\n positions = tsl.get_positions()\r\n ```\r\n\r\n\r\n\r\n *Get Orderbook*\r\n \r\n - Fetch the order book\r\n\r\n - tsl.get_orderbook(debug=\"NO\")\r\n \r\n - Arguments:\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n\r\n - Returns:\r\n - pd.DataFrame: A DataFrame containing the list of all orders placed, including details such as symbol, quantity, status, and price.\r\n - In case of an error, returns a dictionary with 'status' as 'failure', error message, and data.\r\n\r\n - Sample Code:\r\n ```python \r\n orderbook = tsl.get_orderbook()\r\n ``` \r\n\r\n\r\n\r\n *Get Tradebook*\r\n\r\n - Fetch the trade book\r\n\r\n - tsl.get_trade_book(debug=\"NO\")\r\n\r\n - Arguments:\r\n - debug (str, optional): Set to \"YES\" to print debug information (default is \"NO\").\r\n\r\n - Returns:\r\n - pd.DataFrame: A DataFrame containing the list of all completed trades with details such as symbol, quantity, price, and trade time.\r\n - In case of an error, returns a dictionary with 'status' as 'failure', error message, and data. \r\n\r\n - Sample Code:\r\n ```python \r\n tradebook = tsl.get_trade_book()\r\n ``` \r\n\r\n\r\n\r\n *Get Balance*\r\n \r\n - To get the available balance from the Dhan API client\r\n \r\n - tsl.get_balance()\r\n \r\n - Sample Code:\r\n ```python \r\n available_balance = tsl.get_balance()\r\n ``` \r\n\r\n\r\n\r\n *Get Live PNL*\r\n\r\n - To get the live PNL of current positions\r\n \r\n - tsl.get_live_pnl()\r\n \r\n - Sample Code:\r\n ```python \r\n PNL = tsl.get_live_pnl()\r\n ``` \r\n\r\n\r\n\r\n *Get Lot Size*\r\n\r\n - To get the lot size for the futures and options\r\n \r\n - tsl.get_lot_size(Tradingsymbol: str)\r\n \r\n - Sample Code:\r\n ```python \r\n lot_size = tsl.get_lot_size(tradingsymbol = 'NIFTY 19 DEC 24400 CALL')\r\n ``` \r\n\r\n\r\n\r\n *Get Margin for Tradingsymbol*\r\n\r\n - To get the margin for the stocks, futures and options\r\n \r\n - tsl.margin_calculator(tradingsymbol: str, exchange: str, transaction_type: str, quantity: int, trade_type: str, price: float, trigger_price:float)\r\n \r\n - Sample Code:\r\n ```python \r\n Margin = tsl.margin_calculator(tradingsymbol='NIFTY DEC FUT', exchange='NFO', transaction_type='BUY', quantity=25, trade_type='MARGIN', price=24350, trigger_price=0)\r\n ``` \r\n\r\n---\r\n\r\n\r\n\r\n7. **Option Chain Analysis**\r\n\r\n Retrieve and analyze the option chain:\r\n\r\n *Get Option Chain*\r\n\r\n - tsl.get_option_chain(Underlying: str, exchange: str, expiry: int) -> pd.DataFrame | None\r\n\r\n - Arguments:\r\n - Underlying (str): The symbol of the underlying asset (e.g., \"NIFTY\", \"BANKNIFTY\", \"RELIANCE\").\r\n - exchange (str): The exchange where the options are traded (e.g., \"NSE\", \"NFO\", \"MCX\").\r\n - expiry (int): Index of the expiry date in the list of available expiry dates (0 for the nearest expiry).\r\n\r\n - Returns:\r\n - pd.DataFrame: A formatted DataFrame containing the option chain data with details like strike price, call/put LTP, OI, volume, etc.\r\n - None: Returns None if there is an error or no expiry data is found.\r\n\r\n - Sample Code: \r\n ```python \r\n option_chain = tsl.get_option_chain(Underlying=\"NIFTY\", exchange=\"INDEX\", expiry=0)\r\n ``` \r\n\r\n---\r\n\r\n\r\n8. **Alerts via Telegram**\r\n\r\n send a Alerts via Telegram\r\n\r\n *Send Telegram Alerts*\r\n\r\n - tsl.send_telegram_alert(message: str,receiver_chat_id: str,bot_token: str) -> None\r\n\r\n - Arguments:\r\n - message (str): The text message to send. Supports basic text formatting.\r\n - receiver_chat_id (str): The unique chat ID of the Telegram user or group. \r\n - For individual users: Use their chat ID.\r\n - For groups: Use the group\u00e2\u20ac\u2122s chat ID (ensure the bot is added to the group).\r\n - bot_token (str): The authorization token of the Telegram bot. \r\n - Obtainable when creating a bot via the Telegram BotFather.\r\n\r\n - Returns:\r\n - None: The function prints a success or failure message in the console. \r\n\r\n - Sample Code: \r\n ```python \r\n tsl.send_telegram_alert(message=\"Order executed: BUY 50 shares of RELIANCE\",receiver_chat_id=\"123456789\",bot_token=\"123456789:ABCDEFGHIJKLMNOPQRSTUVWXYZ\")\r\n ``` \r\n\r\n---\r\n\r\n\r\n### Notes\r\nEnsure your token_id is valid for the session. Tokens expire after a set period.\r\nAlways verify the data and status of API responses before processing.\r\nFor debugging, use Python's pdb or enable debug mode in API calls by setting debug=\"YES\".\r\n\r\n\r\n### License\r\nThis project is licensed under the MIT License. See the LICENSE file for details.\r\n\r\n### Contact\r\nFor queries or issues, please contact: contact.tradehull@gmail.com.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A Dhan Codebase from TradeHull",
"version": "3.0.5",
"project_urls": {
"Homepage": "https://github.com/TradeHull/Dhan_Tradehull"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e8a941b1b72e67f0e4072d426d0d722024b918eb18d677892b6d9369b2d51a23",
"md5": "9437d22db9cc406ab4b34f6502a63a41",
"sha256": "346da7ad644265d0c46ddf54b472d09bd191e711d6328c3006eb764273b6d551"
},
"downloads": -1,
"filename": "Dhan_Tradehull-3.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9437d22db9cc406ab4b34f6502a63a41",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 22023,
"upload_time": "2025-01-09T10:21:32",
"upload_time_iso_8601": "2025-01-09T10:21:32.980075Z",
"url": "https://files.pythonhosted.org/packages/e8/a9/41b1b72e67f0e4072d426d0d722024b918eb18d677892b6d9369b2d51a23/Dhan_Tradehull-3.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-09 10:21:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TradeHull",
"github_project": "Dhan_Tradehull",
"github_not_found": true,
"lcname": "dhan-tradehull"
}
JSON
