brokerpackage 0.1__tar.gz

brokerpackage-0.1/BrokerPackage/BrokerPackage.py

@@ -0,0 +1,257 @@
+
+import pandas as pd
+import requests
+from typing import Tuple, Union
+import numpy as np
+
+class BrokerPackage:
+    def __init__(self, username:str) -> None:
+        self.default_url = 'http://broker-api-service:7777/'
+        self.file = {}
+        self.get_file()
+
+        if 'primary_url' in self.file.keys():
+            self.primary_url = self.file['primary_url']
+        else: self.primary_url = self.default_url
+
+        if 'secondary_url' in self.file.keys():
+            self.secondary_url = self.file['secondary_url']
+        else: self.secondary_url = self.default_url
+
+        self.quotetickcandle_url = 'http://quotetickcandle-secvice:7777/quotedata'
+        self.username = username
+
+    def get_file(self) -> None:
+        data_inp = {'username': self.username}
+        res = requests.post(self.default_url + 'get_file', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        self.file = res_json['file']
+
+    def login(self) -> None:
+        data_inp = {'file': self.file}
+        res = requests.post(self.primary_url + 'login', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+
+    def get_token(self, name:str, exchange:str = 'NSE', expiry:str = '', strike:str = '', optionType:str = '') -> str:
+        data_inp = {'username': self.username,
+                    'name': name,
+                    'exchange': exchange,
+                    'expiry': expiry,
+                    'strike': strike,
+                    'optionType': optionType
+                    }
+        try:
+            res = requests.post(self.primary_url + 'get_token', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'get_token', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['token']
+
+    def get_name(self, token:str) -> Tuple[str, str, str, str, str]:
+        data_inp = {'username': self.username,
+                    'token': token
+                    }
+        try:
+            res = requests.post(self.primary_url + 'get_name', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'get_name', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['data']['name'], res_json['data']['expiry'], res_json['data']['strike'], res_json['data']['optionType'], res_json['data']['lots']
+
+    def orders(self) -> pd.DataFrame:
+        data_inp = {'username': self.username}
+        try:
+            res = requests.post(self.primary_url + 'orders', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'orders', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return pd.DataFrame.from_dict(res_json['data'])
+
+    def order_update_time(self) -> Union[int, str]:
+        data_inp = {'username': self.username}
+        try:
+            res = requests.post(self.primary_url + 'order_update_time', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'order_update_time', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['order_update_time']
+
+    def positions(self) -> pd.DataFrame:
+        data_inp = {'username': self.username}
+        try:
+            res = requests.post(self.primary_url + 'positions', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'positions', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return pd.DataFrame.from_dict(res_json['data'])
+
+    def position_update_time(self) -> Union[int, str]:
+        data_inp = {'username': self.username}
+        try:
+            res = requests.post(self.primary_url + 'position_update_time', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'position_update_time', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['position_update_time']
+
+    def portfolio(self) -> pd.DataFrame:
+        data_inp = {'username': self.username}
+        try:
+            res = requests.post(self.primary_url + 'portfolio', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'portfolio', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return pd.DataFrame.from_dict(res_json['data'])
+
+    def get_available_cash(self) -> float:
+        data_inp = {'username': self.username}
+        try:
+            res = requests.post(self.primary_url + 'get_available_cash', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'get_available_cash', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['available_cash']
+
+    def get_required_margin(self, transaction_type:str = '', token:str = '', price_:float = 0, product:str = '') -> float:
+        data_inp = {'username': self.username,
+                    'transaction_type': transaction_type,
+                    'token': token,
+                    'price_': price_,
+                    'product': product
+                    }
+        try:
+            res = requests.post(self.primary_url + 'get_required_margin', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'get_required_margin', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['required_margin']
+
+    def get_quote(self, token:str = '', name:str = '', exchange:str = 'NSE', expiry:str = '', strike:str = '', optionType:str = '') -> pd.DataFrame:
+        data_inp = {'username': self.username,
+                    'token': token,
+                    'name': name,
+                    'exchange': exchange,
+                    'expiry': expiry,
+                    'strike': strike,
+                    'optionType': optionType
+                    }
+        try:
+            res = requests.post(self.primary_url + 'get_quote', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'get_quote', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return pd.DataFrame.from_dict(res_json['data'])
+
+    def place_order(self, transaction_type:str, price_:float, quantity:int, token:str = '', name:str = '', exchange:str = 'NSE', expiry:str = '', strike:str = '', optionType:str = '',  trigger:float = 0, product:str = '') -> str:
+        data_inp = {'username': self.username,
+                    'transaction_type': transaction_type,
+                    'price_': price_,
+                    'quantity': quantity,
+                    'token': token,
+                    'name': name,
+                    'exchange': exchange,
+                    'expiry': expiry,
+                    'strike': strike,
+                    'optionType': optionType,
+                    'trigger': trigger,
+                    'product': product
+                    }
+        try:
+            res = requests.post(self.primary_url + 'place_order', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'place_order', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['orderid']
+
+    def modify_order(self, order_id:str,  price:float, quantity:Union[int, str] = '', trigger:float = 0) -> str:
+        data_inp = {'username': self.username,
+                    'order_id': order_id,
+                    'price': price,
+                    'quantity': quantity,
+                    'trigger': trigger
+                    }
+        try:
+            res = requests.post(self.primary_url + 'modify_order', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'modify_order', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['orderid']
+
+    def cancel_order(self, order_id:str) -> str:
+        data_inp = {'username': self.username,
+                    'order_id': order_id
+                    }
+        try:
+            res = requests.post(self.primary_url + 'cancel_order', json = data_inp)
+        except:
+            res = requests.post(self.secondary_url + 'cancel_order', json = data_inp)
+        res_json = res.json()
+        if res_json['error'] != '': raise Exception(res_json['error'])
+        return res_json['orderid']
+
+    def get_quote_local(self, name = '', exchange = 'NSE', expiry = '', strike = '', optionType = ''):
+        data_inp = {'name': name,
+                'exchange': exchange,
+                'expiry': expiry,
+                'strike': str(strike),
+                'optionType': optionType,            
+                }
+        try:
+            res = requests.post(self.quotetickcandle_url, json = data_inp)
+            df = pd.json_normalize(res.json())
+            if df.ltp.iloc[0] == '': raise Exception("Unable to get quote from quotes api")
+            else: return df
+        except Exception as e:
+            raise Exception("Unable to get quote from quotes api")
+
+    def get_quote_api(self, name = '', exchange = 'NSE', expiry = '', strike = '', optionType = ''):
+        try:
+            df = self.get_quote_local(name, exchange, expiry, strike, optionType)
+            return df
+        except Exception as e:
+            return self.get_quote(name=name, exchange=exchange, expiry=expiry, strike=strike, optionType=optionType)
+
+    def get_ltp(self, name='', exchange='NSE', expiry='', strike='', optionType=''):
+        return self.round_to(self.get_quote_api(name=name, exchange=exchange, expiry=expiry, strike=strike, optionType=optionType).iloc[0]['ltp'])
+
+    def round_to(self, row, num_column = 'open', precision_column_val=.05):
+        ''' Round given number to nearsest tick size which is .05 in FNO
+            Source: https://stackoverflow.com/questions/4265546/python-round-to-nearest-05
+
+            Parameters
+            ----------
+                row: int/float/Series - 12569.67 or Series with columns __ num_column, optional __ precision_column_val
+                num_column: str - 'date' Column name to round
+                precision_column_val: float, int, str 100, 2.5 or 'roundvalue' tick_size of the item or  Column name contaning tick_size
+
+        '''
+        if type(row) in [int, float, np.float64, np.float32, np.float16, np.int8, np.int16, np.int32, np.int64, str]:
+            n = row
+        else:
+            n = row[num_column]
+
+        if type(precision_column_val)==str:
+            if type(row) == int or type(row) == float:
+                precision = .05
+            else:
+                precision = row[precision_column_val]
+        else:
+            precision = precision_column_val
+
+        n = float(n)
+        correction = 0.5 if n >= 0 else -0.5
+        return round(int( n/precision+correction ) * precision, 2)

brokerpackage-0.1/BrokerPackage/__init__.py

@@ -0,0 +1,2 @@
+from .BrokerPackage import BrokerPackage
+from .version import __version__

brokerpackage-0.1/BrokerPackage/version.py

@@ -0,0 +1 @@
+__version__ = '0.1'

brokerpackage-0.1/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

brokerpackage-0.1/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.1
+Name: brokerpackage
+Version: 0.1
+Summary: Package is a Python client library designed to interact with a broker API service. It provides functionalities to manage and execute trading strategies, handle orders, and retrieve market data.
+Home-page: UNKNOWN
+Author: Vadlamani Rampratap Sharma
+Author-email: rampratap.optalpha@gmail.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# 📦 BrokerPackage
+
+`BrokerPackage` is a Python client library designed to interact with a broker API service. It provides a structured interface to perform trading operations such as login, fetching quotes, placing orders, managing positions, and more.
+
+---
+
+## 🚀 Features
+
+* 🔐 Login & session handling
+* 📊 Fetch market quotes (API + local fallback)
+* 📈 View orders, positions, and portfolio
+* 💰 Check available cash & margin requirements
+* 🛒 Place, modify, and cancel orders
+* 🔄 Automatic failover (primary → secondary server)
+* 🎯 Token-based instrument identification
+* ⚡ Tick-size rounding utility for F&O (.05 precision)
+
+---
+
+This script requires the following libraries:
+
+- openpyxl==3.1.2
+- pandas==1.5.3
+- numpy==1.23.5
+
+## 📦 Installation
+
+```bash
+pip install openpyxl==3.1.2 pandas==1.5.3 numpy==1.23.5 
+```
+
+---
+
+## 🧑‍💻 Usage
+
+### 1. Initialize
+
+```python
+from BrokerPackage import BrokerPackage
+
+broker = BrokerPackage(username="your_username")
+```
+
+---
+
+### 2. Login
+
+```python
+broker.login()
+```
+
+---
+
+### 3. Get Token
+
+```python
+token = broker.get_token(name="RELIANCE")
+```
+
+---
+
+### 4. Get Quote
+
+```python
+quote_df = broker.get_quote(name="RELIANCE")
+print(quote_df)
+```
+
+---
+
+### 5. Get LTP (Last Traded Price)
+
+```python
+ltp = broker.get_ltp(name="RELIANCE")
+print(ltp)
+```
+
+---
+
+### 6. Place Order
+
+```python
+order_id = broker.place_order(
+    transaction_type="BUY",
+    price_=2500,
+    quantity=10,
+    name="RELIANCE"
+)
+print(order_id)
+```
+
+---
+
+### 7. Modify Order
+
+```python
+broker.modify_order(order_id="12345", price=2550, quantity=10)
+```
+
+---
+
+### 8. Cancel Order
+
+```python
+broker.cancel_order(order_id="12345")
+```
+
+---
+
+### 9. View Orders / Positions / Portfolio
+
+```python
+orders = broker.orders()
+positions = broker.positions()
+portfolio = broker.portfolio()
+```
+
+---
+
+### 10. Account Info
+
+```python
+cash = broker.get_available_cash()
+margin = broker.get_required_margin(
+    transaction_type="BUY",
+    token=token,
+    price_=2500,
+    product="MIS"
+)
+```
+
+---
+
+## 🔄 Failover Mechanism
+
+All API calls:
+
+* Try **Primary URL**
+* On failure → fallback to **Secondary URL**
+
+---
+
+## 🌐 API Endpoints Used
+
+| Endpoint               | Description              |
+| ---------------------- | ------------------------ |
+| `/get_file`            | Fetch user configuration |
+| `/login`               | Login using config       |
+| `/get_token`           | Get instrument token     |
+| `/get_quote`           | Fetch market data        |
+| `/place_order`         | Place trade              |
+| `/modify_order`        | Modify trade             |
+| `/cancel_order`        | Cancel trade             |
+| `/orders`              | Get order book           |
+| `/positions`           | Get positions            |
+| `/portfolio`           | Get holdings             |
+| `/get_available_cash`  | Cash balance             |
+| `/get_required_margin` | Margin calculation       |
+
+---
+
+## 📊 Local Quote Fallback
+
+Method: `get_quote_api()`
+
+Flow:
+
+1. Try local service (`quotetickcandle-secvice`)
+2. If failed → fallback to broker API
+
+---
+
+## 🎯 Tick Size Rounding
+
+Utility method:
+
+```python
+broker.round_to(12569.67)
+```
+
+* Default precision: **0.05 (F&O tick size)**
+* Supports dynamic precision via column or value
+
+---
+
+## ⚠️ Error Handling
+
+* All API responses checked for `"error"`
+* Raises `Exception` if any issue occurs
+* Network failures auto-switch to secondary server
+
+---
+
+## 🧩 Dependencies
+
+* `pandas`
+* `requests`
+* `numpy`
+* `typing`
+
+---
+
+## 📝 Notes
+
+* Ensure API services are running:
+
+  * `broker-api-service`
+  * `quotetickcandle-secvice`
+* URLs can be overridden via config file (`get_file` response)
+
+---
+
+## 📌 Example Workflow
+
+```python
+broker = BrokerPackage("user1")
+broker.login()
+
+token = broker.get_token("NIFTY")
+ltp = broker.get_ltp(name="NIFTY")
+
+order_id = broker.place_order(
+    transaction_type="BUY",
+    price_=ltp,
+    quantity=50,
+    name="NIFTY"
+)
+```
+
+---
+
+## 📄 License
+
+This project is intended for internal/private trading system usage.
+
+---
+

brokerpackage-0.1/README.md

@@ -0,0 +1,236 @@
+# 📦 BrokerPackage
+
+`BrokerPackage` is a Python client library designed to interact with a broker API service. It provides a structured interface to perform trading operations such as login, fetching quotes, placing orders, managing positions, and more.
+
+---
+
+## 🚀 Features
+
+* 🔐 Login & session handling
+* 📊 Fetch market quotes (API + local fallback)
+* 📈 View orders, positions, and portfolio
+* 💰 Check available cash & margin requirements
+* 🛒 Place, modify, and cancel orders
+* 🔄 Automatic failover (primary → secondary server)
+* 🎯 Token-based instrument identification
+* ⚡ Tick-size rounding utility for F&O (.05 precision)
+
+---
+
+This script requires the following libraries:
+
+- openpyxl==3.1.2
+- pandas==1.5.3
+- numpy==1.23.5
+
+## 📦 Installation
+
+```bash
+pip install openpyxl==3.1.2 pandas==1.5.3 numpy==1.23.5 
+```
+
+---
+
+## 🧑‍💻 Usage
+
+### 1. Initialize
+
+```python
+from BrokerPackage import BrokerPackage
+
+broker = BrokerPackage(username="your_username")
+```
+
+---
+
+### 2. Login
+
+```python
+broker.login()
+```
+
+---
+
+### 3. Get Token
+
+```python
+token = broker.get_token(name="RELIANCE")
+```
+
+---
+
+### 4. Get Quote
+
+```python
+quote_df = broker.get_quote(name="RELIANCE")
+print(quote_df)
+```
+
+---
+
+### 5. Get LTP (Last Traded Price)
+
+```python
+ltp = broker.get_ltp(name="RELIANCE")
+print(ltp)
+```
+
+---
+
+### 6. Place Order
+
+```python
+order_id = broker.place_order(
+    transaction_type="BUY",
+    price_=2500,
+    quantity=10,
+    name="RELIANCE"
+)
+print(order_id)
+```
+
+---
+
+### 7. Modify Order
+
+```python
+broker.modify_order(order_id="12345", price=2550, quantity=10)
+```
+
+---
+
+### 8. Cancel Order
+
+```python
+broker.cancel_order(order_id="12345")
+```
+
+---
+
+### 9. View Orders / Positions / Portfolio
+
+```python
+orders = broker.orders()
+positions = broker.positions()
+portfolio = broker.portfolio()
+```
+
+---
+
+### 10. Account Info
+
+```python
+cash = broker.get_available_cash()
+margin = broker.get_required_margin(
+    transaction_type="BUY",
+    token=token,
+    price_=2500,
+    product="MIS"
+)
+```
+
+---
+
+## 🔄 Failover Mechanism
+
+All API calls:
+
+* Try **Primary URL**
+* On failure → fallback to **Secondary URL**
+
+---
+
+## 🌐 API Endpoints Used
+
+| Endpoint               | Description              |
+| ---------------------- | ------------------------ |
+| `/get_file`            | Fetch user configuration |
+| `/login`               | Login using config       |
+| `/get_token`           | Get instrument token     |
+| `/get_quote`           | Fetch market data        |
+| `/place_order`         | Place trade              |
+| `/modify_order`        | Modify trade             |
+| `/cancel_order`        | Cancel trade             |
+| `/orders`              | Get order book           |
+| `/positions`           | Get positions            |
+| `/portfolio`           | Get holdings             |
+| `/get_available_cash`  | Cash balance             |
+| `/get_required_margin` | Margin calculation       |
+
+---
+
+## 📊 Local Quote Fallback
+
+Method: `get_quote_api()`
+
+Flow:
+
+1. Try local service (`quotetickcandle-secvice`)
+2. If failed → fallback to broker API
+
+---
+
+## 🎯 Tick Size Rounding
+
+Utility method:
+
+```python
+broker.round_to(12569.67)
+```
+
+* Default precision: **0.05 (F&O tick size)**
+* Supports dynamic precision via column or value
+
+---
+
+## ⚠️ Error Handling
+
+* All API responses checked for `"error"`
+* Raises `Exception` if any issue occurs
+* Network failures auto-switch to secondary server
+
+---
+
+## 🧩 Dependencies
+
+* `pandas`
+* `requests`
+* `numpy`
+* `typing`
+
+---
+
+## 📝 Notes
+
+* Ensure API services are running:
+
+  * `broker-api-service`
+  * `quotetickcandle-secvice`
+* URLs can be overridden via config file (`get_file` response)
+
+---
+
+## 📌 Example Workflow
+
+```python
+broker = BrokerPackage("user1")
+broker.login()
+
+token = broker.get_token("NIFTY")
+ltp = broker.get_ltp(name="NIFTY")
+
+order_id = broker.place_order(
+    transaction_type="BUY",
+    price_=ltp,
+    quantity=50,
+    name="NIFTY"
+)
+```
+
+---
+
+## 📄 License
+
+This project is intended for internal/private trading system usage.
+
+---

brokerpackage-0.1/brokerpackage.egg-info/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.1
+Name: brokerpackage
+Version: 0.1
+Summary: Package is a Python client library designed to interact with a broker API service. It provides functionalities to manage and execute trading strategies, handle orders, and retrieve market data.
+Home-page: UNKNOWN
+Author: Vadlamani Rampratap Sharma
+Author-email: rampratap.optalpha@gmail.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# 📦 BrokerPackage
+
+`BrokerPackage` is a Python client library designed to interact with a broker API service. It provides a structured interface to perform trading operations such as login, fetching quotes, placing orders, managing positions, and more.
+
+---
+
+## 🚀 Features
+
+* 🔐 Login & session handling
+* 📊 Fetch market quotes (API + local fallback)
+* 📈 View orders, positions, and portfolio
+* 💰 Check available cash & margin requirements
+* 🛒 Place, modify, and cancel orders
+* 🔄 Automatic failover (primary → secondary server)
+* 🎯 Token-based instrument identification
+* ⚡ Tick-size rounding utility for F&O (.05 precision)
+
+---
+
+This script requires the following libraries:
+
+- openpyxl==3.1.2
+- pandas==1.5.3
+- numpy==1.23.5
+
+## 📦 Installation
+
+```bash
+pip install openpyxl==3.1.2 pandas==1.5.3 numpy==1.23.5 
+```
+
+---
+
+## 🧑‍💻 Usage
+
+### 1. Initialize
+
+```python
+from BrokerPackage import BrokerPackage
+
+broker = BrokerPackage(username="your_username")
+```
+
+---
+
+### 2. Login
+
+```python
+broker.login()
+```
+
+---
+
+### 3. Get Token
+
+```python
+token = broker.get_token(name="RELIANCE")
+```
+
+---
+
+### 4. Get Quote
+
+```python
+quote_df = broker.get_quote(name="RELIANCE")
+print(quote_df)
+```
+
+---
+
+### 5. Get LTP (Last Traded Price)
+
+```python
+ltp = broker.get_ltp(name="RELIANCE")
+print(ltp)
+```
+
+---
+
+### 6. Place Order
+
+```python
+order_id = broker.place_order(
+    transaction_type="BUY",
+    price_=2500,
+    quantity=10,
+    name="RELIANCE"
+)
+print(order_id)
+```
+
+---
+
+### 7. Modify Order
+
+```python
+broker.modify_order(order_id="12345", price=2550, quantity=10)
+```
+
+---
+
+### 8. Cancel Order
+
+```python
+broker.cancel_order(order_id="12345")
+```
+
+---
+
+### 9. View Orders / Positions / Portfolio
+
+```python
+orders = broker.orders()
+positions = broker.positions()
+portfolio = broker.portfolio()
+```
+
+---
+
+### 10. Account Info
+
+```python
+cash = broker.get_available_cash()
+margin = broker.get_required_margin(
+    transaction_type="BUY",
+    token=token,
+    price_=2500,
+    product="MIS"
+)
+```
+
+---
+
+## 🔄 Failover Mechanism
+
+All API calls:
+
+* Try **Primary URL**
+* On failure → fallback to **Secondary URL**
+
+---
+
+## 🌐 API Endpoints Used
+
+| Endpoint               | Description              |
+| ---------------------- | ------------------------ |
+| `/get_file`            | Fetch user configuration |
+| `/login`               | Login using config       |
+| `/get_token`           | Get instrument token     |
+| `/get_quote`           | Fetch market data        |
+| `/place_order`         | Place trade              |
+| `/modify_order`        | Modify trade             |
+| `/cancel_order`        | Cancel trade             |
+| `/orders`              | Get order book           |
+| `/positions`           | Get positions            |
+| `/portfolio`           | Get holdings             |
+| `/get_available_cash`  | Cash balance             |
+| `/get_required_margin` | Margin calculation       |
+
+---
+
+## 📊 Local Quote Fallback
+
+Method: `get_quote_api()`
+
+Flow:
+
+1. Try local service (`quotetickcandle-secvice`)
+2. If failed → fallback to broker API
+
+---
+
+## 🎯 Tick Size Rounding
+
+Utility method:
+
+```python
+broker.round_to(12569.67)
+```
+
+* Default precision: **0.05 (F&O tick size)**
+* Supports dynamic precision via column or value
+
+---
+
+## ⚠️ Error Handling
+
+* All API responses checked for `"error"`
+* Raises `Exception` if any issue occurs
+* Network failures auto-switch to secondary server
+
+---
+
+## 🧩 Dependencies
+
+* `pandas`
+* `requests`
+* `numpy`
+* `typing`
+
+---
+
+## 📝 Notes
+
+* Ensure API services are running:
+
+  * `broker-api-service`
+  * `quotetickcandle-secvice`
+* URLs can be overridden via config file (`get_file` response)
+
+---
+
+## 📌 Example Workflow
+
+```python
+broker = BrokerPackage("user1")
+broker.login()
+
+token = broker.get_token("NIFTY")
+ltp = broker.get_ltp(name="NIFTY")
+
+order_id = broker.place_order(
+    transaction_type="BUY",
+    price_=ltp,
+    quantity=50,
+    name="NIFTY"
+)
+```
+
+---
+
+## 📄 License
+
+This project is intended for internal/private trading system usage.
+
+---
+

brokerpackage-0.1/brokerpackage.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+setup.py
+BrokerPackage/BrokerPackage.py
+BrokerPackage/__init__.py
+BrokerPackage/version.py
+brokerpackage.egg-info/PKG-INFO
+brokerpackage.egg-info/SOURCES.txt
+brokerpackage.egg-info/dependency_links.txt
+brokerpackage.egg-info/requires.txt
+brokerpackage.egg-info/top_level.txt

brokerpackage-0.1/brokerpackage.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

brokerpackage-0.1/brokerpackage.egg-info/requires.txt

@@ -0,0 +1,3 @@
+openpyxl==3.1.2
+pandas==1.5.3
+numpy==1.23.5

brokerpackage-0.1/brokerpackage.egg-info/top_level.txt

@@ -0,0 +1 @@
+BrokerPackage

brokerpackage-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

brokerpackage-0.1/setup.py

@@ -0,0 +1,28 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name='brokerpackage',
+    version='0.1',
+    description='Package is a Python client library designed to interact with a broker API service. It provides functionalities to manage and execute trading strategies, handle orders, and retrieve market data.',
+    author='Vadlamani Rampratap Sharma',
+    author_email='rampratap.optalpha@gmail.com',
+    packages=find_packages(),
+    install_requires=[
+        'openpyxl==3.1.2',
+        'pandas==1.5.3',
+        'numpy==1.23.5'
+    ],
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    license="MIT",
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+    ],
+    python_requires='>=3.9.7',
+    include_package_data=True
+)