Skip to main content

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.

Screenshot

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.

  1. Download a TOTP app like Google Authenticator.
  2. 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)
  1. Open Google Authenticator and click the + button to add a new account
  2. Either enter the TOTP key manually and scan the QR code from step 2.
  3. Log in to the Schwab security center
  4. Under Two-Step Verification, select Always at Login, and then select "Security Token" as your method.
  5. Enter the Symantec ID from step 2 into the Credential ID field.
  6. Enter the 6-digit code from Google Authenticator into the Security Code field.
  7. 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:

  1. After forking, install dependencies:
pip install .
playwright install && playwright install-deps
  1. Run the example script:
pip install . && python example/example.py
  1. 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 and trade_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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

schwab_api-0.4.3.tar.gz (17.7 kB view details)

Uploaded Source

Built Distribution

schwab_api-0.4.3-py3-none-any.whl (16.8 kB view details)

Uploaded Python 3

File details

Details for the file schwab_api-0.4.3.tar.gz.

File metadata

  • Download URL: schwab_api-0.4.3.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for schwab_api-0.4.3.tar.gz
Algorithm Hash digest
SHA256 c6c653bfed9f03ae2ece943ddb49a5974e15131aa01c6fa2032965957851bcf3
MD5 dd1c52ade24d445899742301e37d78eb
BLAKE2b-256 e679903ebf88645e9fa895e59f4631dd0d21ff90cd3a043ed7fa266e73a500c8

See more details on using hashes here.

File details

Details for the file schwab_api-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: schwab_api-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 16.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for schwab_api-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 18e32a1eb02dd387146e9921056d95b74cfe1e6e6a876a45a9b3efae53a18ad9
MD5 3dc89010395f28a6c66eb67bbcac80a8
BLAKE2b-256 0033d0c5442d84a7bc4e6d81b9f7d7fc65c1f121dbb881d6e520471b0100a6ff

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page