Need help with robin_stocks?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

jmfernandes
1.0K Stars 261 Forks MIT License 507 Commits 109 Opened issues

Description

This is a library to use with Robinhood Financial App. It currently supports trading crypto-currencies, options, and stocks. In addition, it can be used to get real time ticker information, assess the performance of your portfolio, and can also get tax documents, total dividends paid, and more. More info at

Services available

!
?

Need anything else?

Contributors list

.. image:: docs/source/_static/pics/title.PNG

Robin-Stocks API Library

This library provides a pure python interface to interact with the Robinhood API, Gemini API, and TD Ameritrade API. The code is simple to use, easy to understand, and easy to modify. With this library you can view information on stocks, options, and crypto-currencies in real time, create your own robo-investor or trading algorithm, and improve your programming skills.

To join our Slack channel where you can discuss trading and coding, click the link https://join.slack.com/t/robin-stocks/shared_invite/zt-7up2htza-wNSil5YDa3zrAglFFSxRIA

Supported APIs

The supported APIs are Robinhood, Gemini, and TD Ameritrade. For more information about how to use the different APIs, visit the README documents for

Robinhood Documentation
,
Gemini Documentation
, and
TDA Documentation
_.

Below are examples on how to call each of those modules.

import robinstocks.robinhood as rh import robinstocks.gemini as gem import robin_stocks.tda as tda

Here are some example calls

gem.getpubticker("btcusd") # gets ticker information for Bitcoin from Gemini rh.getallopencryptoorders() # gets all cypto orders from Robinhood tda.getprice_history("tsla") # get price history from TD Ameritrade

Contributing

If you would like to contribute to this project, follow our contributing guidelines

Here 
_.

Automatic Testing ^^^^^^^^^^^^^^^^^

If you are contributing to this project and would like to use automatic testing for your changes, you will need to install pytest and pytest-dotenv. To do this type into terminal or command prompt:

pip install pytest pip install pytest-dotenv

You will also need to fill out all the fields in .test.env. I recommend that you rename the file as .env once you are done adding in all your personal information. After that, you can simply run:

pytest

to run all the tests. If you would like to run specific tests or run all the tests in a specific class then type:

pytest tests/testrobinhood.py -k testnameapple # runs only the 1 test pytest tests/testgemini.py -k TestTrades # runs every test in TestTrades but nothing else

Finally, if you would like the API calls to print out to terminal, then add the -s flag to any of the above pytest calls.

Installing

There is no need to download these files directly. This project is published on PyPi, so it can be installed by typing into terminal (on Mac) or into command prompt (on PC):

pip install robin_stocks

Also be sure that Python 3 is installed. If you need to install python you can download it from

Python.org 
. Pip is the package installer for python, and is automatically installed when you install python. To learn more about Pip, you can go to
PyPi.org 
.

If you would like to be able to make changes to the package yourself, clone the repository onto your computer by typing into terminal or command prompt:

git clone https://github.com/jmfernandes/robinstocks.git cd robinstocks

Now that you have cd into the repository you can type

pip install .

and this will install whatever you changed in the local files. This will allow you to make changes and experiment with your own code.

List of Functions and Example Usage

For a complete list of all Robinhood API functions and what the different parameters mean, go to

robin-stocks.com Robinhood Page 
. If you would like to see some example code and instructions on how to set up two-factor authorization for Robinhood, go to the
Robinhood Documentation
.

For a complete list of all TD Ameritrade API functions and what the different parameters mean, go to

robin-stocks.com TDA Page 
. For detailed instructions on how to generate API keys for TD Ameritrade and how to use the API, go to the
TDA Documentation
.

For a complete list of all Gemini API functions and what the different parameters mean, go to

robin-stocks.com Gemeni Page 
. For detailed instructions on how to generate API keys for Gemini and how to use both the private and public API, go to the
Gemini Documentation
.

.. _Robinhood Documentation: Robinhood.rst .. _Gemini Documentation: gemini.rst .. _TDA Documentation: tda.rst

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.