A client library for Financefeast API
Project description
Financefeast
A client library to call the Financefeast API
Note: this is alpha quality code still, the API may change, and things may fall apart while you try it.
Quick start
Installation
financefeast
is available from pypi so you can install it as usual:
$ pip install financefeast
Usage
You must supply your client id and client secret. You can do this one of two ways, either when you create an instance of Financefeast by passing client_id and client_secret as args.
client = FinanceFeast(client_id="SOME ID", client_secret="SOME SECRET")
or
Using environment variables
FF-CLIENT-ID and FF-CLIENT-SECRET
and then
client = FinanceFeast()
Example
from financefeast import FinanceFeast
client = FinanceFeast(client_id="your_client_id",
client_secret="your_client_secret")
print(client.tickers())
Endpoints
validate
Validate your token. Returns 'true' if valid and not expired, otherwise 'false' Query params : None
alive
Check API health. Query params : None
usage
Get account endpoint usage by endpoint, and count by day Query params :
- date_from: string ; date range start in format YYYY-MM-DD
- date_to: string ; date range end in format YYYY-MM-DD
tickers
Get a list of supported tickers Query params :
- exchange: string ; limit tickers to this exchange
tickers_search
Get a list of supported tickers Query params :
- search_str: string ; search for a ticker symbol, uuid4 or company name. Partials will match and case insensitive
- exchange: string ; limit tickers to this exchange
exchanges
Get a list of supported exchanges Query params : None
eod
Get "end of day" prices for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- date_from: string ; date range start in format YYYY-MM-DD
- date_to: string ; date range end in format YYYY-MM-DD
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
intraday
Get "intraday" prices for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
sma
Get "intraday" prices and simple moving average for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
- window: list ; list of integers for the sma lookback window
ema
Get "intraday" prices and exponential moving average for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
- window: list ; list of integers for the ema lookback window
macd
Get "intraday" prices and moving average convergence divergence for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
rsi
Get "intraday" prices and relative strength indicator for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
- window: list ; list of integers for the rsi lookback window
adx
Get "intraday" prices and average directional index for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
- window: integer ; integer for the adx first sliding lookback window
- window_adx: integer ; integer for the adx last sliding lookback window
bollinger
Get "intraday" prices and bollinger band for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
- window: list ; list of integers for the bollinger lookback window
stochastic
Get "intraday" prices and stochastic oscillator for ticker Query params :
- ticker: string ; symbol or uuid4 of stock to return prices (required)
- datetime_from: string ; date range start in format YYYY-MM-DD : hh:mm:ss
- datetime_to: string ; date range end in format YYYY-MM-DD : hh:mm:ss
- exchange: string ; exchange ticker is member of
- interval: string ; data time interval
- window: integer ; integer for the stochastic lookback window
Features
All API endpoints are supported, plus detection of ratelimiting.
Supported now:
- All routes
- Rate limit aware
- Authorization
Future:
- Backoff when approaching rate limit thresholds
Limitations and known issues
None at this time.
Developing and contributing
Building wheel
python setup.py bdist_wheel
Installing wheel
pip install /path/to/wheelfile.whl
PRs are more than welcome! Please include tests for your changes :)
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.