{"id":13510832,"url":"https://github.com/jmfernandes/robin_stocks","last_synced_at":"2025-05-13T17:04:49.306Z","repository":{"id":41366172,"uuid":"122554275","full_name":"jmfernandes/robin_stocks","owner":"jmfernandes","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","archived":false,"fork":false,"pushed_at":"2025-01-19T19:17:32.000Z","size":8435,"stargazers_count":1840,"open_issues_count":290,"forks_count":497,"subscribers_count":85,"default_branch":"master","last_synced_at":"2025-04-24T01:51:16.284Z","etag":null,"topics":["cryptocurrency","options-trading","quantitative-finance","robinhood","robinhood-api","robinhood-portfolio","robinhood-python","stock-market","stock-trading","trading","trading-algorithms","trading-api"],"latest_commit_sha":null,"homepage":"http://www.robin-stocks.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmfernandes.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-23T00:49:37.000Z","updated_at":"2025-04-22T09:31:52.000Z","dependencies_parsed_at":"2024-06-18T13:31:55.869Z","dependency_job_id":"0fb7d59f-b8ad-4ab3-b288-c5f14f1e4cc5","html_url":"https://github.com/jmfernandes/robin_stocks","commit_stats":{"total_commits":525,"total_committers":56,"mean_commits":9.375,"dds":"0.24190476190476196","last_synced_commit":"e93512ac0d0b835157ea57aab083c068435aa68c"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmfernandes%2Frobin_stocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmfernandes%2Frobin_stocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmfernandes%2Frobin_stocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmfernandes%2Frobin_stocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmfernandes","download_url":"https://codeload.github.com/jmfernandes/robin_stocks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253990460,"owners_count":21995774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptocurrency","options-trading","quantitative-finance","robinhood","robinhood-api","robinhood-portfolio","robinhood-python","stock-market","stock-trading","trading","trading-algorithms","trading-api"],"created_at":"2024-08-01T02:01:55.858Z","updated_at":"2025-05-13T17:04:49.239Z","avatar_url":"https://github.com/jmfernandes.png","language":"Python","funding_links":[],"categories":["Python","trading-algorithms"],"sub_categories":[],"readme":".. image:: docs/source/_static/pics/title.PNG\n\nRobin-Stocks API Library\n========================\nThis library provides a pure Python interface that interacts with the Robinhood API, Gemini API,\nand TD Ameritrade API. The code is simple to use, easy to understand, and easy to modify.\nWith this library, you can view information on stocks, options, and crypto-currencies in real-time, \ncreate your own robo-investor or trading algorithm, and improve your programming skills.\n\nTo 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\n\nSupported APIs\n==============\nThe supported APIs are Robinhood, Gemini, and TD Ameritrade. For more information about how to use the different APIs, visit the README\ndocuments for `Robinhood Documentation`_, `Gemini Documentation`_, and `TDA Documentation`_.\n\nBelow are examples of how to call each of those modules.\n\n\u003e\u003e\u003e import robin_stocks.robinhood as rh\n\u003e\u003e\u003e import robin_stocks.gemini as gem\n\u003e\u003e\u003e import robin_stocks.tda as tda\n\u003e\u003e\u003e # Here are some example calls\n\u003e\u003e\u003e gem.get_pubticker(\"btcusd\") # gets ticker information for Bitcoin from Gemini\n\u003e\u003e\u003e rh.get_all_open_crypto_orders() # gets all cypto orders from Robinhood\n\u003e\u003e\u003e tda.get_price_history(\"tsla\") # get price history from TD Ameritrade \n\nContributing\n============\nIf you would like to contribute to this project, follow our contributing guidelines `Here \u003chttps://github.com/jmfernandes/robin_stocks/blob/master/contributing.md\u003e`_.\n\nAutomatic Testing\n^^^^^^^^^^^^^^^^^\n\nIf 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:\n\n\u003e\u003e\u003e pip install pytest\n\u003e\u003e\u003e pip install pytest-dotenv\n\nYou 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:\n\n\u003e\u003e\u003e pytest\n\nto run all the tests. If you would like to run specific tests or run all the tests in a specific class then type:\n\n\u003e\u003e\u003e pytest tests/test_robinhood.py -k test_name_apple # runs only the 1 test\n\u003e\u003e\u003e pytest tests/test_gemini.py -k TestTrades # runs every test in TestTrades but nothing else\n\nFinally, if you would like the API calls to print out to terminal, then add the -s flag to any of the above pytest calls.\n\n\nInstalling\n========================\nThere is no need to download these files directly. This project is published on PyPi,\nso it can be installed by typing into terminal (on Mac) or into command prompt (on PC):\n\n\u003e\u003e\u003e pip install robin_stocks\n\nAlso be sure that Python 3 is installed. If you need to install python you can download it from `Python.org \u003chttps://www.python.org/downloads/\u003e`_.\nPip 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 \u003chttps://pypi.org/project/pip/\u003e`_.\n\nIf you would like to be able to make changes to the package yourself, clone the repository onto your computer by typing into the terminal or command prompt:\n\n\u003e\u003e\u003e git clone https://github.com/jmfernandes/robin_stocks.git\n\u003e\u003e\u003e cd robin_stocks\n\nNow that you have cd into the repository you can type\n\n\u003e\u003e\u003e pip install .\n\nand this will install whatever you changed in the local files. This will allow you to make changes and experiment with your own code.\n\nList of Functions and Example Usage\n===================================\n\nFor a complete list of all Robinhood API functions and what the different parameters mean, \ngo to `robin-stocks.com Robinhood Page \u003chttp://www.robin-stocks.com/en/latest/robinhood.html\u003e`_. If you would like to\nsee some example code and instructions on how to set up two-factor authorization for Robinhood,\ngo to the `Robinhood Documentation`_.\n\nFor a complete list of all TD Ameritrade API functions and what the different parameters mean, \ngo to `robin-stocks.com TDA Page \u003chttp://www.robin-stocks.com/en/latest/tda.html\u003e`_. For detailed instructions on \nhow to generate API keys for TD Ameritrade and how to use the API, go to the `TDA Documentation`_.\n\nFor a complete list of all Gemini API functions and what the different parameters mean, \ngo to `robin-stocks.com Gemini Page \u003chttp://www.robin-stocks.com/en/latest/gemini.html\u003e`_. For detailed instructions on \nhow to generate API keys for Gemini and how to use both the private and public API, go to the `Gemini Documentation`_.\n\n.. _Robinhood Documentation: Robinhood.rst\n.. _Gemini Documentation: gemini.rst\n.. _TDA Documentation: tda.rst\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmfernandes%2Frobin_stocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmfernandes%2Frobin_stocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmfernandes%2Frobin_stocks/lists"}