firstrade 0.0.21__py3-none-any.whl → 0.0.32__py3-none-any.whl

firstrade/urls.py

@@ -1,46 +1,80 @@
-def get_xml():
-    return "https://invest.firstrade.com/cgi-bin/getxml"
+def login():
+    return "https://api3x.firstrade.com/sess/login"
 
 
-def login():
-    return "https://invest.firstrade.com/cgi-bin/login"
+def request_code():
+    return "https://api3x.firstrade.com/sess/request_code"
+
 
+def verify_pin():
+    return "https://api3x.firstrade.com/sess/verify_pin"
 
-def pin():
-    return "https://invest.firstrade.com/cgi-bin/enter_pin?destination_page=home"
+
+def user_info():
+    return "https://api3x.firstrade.com/private/userinfo"
 
 
 def account_list():
-    return "https://invest.firstrade.com/cgi-bin/getaccountlist"
+    return "https://api3x.firstrade.com/private/acct_list"
+
+
+def account_balances(account):
+    return f"https://api3x.firstrade.com/private/balances?account={account}"
+
+
+def account_positions(account):
+    return (
+        f"https://api3x.firstrade.com/private/positions?account={account}&per_page=200"
+    )
+
+
+def quote(account, symbol):
+    return f"https://api3x.firstrade.com/public/quote?account={account}&q={symbol}"
 
 
-def quote(symbol):
-    return f"https://invest.firstrade.com/cgi-bin/getxml?page=quo&quoteSymbol={symbol}"
+def order():
+    return "https://api3x.firstrade.com/private/stock_order"
 
 
-def orderbar():
-    return "https://invest.firstrade.com/cgi-bin/orderbar"
+def order_list(account):
+    return f"https://api3x.firstrade.com/private/order_status?account={account}"
 
 
-def account_status():
-    return "https://invest.firstrade.com/cgi-bin/account_status"
+def account_history(account, date_range, custom_range):
+    if custom_range is None:
+        return f"https://api3x.firstrade.com/private/account_history?range={date_range}&page=1&account={account}&per_page=1000"
+    return f"https://api3x.firstrade.com/private/account_history?range={date_range}&range_arr[]={custom_range[0]}&range_arr[]={custom_range[1]}&page=1&account={account}&per_page=1000"
 
-def order_list():
-    return "https://invest.firstrade.com/cgi-bin/orderstatus"
 
+def cancel_order():
+    return "https://api3x.firstrade.com/private/cancel_order"
 
-def status():
-    return "https://invest.firstrade.com/scripts/profile/margin_v2.php"
+
+def option_dates(symbol):
+    return f"https://api3x.firstrade.com/public/oc?m=get_exp_dates&root_symbol={symbol}"
+
+
+def option_quotes(symbol, date):
+    return f"https://api3x.firstrade.com/public/oc?m=get_oc&root_symbol={symbol}&exp_date={date}&chains_range=A"
+
+
+def greek_options():
+    return "https://api3x.firstrade.com/private/greekoptions/analytical"
+
+
+def option_order():
+    return "https://api3x.firstrade.com/private/option_order"
 
 
 def session_headers():
     headers = {
-        "Accept": "*/*",
-        "Accept-Encoding": "gzip, deflate, br",
-        "Accept-Language": "en-US,en;q=0.9",
-        "Host": "invest.firstrade.com",
-        "Referer": "https://invest.firstrade.com/cgi-bin/main",
-        "Connection": "keep-alive",
-        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.81",
+        "Accept-Encoding": "gzip",
+        "Connection": "Keep-Alive",
+        "Host": "api3x.firstrade.com",
+        "User-Agent": "okhttp/4.9.2",
     }
     return headers
+
+
+def access_token():
+    return "833w3XuIFycv18ybi"

{firstrade-0.0.21.dist-info → firstrade-0.0.32.dist-info}/METADATA

@@ -1,9 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: firstrade
-Version: 0.0.21
+Version: 0.0.32
 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/0021.tar.gz
+Download-URL: https://github.com/MaxxRK/firstrade-api/archive/refs/tags/0032.tar.gz
 Author: MaxxRK
 Author-email: maxxrk@pm.me
 License: MIT
@@ -17,11 +17,24 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: beautifulsoup4
 Requires-Dist: lxml
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: summary
 
 # firstrade-api
 
@@ -37,7 +50,10 @@ In order to use Fractional shares you must accept the agreement on the website b
 
 ## Contribution
 
-I am new to coding and new to open-source. I would love any help and suggestions!
+Please feel free to contribute to this project. If you find any bugs, please open an issue.
+
+## Disclaimer
+I am not a financial advisor and not affiliated with Firstrade in any way. Use this tool at your own risk. I am not responsible for any losses or damages you may incur by using this project. This tool is provided as-is with no warranty.
 
 ## Setup
 
@@ -49,33 +65,41 @@ pip install firstrade
 
 ## Quikstart
 
-`Checkout test.py for sample code.`
-
-This code will:
+The code in `test.py` 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
+- Place a dry run market order for 'INTC' on the first account in the `account_numbers` list
 - Print out the order confirmation
-
-`Checkout test.py for sample code.`
-
+- Contains a cancel order example
+- Get an option Dates, Quotes, and Greeks
+- Place a dry run option order
 ---
 
 ## Implemented Features
 
-- [x] Login
+- [x] Login (With all 2FA methods now supported!) 
 - [x] Get Quotes
 - [x] Get Account Data
 - [x] Place Orders and Receive order confirmation
 - [x] Get Currently Held Positions
 - [x] Fractional Trading support (thanks to @jiak94)
 - [x] Check on placed order status. (thanks to @Cfomodz)
+- [x] Cancel placed orders
+- [x] Options (Orders, Quotes, Greeks)
+- [x] Order History
 
 ## TO DO
 
-- [ ] Cancel placed orders
-- [ ] Options
+- [ ] Test options fully
 - [ ] Give me some Ideas!
 
+## Options
+
+### I am very new to options trading and have not fully tested this feature.
+
+Please:
+- USE THIS FEATURE LIKE IT IS A ALPHA/BETA
+- PUT IN A GITHUB ISSUE IF YOU FIND ANY PROBLEMS
+  
 ## If you would like to support me, you can do so here:
-[![GitHub Sponsors](https://img.shields.io/github/sponsors/maxxrk?style=social)](https://github.com/sponsors/maxxrk) 
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/maxxrk?style=social)](https://github.com/sponsors/maxxrk)

firstrade-0.0.32.dist-info/RECORD

@@ -0,0 +1,11 @@
+firstrade/__init__.py,sha256=fNiWYgSTjElY1MNv0Ug-sVLMTR2z_Ngri_FY7Pekdrw,95
+firstrade/account.py,sha256=wLPlQOzgaaBwb8tvYPcWdhfTtaUEtM54iPBl5dPpVHY,14129
+firstrade/exceptions.py,sha256=OrWB83rc33LSxrI7WxXo4o7FcIfmvPSC9bAY8K1pn7U,1886
+firstrade/order.py,sha256=_b1SnqagwBu7KUmvzSUcp8iMOC3I3k-QDjiDLhlVk7E,8710
+firstrade/symbols.py,sha256=EOGVdLl1MzvO0yUt7KRqbSM9vHeinqn8IU0FnZzcExo,7906
+firstrade/urls.py,sha256=Iw10isyvoqKwiSl3TVuIbos5INZzIEwpln3HcZ7P5aw,2125
+firstrade-0.0.32.dist-info/LICENSE,sha256=wPEQjDqm5zMBmEcZp219Labmq_YIjhudpZiUzyVKaFA,1057
+firstrade-0.0.32.dist-info/METADATA,sha256=R1hQzM3IBPemvLRR81wUgGiEcilURKjdkGLnLB5R1bs,3345
+firstrade-0.0.32.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+firstrade-0.0.32.dist-info/top_level.txt,sha256=tdA8v-KDxU1u4VV6soiNWGBlni4ojv_t_j2wFn5nZcs,10
+firstrade-0.0.32.dist-info/RECORD,,

{firstrade-0.0.21.dist-info → firstrade-0.0.32.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (71.1.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

firstrade-0.0.21.dist-info/RECORD

@@ -1,10 +0,0 @@
-firstrade/__init__.py,sha256=fNiWYgSTjElY1MNv0Ug-sVLMTR2z_Ngri_FY7Pekdrw,95
-firstrade/account.py,sha256=xDgTMXDy2UWUNi4kboXAKKBrbmZGpXLJ11MCHlMvzB0,9218
-firstrade/order.py,sha256=bvqO06BzrtWQNP8PAWbPR3Ypnu9LEAwq4BWn1-joScY,9105
-firstrade/symbols.py,sha256=tZD7jexvyvh1rTaOdAKv_vyZWzpjffvl_nPwBe1QaiA,3633
-firstrade/urls.py,sha256=OrfXGDsNpA2rTm4o55KAQzpeigG_pxufWyTDBlbhJYQ,1248
-firstrade-0.0.21.dist-info/LICENSE,sha256=wPEQjDqm5zMBmEcZp219Labmq_YIjhudpZiUzyVKaFA,1057
-firstrade-0.0.21.dist-info/METADATA,sha256=Krhj7olyyZ4ylGtU7yRZ7_F7h9FgIzM5MX13Ipi7Q6k,2399
-firstrade-0.0.21.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
-firstrade-0.0.21.dist-info/top_level.txt,sha256=tdA8v-KDxU1u4VV6soiNWGBlni4ojv_t_j2wFn5nZcs,10
-firstrade-0.0.21.dist-info/RECORD,,