ameritrade-python

This is a simple and lightweight async api wrapper for Ameritrade's API.

The official docs for the Ameritrade API can be found here.

The first time authentication will require utilizing the callback URL/redirect URI to obtain your tokens. This package will generate an auth url to enter into a web browser, you can then paste the resulting url from the redirect url in order to obtain a pair of tokens.

fromosimportenvironfromameritradeimportauthtest_redirect_uri=environ.get("callback_url")
consumer_key=environ.get("consumer_key")
test_auth=auth.Auth(redirect_uri=test_redirect_uri, consumer_key=consumer_key)
asyncdefmain():
"""Sets the access and refresh tokens by following terminal prompts."""awaittest_auth.manual_auth()

Simple usage using an existing refresh token:

importasynciofromosimportenvironfromameritradeimportauth, stocktest_redirect_uri=environ.get("callback_url")
consumer_key=environ.get("consumer_key")
refresh_token=environ.get("refresh_token")
test_auth=auth.Auth(redirect_uri=test_redirect_uri, consumer_key=consumer_key, refresh_token=refresh_token)
asyncdefmain():
"""Gets new tokens, then gets a single stock quote for 'KO'/coca-cola."""awaittest_auth.refresh_token_auth() # Gets fresh tokenstest_stock=stock.Stock(auth_class=test_auth, symbol="ko") # creates stock object for KOawaittest_stock.get_quote() # Makes the quote requestprint(test_stock.quote)
loop=asyncio.get_event_loop() # Creates the event looploop.run_until_complete(main()) # Runs the event loop

Environment

I suggest utilizing a .env file to store private/sensitive information.
If you are not providing a refresh token, it is recommended that you use auth.Auth.manual_auth() in order to use Ameritrade's front end auth tools, you can follow the on-screen instructions for this.

You may choose to save your refresh token in a secure location/format, if using a previous refresh token, you only need to provide these to your auth class:

• consumer_key
• refresh_token

Developemnt

Install dependencies with poetry poetry install.

Building Locally

poetry build