Robinhood

Robinhood API Docs — CLI reference browser for Robinhood Trade unofficial private REST API documentation with endpoint exploration, authentication flow reference, order management, market data retrieval, portfolio queries, and Rich terminal interface for trading API research

 _______             __        __            __                                  __
/       \           /  |      /  |          /  |                                /  |
$$$$$$$  |  ______  $$ |____  $$/  _______  $$ |____    ______    ______    ____$$ |
$$ |__$$ | /      \ $$      \ /  |/       \ $$      \  /      \  /      \  /    $$ |
$$    $$< /$$$$$$  |$$$$$$$  |$$ |$$$$$$$  |$$$$$$$  |/$$$$$$  |/$$$$$$  |/$$$$$$$ |
$$$$$$$  |$$ |  $$ |$$ |  $$ |$$ |$$ |  $$ |$$ |  $$ |$$ |  $$ |$$ |  $$ |$$ |  $$ |
$$ |  $$ |$$ \__$$ |$$ |__$$ |$$ |$$ |  $$ |$$ |  $$ |$$ \__$$ |$$ \__$$ |$$ \__$$ |
$$ |  $$ |$$    $$/ $$    $$/ $$ |$$ |  $$ |$$ |  $$ |$$    $$/ $$    $$/ $$    $$ |
$$/   $$/  $$$$$$/  $$$$$$$/  $$/ $$/   $$/ $$/   $$/  $$$$$$/   $$$$$$/   $$$$$$$/

CLI reference browser for Robinhood Trade's unofficial private API documentation

Features · Getting Started · Configuration · Usage · FAQ

---

Registration & Official Links

#	Resource	Link
1	Robinhood Official Platform	robinhood.com
2	Robinhood Crypto Docs	docs.robinhood.com/crypto/trading
3	Original API Documentation (sanko)	github.com/sanko/Robinhood
4	pyrh — Python Robinhood Library	pyrh.readthedocs.io
5	GitHub Discussions	github.com/sanko/Robinhood/discussions

---

Features

API Documentation Sections
Introduction & API Overview Authentication (OAuth, tokens, MFA) Banking (ACH, deposits, withdrawals) Order (buy/sell, cancel, history) Options (chains, orders, positions) Quote (real-time stock prices) Fundamentals (company data) Instrument (symbol lookup)	Watchlist (create, manage, symbols) Account (portfolio, user info) Settings (notifications, 2FA, privacy) Markets (exchange info, hours) Referrals (referral program) Statistics (social endpoints) Tags (categorization) Unsorted (miscellaneous endpoints)
Interface & UX
Rich terminal UI with panels & tables ASCII art header with green theme 18 navigable menu options	Markdown rendering in terminal Endpoint reference tables Cross-platform (Windows / Linux / macOS)

---

Getting Started

Prerequisites

Requirement	Version	Purpose
Python	3.8+	Runtime
pip	latest	Package manager

Installation

Windows (One-Click)

Double-click run.bat to launch:

@echo off
chcp 65001 > nul
cd /d "%~dp0"
python main.py
pause

Manual Setup (All Platforms)

git clone <repository-url>
cd Robinhood
pip install -r requirements.txt
python main.py

Dependency Table

Package	Version	Purpose
rich	>=13.0.0	Terminal UI — panels, tables, markdown rendering
requests	>=2.28.0	HTTP requests (optional for live API calls)

---

Configuration

This application is a documentation browser and requires no configuration files. All API endpoint information is embedded in the source code.

Authentication Context

The documented API uses token-based authentication:

Authorization: Token <your_40_character_token>

Auth Level	Description	Example Endpoints
None	No auth required	Quotes, instrument lookup
Token	Requires auth header	Orders, account, banking

API Base URL

https://api.robinhood.com/

---

Usage

Run the application:

python main.py

CLI Menu

┌────┬──────────────────────┬─────────────────────────────────┐
│  # │ Option               │ Description                     │
├────┼──────────────────────┼─────────────────────────────────┤
│  1 │ Install Dependencies │ Install rich, requests          │
│  2 │ Settings             │ Notifications and account       │
│  3 │ About                │ Project info and hashtags       │
│  4 │ Introduction         │ API overview and security       │
│  5 │ Authentication       │ Login, tokens, password recovery│
│  6 │ Banking              │ Bank accounts & ACH transfers   │
│  7 │ Order                │ Placing, cancelling, listing    │
│  8 │ Options              │ Options related endpoints       │
│  9 │ Quote                │ Stock quotes                    │
│ 10 │ Fundamentals         │ Basic fundamental data          │
│ 11 │ Instrument           │ Financial instruments reference │
│ 12 │ Watchlist            │ Watchlists management           │
│ 13 │ Account              │ User and account information    │
│ 14 │ Markets              │ Exchange info                   │
│ 15 │ Referrals            │ Account referrals               │
│ 16 │ Statistics           │ Social/statistical endpoints    │
│ 17 │ Tags                 │ Categorizing endpoints          │
│ 18 │ Unsorted             │ Unorganized endpoints           │
│  0 │ Exit                 │ Quit application                │
└────┴──────────────────────┴─────────────────────────────────┘

API Sections Quick Reference

Section	Key Endpoints	Auth Required
Authentication	/api-token-auth/, /api-token-logout/	No (login) / Token (logout)
Banking	/ach/transfers/, /ach/relationships/	Token
Order	/orders/, /orders/{id}/cancel/	Token
Options	/options/chains/, /options/orders/	Token
Quote	/quotes/{symbol}/	None
Fundamentals	/fundamentals/{symbol}/	None
Instrument	/instruments/, /instruments/{id}/	None
Watchlist	/watchlists/	Token
Account	/accounts/, /portfolios/	Token
Markets	/markets/{mic}/	None

---

Project Structure

Robinhood/
├── main.py              # Entry point — Rich CLI, API section browsers, menu loop
├── run.bat              # Windows one-click launcher
├── requirements.txt     # Python dependencies (rich, requests)
└── about/
    ├── about.md         # Project description, hashtags, API overview table
    └── hashtags.txt     # Tag collection for discovery

---

FAQ

What is this project?

This is a CLI documentation browser for Robinhood's unofficial private API. It is based on the sanko/Robinhood repository (1.7k+ stars) which reverse-engineered Robinhood Trade's internal REST API endpoints. The tool presents this documentation in an interactive terminal interface.

Does this tool execute real trades?

No. This is a read-only documentation browser. It does not connect to Robinhood's API, does not store credentials, and does not execute any trades. It simply displays API endpoint documentation in a Rich terminal UI.

What is the Robinhood private API?

Robinhood uses an internal REST API over HTTPS for all client-server communication. This API is not officially documented for third-party use. The sanko/Robinhood project reverse-engineered these endpoints including authentication flows (OAuth2, MFA), order placement, banking, and market data retrieval.

Is using the Robinhood API legal?

Accessing the API programmatically may violate Robinhood's Terms of Service. This tool is for educational and research purposes only. Always review Robinhood's current ToS before interacting with their API directly.

How do I get a Robinhood API token?

According to the documented API, you POST credentials to /api-token-auth/ to receive a 40-character token. This token is then included as Authorization: Token <token> in subsequent requests. MFA-enabled accounts require additional steps documented in the Authentication section.

Can I use pyrh instead?

Yes. pyrh is a Python framework built on the same unofficial API that provides a higher-level interface for authentication, quote retrieval, and trading. It can be installed via pip install pyrh.

---

Disclaimer

This software is provided for educational and research purposes only. It documents an unofficial, reverse-engineered API. Use of the Robinhood API outside of official channels may violate Robinhood's Terms of Service. The developers are not affiliated with Robinhood Markets, Inc. and assume no liability for any consequences of API usage.

---

If this tool helped you, consider giving it a ⭐

Based on sanko/Robinhood — Unofficial Documentation of Robinhood Trade's Private API

Back to Top