Unofficial Schwab API wrapper in Python 3.
Project description
Schwab API
This is not an official API wrapper. Functionality may change with any updates made by Schwab. As of June 2024, this API continues to work as expected.
This package enables buying and selling securities programmatically on Charles Schwab. Currently, we use a headless browser to automate logging in in order to get authorization cookies. All other functionality is done through web requests made to Schwab's own API.
Features
- Buying and Selling tickers
- Trading options
- Get quotes for multiple tickers
- Get order information
- Get transaction history
- Get tax lot info
- Account and Position Information
- Limit / Stop orders are possible using trade_v2 parameters
- Multiple individual account support
- MFA and TOTP authentication
- Session caching
- Async compatibility
Live Demo
I am currently using this package to place trades on Schwab using my website here.
Getting Started
Installing
Install using pypi and then download and install the playwright binaries:
pip install schwab-api
python -m playwright install
Set up your account to use TOTP
In order to login to Schwab without having to go through SMS verification everytime, you'll need to create an authentication token (TOTP) and attach that to your Schwab account.
- Download a TOTP app like Google Authenticator.
- Go to my website and generate a TOTP key there by clicking 'Generate TOTP' and following the instructions. You should get a Symantec ID and a TOTP key/QR code.
Alternatively, you can do this programmatically:
from schwab_api import generate_totp
symantec_id, totp_secret = generate_totp()
print("Your symantec ID is: " + symantec_id)
print("Your TOTP secret is: " + totp_secret)
- Open Google Authenticator and click the
+
button to add a new account - Either enter the TOTP key manually and scan the QR code from step 2.
- Log in to the Schwab security center
- Under Two-Step Verification, select Always at Login, and then select "Security Token" as your method.
- Enter the Symantec ID from step 2 into the Credential ID field.
- Enter the 6-digit code from Google Authenticator into the Security Code field.
- Done! Now keep your TOTP secret from step 2 handy as your
SCHWAB_TOTP_SECRET
in your.env
file under the example directory.
Quickstart
You can run this code in a Colab Notebook here.
Here's some code that logs in, gets all account holdings, and makes a stock purchase:
from schwab_api import Schwab
import pprint
# Initialize our schwab instance
api = Schwab()
# Login using playwright
print("Logging into Schwab")
logged_in = api.login(
username=username,
password=password,
totp_secret=totp_secret # Get this by generating TOTP at https://itsjafer.com/#/schwab
)
# Get information about a few tickers
quotes = api.quote_v2(["PFE", "AAPL"])
pprint.pprint(quotes)
# Get information about all accounts holdings
print("Getting account holdings information")
account_info = api.get_account_info()
pprint.pprint(account_info)
print("The following account numbers were found: " + str(account_info.keys()))
print("Placing a dry run trade for AAPL stock")
# Place a dry run trade for account 99999999
messages, success = api.trade_v2(
ticker="AAPL",
side="Buy", #or Sell
qty=1,
account_id=99999999, # Replace with your account number
dry_run=True # If dry_run=True, we won't place the order, we'll just verify it.
)
print("The order verification was " + "successful" if success else "unsuccessful")
print("The order verification produced the following messages: ")
pprint.pprint(messages)
TODO
- Currently, we use a headless browser to login to Schwab; in the future, we want to do this purely with requests.
- Documentation of functionality
Development Guide
Want to extend functionality? Here's how to get started:
- After forking, install dependencies:
pip install .
playwright install && playwright install-deps
- Run the example script:
pip install . && python example/example.py
- Iterate on existing code:
- Authentication largely exists in
schwab_api/authentication.py
and is done using Playwright. - Trading happens in
schwab_api/schwab.py
in two functions:trade
andtrade_v2
which use the legacy and new API respectively. Neither of these APIs are documented and were largely just reverse engineering through sniffing network requests in the UI.
Deployment
Bumping the version number in setup.py
will automatically trigger a deployment that must be approved by itsjafer@.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for schwab_api-0.4.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 18e32a1eb02dd387146e9921056d95b74cfe1e6e6a876a45a9b3efae53a18ad9 |
|
MD5 | 3dc89010395f28a6c66eb67bbcac80a8 |
|
BLAKE2b-256 | 0033d0c5442d84a7bc4e6d81b9f7d7fc65c1f121dbb881d6e520471b0100a6ff |