Skip to main content

Kite History API wrapper

Project description

kite-history
============

|GitHub license| |saythanks|

``kitehistory`` is a wrapper around `Kite Historical
API <https://kite.trade/docs/connect/v1/#historical-data>`__

Installation :
~~~~~~~~~~~~~~

::

pip install kitehistory

|asciicast|

Options :
~~~~~~~~~

::

--symbol Stock symbol of the instrument.
--interval Time interval for the tick data.
--from_date Start date indicating the start of records.
--to_date End date indicating the end of records.
--exchange Exchange Name. (MCX/NSE/BSE/NFO/CDS/BFO/MCXSX)
--output Output filename to save `csv`
--path Specify path to directory to store instruments master
along with access token keys
--verbose Enable verbose logging

Example Usage :
~~~~~~~~~~~~~~~

::

kitehistory -s TCS -i day -f 2017-05-15 -t 2017-06-05 -e NSE -o TCS.csv --verbose

.. figure:: screens/tcs.png
:alt: img

img
First Time Setup
~~~~~~~~~~~~~~~~

``kitehistory`` depends on Kite API to fetch instruments master file in
``.csv``. You need to create an appllication at
https://developers.kite.trade/apps and export the following keys in your
shell

::

export KITE_API_KEY='your-kite-api-key'
export KITE_SECRET='your-kite-secret-key'
export KITE_REQUEST_TOKEN='your-kite-request-token'

How it works ?
~~~~~~~~~~~~~~

Kite API requires instrument-token to fetch the historical data. The
idea behind this wrapper is to fetch the instruments master file and
query it for the required symbol to fetch instrument token. Once the
token is fetched, it uses Kite's API to get the historical data and
saves the output in a ``.csv`` ready for analysis etc.

Credits
-------

- `pandas <http://pandas.pydata.org/>`__
- `Kite API <https://developers.kite.trade/apps/>`__
- `pykiteconnect <pykiteconnect>`__
- `requests <http://docs.python-requests.org/en/master/>`__

Contributing
------------

Feel free to report any issues and/or send PRs for additional features.

License
~~~~~~~

MIT © Karan Sharma `LICENSE included here <LICENSE>`__

.. |GitHub license| image:: https://img.shields.io/badge/license-MIT-blue.svg
:target: https://raw.githubusercontent.com/mr-karan/kiteHistory/master/LICENSE
.. |saythanks| image:: https://img.shields.io/badge/say-thanks-ff69b4.svg
:target: https://saythanks.io/to/mr-karan
.. |asciicast| image:: https://asciinema.org/a/.png
:target: https://asciinema.org/a/

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
kitehistory-1.5.tar.gz (7.1 kB) Copy SHA256 hash SHA256 Source None Feb 13, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page