firstrade 0.0.13__py3-none-any.whl → 0.0.15__py3-none-any.whl

firstrade/account.py

@@ -70,8 +70,7 @@ class FTSession:
             self.session.post(
                 url=urls.pin(), headers=headers, cookies=self.session.cookies, data=data
             )
-            if self.profile_path is not None:
-                self.save_cookies()
+            self.save_cookies()
         if (
             "/cgi-bin/sessionfailed?reason=6"
             in self.session.get(
@@ -88,15 +87,16 @@ class FTSession:
             Dict: Dictionary of cookies. Nom Nom
         """
         cookies = {}
-        if self.profile_path is not None:
-            directory = os.path.abspath(self.profile_path)
-            if not os.path.exists(directory):
-                os.makedirs(directory)
-            for filename in os.listdir(directory):
-                if filename.endswith(f"{self.username}.pkl"):
-                    filepath = os.path.join(directory, filename)
-                    with open(filepath, "rb") as f:
-                        cookies = pickle.load(f)
+        directory = os.path.abspath(self.profile_path) if self.profile_path is not None else "."
+        
+        if not os.path.exists(directory):
+            os.makedirs(directory)
+
+        for filename in os.listdir(directory):
+            if filename.endswith(f"{self.username}.pkl"):
+                filepath = os.path.join(directory, filename)
+                with open(filepath, "rb") as f:
+                    cookies = pickle.load(f)
         return cookies
 
     def save_cookies(self):
@@ -110,6 +110,14 @@ class FTSession:
             path = f"ft_cookies{self.username}.pkl"
         with open(path, "wb") as f:
             pickle.dump(self.session.cookies.get_dict(), f)
+    
+    def delete_cookies(self):    
+        """Deletes the session cookies."""
+        if self.profile_path is not None:
+            path = os.path.join(self.profile_path, f"ft_cookies{self.username}.pkl")
+        else:
+            path = f"ft_cookies{self.username}.pkl"
+        os.remove(path)
 
     def __getattr__(self, name):
         """

firstrade/order.py

@@ -68,6 +68,7 @@ class Order:
         duration: Duration,
         price=0.00,
         dry_run=True,
+        notional=False,
     ):
         """
         Builds and places an order.
@@ -100,6 +101,7 @@ class Order:
             "submiturl": "/cgi-bin/orderbar",
             "orderbar_clordid": "",
             "orderbar_accountid": "",
+            "notional": "yes" if notional else "",
             "stockorderpage": "yes",
             "submitOrders": "1",
             "previewOrders": previewOrders,

{firstrade-0.0.13.dist-info → firstrade-0.0.15.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: firstrade
-Version: 0.0.13
+Version: 0.0.15
 Summary: An unofficial API for Firstrade
 Home-page: https://github.com/MaxxRK/firstrade-api
-Download-URL: https://github.com/MaxxRK/firstrade-api/archive/refs/tags/0013.tar.gz
+Download-URL: https://github.com/MaxxRK/firstrade-api/archive/refs/tags/0015.tar.gz
 Author: MaxxRK
 Author-email: maxxrk@pm.me
 License: MIT
@@ -24,42 +24,48 @@ Requires-Dist: beautifulsoup4
 Requires-Dist: lxml
 
 # firstrade-api
- A reverse-engineered python API to interact with the Firstrade Trading platform.
 
- This is not an official api! This api's functionality may change at any time.
+A reverse-engineered python API to interact with the Firstrade Trading platform.
 
- This api provides a means of buying and selling stocks through Firstrade. It uses the Session class from requests to get authorization cookies. The rest is done with reverse engineered requests to Firstrade's API. 
+This is not an official api! This api's functionality may change at any time.
 
- ---
+This api provides a means of buying and selling stocks through Firstrade. It uses the Session class from requests to get authorization cookies. The rest is done with reverse engineered requests to Firstrade's API.
+
+In order to use Fractional shares you must accept the agreement on the website before using it in this API.
+
+---
 
 ## Contribution
+
 I am new to coding and new to open-source. I would love any help and suggestions!
 
 ## Setup
+
 Install using pypi:
+
 ```
 pip install firstrade
 ```
 
 ## Quikstart
-The code below will: 
-- Login and print account info. 
+
+The code below will:
+
+- Login and print account info.
 - Get a quote for 'INTC' and print out the information
 - Place a market order for 'INTC' on the first account in the `account_numbers` list
 - Print out the order confirmation
 
 ```
-from firstrade import account
-from firstrade import symbols
-from firstrade import order
+from firstrade import account, order, symbols
 
 # Create a session
-ft_ss = account.FTSession(username='', password='', pin='')
+ft_ss = account.FTSession(username="", password="", pin="")
 
 # Get account data
 ft_accounts = account.FTAccountData(ft_ss)
 if len(ft_accounts.account_numbers) < 1:
-    raise Exception('No accounts found or an error occured exiting...')
+    raise Exception("No accounts found or an error occured exiting...")
 
 # Print ALL account data
 print(ft_accounts.all_accounts)
@@ -71,7 +77,7 @@ print(ft_accounts.account_numbers[0])
 print(ft_accounts.account_balances)
 
 # Get quote for INTC
-quote = symbols.SymbolQuote(ft_ss, 'INTC')
+quote = symbols.SymbolQuote(ft_ss, "INTC")
 print(f"Symbol: {quote.symbol}")
 print(f"Exchange: {quote.exchange}")
 print(f"Bid: {quote.bid}")
@@ -86,50 +92,58 @@ print(f"Company Name: {quote.company_name}")
 # Get positions and print them out for an account.
 positions = ft_accounts.get_positions(account=ft_accounts.account_numbers[1])
 for key in ft_accounts.securities_held:
-    print(f"Quantity {ft_accounts.securities_held[key]['quantity']} of security {key} held in account {ft_accounts.account_numbers[1]}")
+    print(
+        f"Quantity {ft_accounts.securities_held[key]['quantity']} of security {key} held in account {ft_accounts.account_numbers[1]}"
+    )
 
-# Create an order object.   
+# Create an order object.
 ft_order = order.Order(ft_ss)
 
 # Place order and print out order confirmation data.
 ft_order.place_order(
     ft_accounts.account_numbers[0],
-    symbol='INTC',
+    symbol="INTC",
     price_type=order.PriceType.MARKET,
     order_type=order.OrderType.BUY,
-    quantity=1,
+    quantity=1, # number of shares or amount of dollar, depends on the value of notional
     duration=order.Duration.DAY,
-    dry_run=True
+    dry_run=True,
+    notional=False, # set to True if quantity above is "dollar"
 )
 
 # Print Order data Dict
 print(ft_order.order_confirmation)
 
 # Check if order was successful
-if ft_order.order_confirmation['success'] == 'Yes':
-    print('Order placed successfully.')
+if ft_order.order_confirmation["success"] == "Yes":
+    print("Order placed successfully.")
     # Print Order ID
     print(f"Order ID: {ft_order.order_confirmation['orderid']}.")
 else:
-    print('Failed to place order.')
+    print("Failed to place order.")
     # Print errormessage
-    print(ft_order.order_confirmation['actiondata'])
+    print(ft_order.order_confirmation["actiondata"])
+# Delete cookies
+ft_ss.delete_cookies()
 ```
+
 This code is also in test.py
 
 ---
 
- ## Implemented Features
- - [x] Login
- - [x] Get Quotes
- - [x] Get Account Data
- - [x] Place Orders and Receive order confirmation
- - [x] Get Currently Held Positions
+## Implemented Features
+
+- [x] Login
+- [x] Get Quotes
+- [x] Get Account Data
+- [x] Place Orders and Receive order confirmation
+- [x] Get Currently Held Positions
 
 ## TO DO
- - [ ] Check on placed order status.
- - [ ] Cancel placed orders
- - [ ] Options
- - [ ] Give me some Ideas!
 
-[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/O5O6PTOYG)  
+- [ ] Check on placed order status.
+- [ ] Cancel placed orders
+- [ ] Options
+- [ ] Give me some Ideas!
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/O5O6PTOYG)

firstrade-0.0.15.dist-info/RECORD

@@ -0,0 +1,10 @@
+firstrade/__init__.py,sha256=fNiWYgSTjElY1MNv0Ug-sVLMTR2z_Ngri_FY7Pekdrw,95
+firstrade/account.py,sha256=xDgTMXDy2UWUNi4kboXAKKBrbmZGpXLJ11MCHlMvzB0,9218
+firstrade/order.py,sha256=S9fg_pfYN_sDOerzxcoeC6Gyp4IXttHgnEZw4aD1l60,5205
+firstrade/symbols.py,sha256=m5v1QeY2crtNw7mymoV6wpD_J_M-avWK5Lz9DUZJpNE,2315
+firstrade/urls.py,sha256=nAKbOw30cediYI6JDaGc4gL7-m-7WKP3A--BEVrL_cI,1167
+firstrade-0.0.15.dist-info/LICENSE,sha256=wPEQjDqm5zMBmEcZp219Labmq_YIjhudpZiUzyVKaFA,1057
+firstrade-0.0.15.dist-info/METADATA,sha256=cGG02YGpwixRWyn-11IVie30zN5ScPDPHJu2JyAs0Lw,4312
+firstrade-0.0.15.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+firstrade-0.0.15.dist-info/top_level.txt,sha256=tdA8v-KDxU1u4VV6soiNWGBlni4ojv_t_j2wFn5nZcs,10
+firstrade-0.0.15.dist-info/RECORD,,

{firstrade-0.0.13.dist-info → firstrade-0.0.15.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

firstrade-0.0.13.dist-info/RECORD

@@ -1,10 +0,0 @@
-firstrade/__init__.py,sha256=fNiWYgSTjElY1MNv0Ug-sVLMTR2z_Ngri_FY7Pekdrw,95
-firstrade/account.py,sha256=bQf9IHatrzsyzkZfpmhV5-eNuj85s8T2i7C3xNKM0S0,8991
-firstrade/order.py,sha256=qHVTufY3UbRakrjFPd6hv8fxknATSoHFy2E20zl4PGE,5130
-firstrade/symbols.py,sha256=m5v1QeY2crtNw7mymoV6wpD_J_M-avWK5Lz9DUZJpNE,2315
-firstrade/urls.py,sha256=nAKbOw30cediYI6JDaGc4gL7-m-7WKP3A--BEVrL_cI,1167
-firstrade-0.0.13.dist-info/LICENSE,sha256=wPEQjDqm5zMBmEcZp219Labmq_YIjhudpZiUzyVKaFA,1057
-firstrade-0.0.13.dist-info/METADATA,sha256=jqwjimrVDp6AAAssZdzxtCZ6Qt376P9fCtc18bECZi8,4066
-firstrade-0.0.13.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-firstrade-0.0.13.dist-info/top_level.txt,sha256=tdA8v-KDxU1u4VV6soiNWGBlni4ojv_t_j2wFn5nZcs,10
-firstrade-0.0.13.dist-info/RECORD,,