tastytrade 10.2.3__tar.gz → 11.0.0__tar.gz

{tastytrade-10.2.3 → tastytrade-11.0.0}/.github/CONTRIBUTING.md

@@ -5,6 +5,6 @@ Since Tastytrade certification sessions are severely limited in capabilities, th
 ## Steps to follow to contribute
 
 1. Fork the repository to your personal Github account and make your proposed changes.
-2. Export your username, password, and account number to the following Github Actions repository secrets: `TT_USERNAME`, `TT_PASSWORD`, and `TT_ACCOUNT`. The account should be a margin account.
+2. Export your username, password, and account number to the following Github Actions repository secrets: `TT_SECRET`, `TT_REFRESH`, and `TT_ACCOUNT`. The account should be a margin account.
 3. Make sure you have at least one share of long $F in your account, which will be used to place the OCO complex order (nothing will fill), as well as at least $2 of buying power.
 4. Run `make install` to create the virtual environment, `make lint` to format your code, and `make test` to run the tests locally.

{tastytrade-10.2.3 → tastytrade-11.0.0}/.github/pull_request_template.md

@@ -6,7 +6,7 @@ Fixes ...
 ## Pre-merge checklist
 - [ ] Code formatted correctly (check with `make lint`)
 - [ ] Code implemented for both sync and async
-- [ ] Passing tests locally (check with `make test`, make sure you have `TT_USERNAME`, `TT_PASSWORD`, and `TT_ACCOUNT` environment variables set)
+- [ ] Passing tests locally (check with `make test`, make sure you have `TT_REFRESH`, `TT_SECRET`, and `TT_ACCOUNT` environment variables set)
 - [ ] New tests added (if applicable)
 
 Please note that, in order to pass the tests, you'll need to set up your Tastytrade credentials as repository secrets on your local fork. Read more at CONTRIBUTING.md.

{tastytrade-10.2.3 → tastytrade-11.0.0}/.github/workflows/python-app.yml

@@ -9,16 +9,25 @@ on:
 jobs:
   build:
     runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 1
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
     steps:
-    - uses: actions/checkout@v2
-    - name: Set up Python 3.9
-      uses: actions/setup-python@v4
+    - uses: actions/checkout@v5
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v6
       with:
-        python-version: '3.9'
-    - uses: yezz123/setup-uv@v4
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
     - name: Setup uv venv
       run: |
-        uv sync
+        uv sync --locked --all-extras --dev
     - name: Lint with ruff
       run: |
         uv run ruff check tastytrade/ tests/
@@ -32,8 +41,8 @@ jobs:
       run: |
         uv run pytest --cov=tastytrade --cov-report=term-missing tests/ --cov-fail-under=95
       env:
-        TT_USERNAME: ${{ secrets.TT_USERNAME }}
-        TT_PASSWORD: ${{ secrets.TT_PASSWORD }}
-        TT_USERNAME_SANDBOX: ${{ secrets.TT_USERNAME_SANDBOX }}
-        TT_PASSWORD_SANDBOX: ${{ secrets.TT_PASSWORD_SANDBOX }}
+        TT_REFRESH_SANDBOX: ${{ secrets.TT_REFRESH_SANDBOX }}
+        TT_SECRET_SANDBOX: ${{ secrets.TT_SECRET_SANDBOX }}
         TT_ACCOUNT: ${{ secrets.TT_ACCOUNT }}
+        TT_REFRESH: ${{ secrets.TT_REFRESH }}
+        TT_SECRET: ${{ secrets.TT_SECRET }}

tastytrade-11.0.0/.python-version

@@ -0,0 +1 @@
+3.10

{tastytrade-10.2.3 → tastytrade-11.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tastytrade
-Version: 10.2.3
+Version: 11.0.0
 Summary: An unofficial, sync/async SDK for Tastytrade!
 Project-URL: Homepage, https://github.com/tastyware/tastytrade
 Project-URL: Documentation, https://tastyworks-api.rtfd.io
@@ -44,7 +44,6 @@ Classifier: Operating System :: Unix
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -52,11 +51,12 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
 Requires-Python: >=3.9
-Requires-Dist: httpx>=0.27.2
-Requires-Dist: pandas-market-calendars>=4.4.1
-Requires-Dist: pydantic>=2.9.2
-Requires-Dist: websockets>=15
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pandas-market-calendars>=5.1.1
+Requires-Dist: pydantic>=2.11.9
+Requires-Dist: websockets>=15.0.1
 Description-Content-Type: text/markdown
 
 [![Docs](https://readthedocs.org/projects/tastyworks-api/badge/?version=latest)](https://tastyworks-api.readthedocs.io/en/latest/?badge=latest)
@@ -92,12 +92,11 @@ $ pip install tastytrade
 
 ## Creating a session
 
-A session object is required to authenticate your requests to the Tastytrade API.
-You can create a real session using your normal login, or a certification (test) session using your certification login.
+A session object is required to authenticate your requests to the Tastytrade API. See [here](https://tastyworks-api.readthedocs.io/en/latest/sessions.html) for information on how to set up an OAuth application.
 
 ```python
 from tastytrade import Session
-session = Session('username', 'password')
+session = Session('client_secret', 'refresh_token')
 ```
 
 ## Using the streamer

{tastytrade-10.2.3 → tastytrade-11.0.0}/README.md

@@ -31,12 +31,11 @@ $ pip install tastytrade
 
 ## Creating a session
 
-A session object is required to authenticate your requests to the Tastytrade API.
-You can create a real session using your normal login, or a certification (test) session using your certification login.
+A session object is required to authenticate your requests to the Tastytrade API. See [here](https://tastyworks-api.readthedocs.io/en/latest/sessions.html) for information on how to set up an OAuth application.
 
 ```python
 from tastytrade import Session
-session = Session('username', 'password')
+session = Session('client_secret', 'refresh_token')
 ```
 
 ## Using the streamer

{tastytrade-10.2.3 → tastytrade-11.0.0}/docs/index.rst

@@ -39,7 +39,6 @@ A simple, reverse-engineered, sync/async SDK for Tastytrade built on their (now
    account-streamer
    data-streamer
    market-data
-   backtest
    market-sessions
    watchlists
 
@@ -49,7 +48,6 @@ A simple, reverse-engineered, sync/async SDK for Tastytrade built on their (now
    :hidden:
 
    api/account
-   api/backtesting
    api/dxfeed
    api/instruments
    api/market-data

{tastytrade-10.2.3 → tastytrade-11.0.0}/docs/orders.rst

@@ -131,7 +131,7 @@ Note that to cancel complex orders, you need to use the ``delete_complex_order``
 Notional market orders
 ----------------------
 
-Notional orders are slightly different from normal orders. Since the market will determine both the quantity and the price for you, you need to pass `value` instead of price, and pass `None` for the `quantity` parameter to ``build_leg``.
+Notional orders are slightly different from normal orders. Since the market will determine both the quantity and the price for you, you need to pass ``value`` instead of price, and pass ``None`` for the ``quantity`` parameter to ``build_leg``.
 
 .. code-block:: python
 
@@ -145,3 +145,23 @@ Notional orders are slightly different from normal orders. Since the market will
         ]
     )
     resp = account.place_order(session, order, dry_run=False)
+
+Cryptocurrency orders
+---------------------
+
+Cryptocurrency orders should use the special ``IOC`` TIF:
+
+.. code-block:: python
+
+    order = NewOrder(
+        time_in_force=OrderTimeInForce.IOC,
+        order_type=OrderType.NOTIONAL_MARKET,
+        value=-Decimal(100),  # buy $100 of ETH
+        legs=[
+            Leg(
+                instrument_type=InstrumentType.CRYPTOCURRENCY,
+                action=OrderAction.BUY_TO_OPEN,
+                symbol="ETH/USD",
+            ),
+        ],
+    )

tastytrade-11.0.0/docs/sessions.rst

@@ -0,0 +1,59 @@
+Sessions
+========
+
+Creating an OAuth application
+-----------------------------
+
+A session object is required to authenticate your requests to the Tastytrade API. Tastytrade uses OAuth logins, which allow you to connect applications (third-party or private) to your trading account to use the API.
+
+To get started, create a new OAuth application `here <https://my.tastytrade.com/app.html#/manage/api-access/oauth-applications>`_. Check all the scopes you plan to use, add `http://localhost:8000` as a valid callback, and create the application. **Save the client secret**, you'll need it later!
+
+Generating an initial refresh token
+-----------------------------------
+
+In order to generate an initial refresh token, you have two options. The easiest way is to simply generate one from Tastytrade's website: go to OAuth Applications > Manage > Create Grant to get a new refresh token, **which you should also save**.
+
+The other option (which is actually the only option for sandbox accounts) is to run this helper code:
+
+.. code-block:: python
+
+   from tastytrade.oauth import login
+   login(is_test=True)
+
+This will open up a web interface in your browser where you'll be prompted to paste your client ID and client secret. These credentials will then be used to connect your application to Tastytrade. After following the steps in your browser, you should see your new refresh token in the browser and in the console.
+
+At this point, OAuth is now setup correctly! Doing these steps once is sufficient for **indefinite usage** of ``Session`` for authentication to the API, since refresh tokens never expire. From now on you can simply authenticate with your client secret and refresh token.
+
+Creating a session
+------------------
+
+.. code-block:: python
+
+   from tastytrade import Session
+
+   session = Session('client_secret', 'refresh_token')
+
+These session objects can be used to make API requests:
+
+.. code-block:: python
+
+   from tastytrade import Account
+
+   accounts = Account.get(session)
+
+Note that OAuth sessions make API requests using a special session token, which has a duration of only 15 minutes. However, since the refresh tokens last forever, you can call ``Session.refresh()`` to refresh the session token whenever needed. The session object will keep track of session expiration time for you to make it easier to know when to refresh:
+
+.. code-block:: python
+
+   from tastytrade.utils import now_in_new_york
+
+   if now_in_new_york() > session.session_expiration:
+       session.refresh()
+       print(Account.get(session))
+
+A sandbox account for testing can be created `here <https://developer.tastytrade.com/sandbox/>`_, then used to create a session in the same way:
+
+.. code-block:: python
+
+   from tastytrade import Session
+   session = Session('client_secret', 'refresh_token', is_test=True)

{tastytrade-10.2.3 → tastytrade-11.0.0}/pyproject.toml

@@ -24,7 +24,6 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -32,6 +31,7 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Internet :: WWW/HTTP",
+    "Typing :: Typed",
 ]
 requires-python = ">=3.9"
 license = {file = "LICENSE"}
@@ -39,10 +39,10 @@ authors = [
   {name = "Graeme Holliday", email = "graeme@tastyware.dev"},
 ]
 dependencies = [
-    "httpx>=0.27.2",
-    "pandas-market-calendars>=4.4.1",
-    "pydantic>=2.9.2",
-    "websockets>=15",
+    "httpx>=0.28.1",
+    "pandas-market-calendars>=5.1.1",
+    "pydantic>=2.11.9",
+    "websockets>=15.0.1",
 ]
 dynamic = ["version"]
 
@@ -58,14 +58,14 @@ dev = [
     "pytest>=8.3.3",
     "pytest-aio>=1.5.0",
     "pytest-cov>=5.0.0",
-    "ruff>=0.6.9",
+    "ruff>=0.13.2",
     "pyright>=1.1.401",
     "sphinx>=7.4.7",
     "enum-tools[sphinx]>=0.12.0",
     "autodoc-pydantic>=2.2.0",
     "proxy-py>=2.4.9",
     "sphinx-immaterial>=0.12.5",
-    "mypy>=1.15.0",
+    "mypy>=1.18.2",
 ]
 
 [tool.setuptools.package-data]
@@ -77,8 +77,11 @@ where = ["tastytrade"]
 [tool.ruff.lint]
 select = ["E", "F", "I"]
 
+[tool.coverage.run]
+omit = ["tastytrade/oauth.py"]
+
 [tool.pyright]
-pythonVersion = "3.9"
+pythonVersion = "3.10"
 include = ["tastytrade", "tests"]
 exclude = ["**/__pycache__"]
 typeCheckingMode = "strict"

{tastytrade-10.2.3 → tastytrade-11.0.0}/tastytrade/__init__.py

@@ -1,10 +1,10 @@
 import logging
 
 API_URL = "https://api.tastyworks.com"
-BACKTEST_URL = "https://backtester.vast.tastyworks.com"
+API_VERSION = "20251026"
 CERT_URL = "https://api.cert.tastyworks.com"
 VAST_URL = "https://vast.tastyworks.com"
-VERSION = "10.2.3"
+VERSION = "11.0.0"
 
 __version__ = VERSION
 version_str: str = f"tastyware/tastytrade:v{VERSION}"
@@ -18,9 +18,4 @@ from .account import Account
 from .session import Session
 from .streamer import AlertStreamer, DXLinkStreamer
 
-__all__ = [
-    "Account",
-    "AlertStreamer",
-    "DXLinkStreamer",
-    "Session",
-]
+__all__ = ["Account", "AlertStreamer", "DXLinkStreamer", "Session"]