tbc-ken-api 0.3.1

Trading Bot Club alpaca api

tbc-ken-lib

This lib is made for to be used by members of the TBC club made in 2022.

Install

Make sure python3 and pip is installed globally in your system. Write or paste the script into your bash terminal.

$ pip install tbc-ken-lib

Latest Supported Features

tbc-ken-lib has and will only have functions that will be used for the project. Other functions that other Alpaca API clients may include that will not be used by the club will not be included in this lib.

• Get a list of symbols
• Get any asset's market history
• Get general information of any assets.
• Sell assets
• Buy assets

Unticked features will be coming in the next versions.

Examples

Index

• Basic Setup
• Get Assets
• Get Bars
• Download Symbols

Setup

Install the module from https://pypi.org Follow this link and generate an API key: https://app.alpaca.markets/paper/dashboard/overview Don't worry if you lose the key or forgot where you saved it. You can always regenerate them.

#example.py
import ken_api
api = ken_api.api(
    'XXXXXXXXXXXXXXXXXXXX',  # alpaca api key (20 characters in length)
    "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  # alpaca api secret (40 characters in length)
)  
# The alpaca api key and secret almost feels like user and password sometimes.
# If you don't have your own keys, you can use mine up there, though it is limitted to 200 api requests per minute.
# It's recommended to use your own keys. 

Get Assets

get_assets: (*symbols: str, **simple: bool) -> (dict | int)

Get basic info of any stocks by putting in symbols. Put in simple=True to make the result come in a simple format.

""" 
You can put in one symbol or many symbols. 
Without having the simple=True, it will return you much more data.
""" 
print(api.get_assets('SXNTF', "SWSSF", "MANR", simple=True))
print(api.get_assets('PCSGF', simple=True))
print(api.get_assets('PCSGF'))

Get Bars

get_bars: (symbol: Any, **kwargs: Any) -> (list | int)

This function simply returns a List of dicts representing each candle in a 1 day time frame.

# Get candles of a symbol. 
#You can specify the start, end, and limit. (optional)
print(api.get_bars("TSLA", start="2022-10-05", end="2022-10-15"))

Expected return format t string/timestamp Timestamp in RFC-3339 format with nanosecond precision o number Open price h number High price c number Close price v int Volume n int Number of trades vw number Volume-weighted average price

Download Assets

download_symbols: (path) -> (dict | int)

The function downloads a list of all stocks and assets Alpaca has, both active and inactive. It also takes no parameters

api.download_symbols()
# This function doesn't return anything. The result will be downloaded as symbols_list in your current working directory without a file extension.

Patches

v0.3

To use this lib, it is recommended to put your own api **key** and **secret** in your api object parameters. If not, you will automatically use mine, which has it's limits.

v0.2 and bellow

To use the lib, touch alpaca_credentials.json and place in it your credentials.

//alpaca_credentials.json
{
	"APCA-API-KEY-ID": "PKNOZUSMT0A6E89QURCG",
	"APCA-API-SECRET-KEY": "SXFTc5gC4cAWmUpuGEiEurBGfN4bAqhA6Mxu28Ez"
}