StockStream surfaces data about what stocks have been bought and sold in the Robinhood account as well as who voted for which stock each round. An up-to-date snapshot of the portfolio is available as well. Please see the below documentation for accessing these APIs.
If you have any comments, questions or suggestions about the API or StockStream in general, please join the #development channel in the StockStream Discord
The Orders API surfaces all the orders placed on Robinhood, and their current state. You can use this API to get orders by date, by symbol or by id.
- date: To query by date, you must pass the date in the format: yyyy-MM-dd. The earliest possible date is 2017-05-30.
- symbol: To query by symbol you must pass the symbol in uppercase.
- id_list: To query by id you must pass the list of id's, separated by comma.
- id: The ID is represented by a SHA1 hash and has no meaning other than to uniquely identify this order.
- created_at: The timestamp that this order was placed in the format.
- symbol: The ticker symbol of the stock or ETF that was purchased or sold.
- side: Identifies whether this was a purchase or a sale. Can be either buy or sell.
- state: The state of the order. Can be queued, unconfirmed, confirmed, partially_filled, filled, rejected, cancelled, or failed.
- price: The average price of the paid or sale value.
- quantity: The number of shares purchased.
- timestamp: The approximate time stamp that the order was created.
- executions (optional): Executions may be attached to some orders. These represent executions of the order.
- quantity: The number of shares bought or sold in the execution.
- timestamp: The timestamp of the execution in UTC.
The Votes API surfaces the voting choices for each player for each round. This API can be queried by player or by date.
- date To query by date, you must pass the date in the format: MM-dd-yyyy. For example: 07-25-2017
- player To query by player you must pass the lowercase username prefixed by twitch:. For example: twitch:stockstream
- orderId To query by orderId you must pass the id in lowercase. Order ID's can be retrieved from the Order API below.
- username: The username of the player that voted, prefixed by the platform. Currently only twitch is supported.
- date: The date that this order was place in the format: MM/dd/yyyy. The earliest possible date is 05-30-2017.
- action: The action which the user voted for. Can be either BUY or SELL.
- parameter: The symbol which the user voted to buy or sell.
- timestamp: The approximate time stamp that the round of voting ended.
- orderId (optional): If this vote influenced an order, the id of the order will be included in the vote structure.
You can get the current snapshots by hitting the following endpoint.
To access historical snapshots, you must first query a date to get a list of the timestamps, then query that timestamp to access the snapshots.
- date: The date the portfolio snapshots were recorded: MM-dd-yyyy. The earliest possible date is 06-01-2017.
- timestamp: The timestamp selected from the list returned by the date query. This timestamp represents the approximate GMT time the portfolio snapshot was generated.
Below are some truncated data examples:
- cashBalance: The amount of spendable cash available.
- spentMargin: The amount of money borrowed from Robinhood.
- assets: The list of assets held in the portfolio:
- symbol: The ticker symbol of the stock held.
- shares: The number of shares held of that stock.
- avgCost: The average cost per share.