piker/README.rst

245 lines
9.1 KiB
ReStructuredText
Raw Normal View History

2018-01-20 18:19:15 +00:00
piker
2018-02-15 18:33:53 +00:00
-----
2020-09-02 16:36:24 +00:00
trading gear for hackers.
2018-01-27 06:52:24 +00:00
2020-11-06 17:46:04 +00:00
|gh_actions|
2018-04-11 04:10:45 +00:00
2020-11-06 17:46:04 +00:00
.. |gh_actions| image:: https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fpikers%2Fpiker%2Fbadge&style=popout-square
:target: https://actions-badge.atrox.dev/piker/pikers/goto
2019-02-26 06:14:58 +00:00
2020-11-06 17:46:04 +00:00
``piker`` is a broker agnostic, next-gen FOSS toolset for real-time
2021-02-21 21:04:04 +00:00
computational trading targeted at `hardcore Linux users <comp_trader>`_ .
2019-02-26 06:14:58 +00:00
2020-11-06 17:46:04 +00:00
we use as much bleeding edge tech as possible including (but not limited to):
- latest python for glue_
2020-09-02 16:36:24 +00:00
- trio_ for `structured concurrency`_
2020-07-08 19:42:51 +00:00
- tractor_ for distributed, multi-core, real-time streaming
2020-06-02 14:32:04 +00:00
- marketstore_ for historical and real-time tick data persistence and sharing
- techtonicdb_ for L2 book storage
2020-05-12 02:43:30 +00:00
- Qt_ for pristine high performance UIs
2020-07-08 19:42:51 +00:00
- pyqtgraph_ for real-time charting
2020-09-02 16:36:24 +00:00
- ``numpy`` and ``numba`` for `fast numerics`_
2019-02-26 06:14:58 +00:00
2018-04-11 04:10:45 +00:00
.. |travis| image:: https://img.shields.io/travis/pikers/piker/master.svg
:target: https://travis-ci.org/pikers/piker
2019-03-22 02:46:20 +00:00
.. _trio: https://github.com/python-trio/trio
.. _tractor: https://github.com/goodboy/tractor
2020-09-02 16:45:24 +00:00
.. _structured concurrency: https://trio.discourse.group/
2020-05-12 02:43:30 +00:00
.. _marketstore: https://github.com/alpacahq/marketstore
2020-06-02 14:32:04 +00:00
.. _techtonicdb: https://github.com/0b01/tectonicdb
2020-05-12 02:43:30 +00:00
.. _Qt: https://www.qt.io/
2020-09-02 16:45:24 +00:00
.. _pyqtgraph: https://github.com/pyqtgraph/pyqtgraph
2020-06-03 16:09:55 +00:00
.. _glue: https://numpy.org/doc/stable/user/c-info.python-as-glue.html#using-python-as-glue
2020-07-08 19:42:51 +00:00
.. _fast numerics: https://zerowithdot.com/python-numpy-and-pandas-performance/
2021-02-21 21:04:04 +00:00
.. _comp_trader: https://jfaleiro.wordpress.com/2019/10/09/computational-trader/
2019-03-22 02:46:20 +00:00
2020-05-12 02:43:30 +00:00
2020-11-06 17:46:04 +00:00
focus and features:
2020-05-12 02:43:30 +00:00
*******************
2021-03-31 18:23:45 +00:00
- 100% federated: your code, your hardware, your data feeds, your broker fills.
- zero web: low latency, native software that doesn't try to re-invent the OS
- maximal **privacy**: prevent brokers and mms from knowing your
planz; smack their spreads with dark volume.
- zero clutter: modal, context oriented UIs that echew minimalism, reduce
thought noise and encourage un-emotion.
- first class parallelism: built from the ground up on next-gen structured concurrency
primitives.
- traders first: broker/exchange/asset-class agnostic
- systems grounded: real-time financial signal processing that will
make any queuing or DSP eng juice their shorts.
- non-tina UX: sleek, powerful keyboard driven interaction with expected use in tiling wms
- data collaboration: every process and protocol is multi-host scalable.
- fight club ready: zero interest in adoption by suits; no corporate friendly license, ever.
fitting with these tenets, we're always open to new framework suggestions and ideas.
2020-09-02 16:36:24 +00:00
2020-09-02 16:45:24 +00:00
building the best looking, most reliable, keyboard friendly trading
2021-03-31 18:23:45 +00:00
platform is the dream; join the cause.
2018-01-27 06:52:24 +00:00
2019-02-26 06:14:58 +00:00
2020-11-06 17:46:04 +00:00
install
2018-01-27 06:52:24 +00:00
*******
2020-11-06 17:46:04 +00:00
``piker`` is currently under heavy pre-alpha development and as such
should be cloned from this repo and hacked on directly.
2018-01-27 06:52:24 +00:00
2020-11-06 17:46:04 +00:00
for a development install::
2018-02-12 15:55:04 +00:00
git clone git@github.com:pikers/piker.git
cd piker
2020-11-06 21:03:47 +00:00
virtualenv env
source ./env/bin/activate
2021-03-31 18:23:45 +00:00
pip install -r requirements.txt -e .
2018-02-12 15:55:04 +00:00
2023-02-11 18:45:29 +00:00
install for nixos
*****************
for users of `NixOS` we offer a development shell envoirment that can be
loaded with::
nix-shell develop.nix
2023-02-11 19:17:01 +00:00
this will setup the required python environment to run piker, make sure to
2023-02-11 18:45:29 +00:00
run::
pip install -r requirements.txt -e .
once after loading the shell
2019-03-22 02:46:20 +00:00
2021-09-17 12:15:58 +00:00
install for tinas
*****************
for windows peeps you can start by installing all the prerequisite software:
2022-02-23 23:17:14 +00:00
- install git with all default settings - https://git-scm.com/download/win
- install anaconda all default settings - https://www.anaconda.com/products/individual
- install microsoft build tools (check the box for Desktop development for C++, you might be able to uncheck some optional downloads) - https://visualstudio.microsoft.com/visual-cpp-build-tools/
- install visual studio code default settings - https://code.visualstudio.com/download
2021-09-17 12:15:58 +00:00
then, `crack a conda shell`_ and run the following commands::
mkdir code # create code directory
cd code # change directory to code
git clone https://github.com/pikers/piker.git # downloads piker installation package from github
cd piker # change directory to piker
conda create -n pikonda # creates conda environment named pikonda
conda activate pikonda # activates pikonda
conda install -c conda-forge python-levenshtein # in case it is not already installed
conda install pip # may already be installed
pip # will show if pip is installed
pip install -e . -r requirements.txt # install piker in editable mode
2022-02-23 23:13:44 +00:00
test Piker to see if it is working::
piker -b binance chart btcusdt.binance # formatting for loading a chart
piker -b kraken -b binance chart xbtusdt.kraken
piker -b kraken -b binance -b ib chart qqq.nasdaq.ib
piker -b ib chart tsla.nasdaq.ib
potential error::
FileNotFoundError: [Errno 2] No such file or directory: 'C:\\Users\\user\\AppData\\Roaming\\piker\\brokers.toml'
solution:
- navigate to file directory above (may be different on your machine, location should be listed in the error code)
- copy and paste file from 'C:\\Users\\user\\code\\data/brokers.toml' or create a blank file using notepad at the location above
Visual Studio Code setup:
- now that piker is installed we can set up vscode as the default terminal for running piker and editing the code
- open Visual Studio Code
- file --> Add Folder to Workspace --> C:\Users\user\code\piker (adds piker directory where all piker files are located)
- file --> Save Workspace As --> save it wherever you want and call it whatever you want, this is going to be your default workspace for running and editing piker code
- ctrl + shift + p --> start typing Python: Select Interpetter --> when the option comes up select it --> Select at the workspace level --> select the one that shows ('pikonda')
- change the default terminal to cmd.exe instead of powershell (default)
- now when you create a new terminal VScode should automatically activate you conda env so that piker can be run as the first command after a new terminal is created
2021-09-17 12:15:58 +00:00
also, try out fancyzones as part of powertoyz for a decent tiling windows manager to manage all the cool new software you are going to be running.
2021-09-17 12:15:58 +00:00
.. _conda installed: https://
.. _C++ build toolz: https://
.. _crack a conda shell: https://
.. _vscode: https://
.. link to the tina guide
.. _setup a coolio tiled wm console: https://
provider support
****************
2020-11-06 17:46:04 +00:00
for live data feeds the in-progress set of supported brokers is:
2020-09-02 16:36:24 +00:00
2022-06-05 00:21:02 +00:00
- IB_ via ``ib_insync``, also see our `container docs`_
- binance_ and kraken_ for crypto over their public websocket API
- questrade_ (ish) which comes with effectively free L1
2020-07-08 19:42:51 +00:00
2020-11-06 17:46:04 +00:00
coming soon...
2019-03-22 02:46:20 +00:00
2020-11-06 17:46:04 +00:00
- webull_ via the reverse engineered public API
- yahoo via yliveticker_
2019-03-22 02:46:20 +00:00
2020-11-06 17:46:04 +00:00
if you want your broker supported and they have an API let us know.
2019-03-22 02:46:20 +00:00
2020-11-06 17:46:04 +00:00
.. _IB: https://interactivebrokers.github.io/tws-api/index.html
2022-06-05 00:21:02 +00:00
.. _container docs: https://github.com/pikers/piker/tree/master/dockering/ib
2020-11-06 17:46:04 +00:00
.. _questrade: https://www.questrade.com/api/documentation
.. _kraken: https://www.kraken.com/features/api#public-market-data
.. _binance: https://github.com/pikers/piker/pull/182
2020-11-06 17:46:04 +00:00
.. _webull: https://github.com/tedchou12/webull
.. _yliveticker: https://github.com/yahoofinancelive/yliveticker
.. _coinbase: https://docs.pro.coinbase.com/#websocket-feed
2021-03-31 18:23:45 +00:00
2020-11-06 17:46:04 +00:00
check out our charts
2020-09-02 16:36:24 +00:00
********************
bet you weren't expecting this from the foss::
2018-04-18 18:03:59 +00:00
piker -l info -b kraken -b binance chart btcusdt.binance --pdb
this runs the main chart (currently with 1m sampled OHLC) in in debug
mode and you can practice paper trading using the following
micro-manual:
``order_mode`` (
edge triggered activation by any of the following keys,
``mouse-click`` on y-level to submit at that price
):
- ``f``/ ``ctl-f`` to stage buy
- ``d``/ ``ctl-d`` to stage sell
- ``a`` to stage alert
``search_mode`` (
``ctl-l`` or ``ctl-space`` to open,
``ctl-c`` or ``ctl-space`` to close
) :
- begin typing to have symbol search automatically lookup
symbols from all loaded backend (broker) providers
- arrow keys and mouse click to navigate selection
- vi-like ``ctl-[hjkl]`` for navigation
you can also configure your position allocation limits from the
sidepane.
2018-04-18 18:03:59 +00:00
2021-04-10 18:22:49 +00:00
run in distributed mode
***********************
start the service manager and data feed daemon in the background and
connect to it::
2021-04-10 18:22:49 +00:00
pikerd -l info --pdb
2021-04-10 18:22:49 +00:00
connect your chart::
2021-04-10 18:22:49 +00:00
piker -l info -b kraken -b binance chart xmrusdt.binance --pdb
2021-04-10 18:22:49 +00:00
enjoy persistent real-time data feeds tied to daemon lifetime. the next
time you spawn a chart it will load much faster since the data feed has
been cached and is now always running live in the background until you
kill ``pikerd``.
2021-04-10 18:22:49 +00:00
2020-11-06 17:46:04 +00:00
if anyone asks you what this project is about
2020-09-02 16:36:24 +00:00
*********************************************
2020-11-06 17:46:04 +00:00
you don't talk about it.
2018-04-18 18:03:59 +00:00
2021-03-31 18:23:45 +00:00
2020-11-06 17:46:04 +00:00
how do i get involved?
2020-09-02 16:36:24 +00:00
**********************
2020-11-06 17:46:04 +00:00
enter the matrix.
2021-03-31 18:23:45 +00:00
how come there ain't that many docs
***********************************
suck it up, learn the code; no one is trying to sell you on anything.
also, we need lotsa help so if you want to start somewhere and can't
necessarily write serious code, this might be the place for you!