robinhood-yolo

NodeJS API wrapper for Robinhood Options trading and CLI to trade from your terminal

0.5.2
latest
Source
npm

Version published: 3 years ago

Weekly downloads: 7; decreased by-30%

Maintainers: 1

Weekly downloads

Created: 5 years ago

Source

Robinhood Yolo

Robinhood Options API written in Coffeescript and console CLI w/ included account history, positions watch, etc. ☕

CLI Help

NOTE: The Robinhood API is not officially supported and is subject to change at any time. This package is also not actively maintained, so please ensure tests continue to pass before use, and use at your own risk.

Install

To use the CLI
- npm i -g robinhood-yolo
- Updating
  - npm i -g robinhood-yolo@latest
To use the API in your project
- npm i -S robinhood-yolo
- Updating
  - npm i -S robinhood-yolo@latest

CLI Usage

$ yolo -h

Setup

Add account
```
$ yolo -c add_account
```
- Requires username, password, and device token
  - To retrieve device token, log into Robinhood in a browser and run the following command
```
x=document.getElementsByTagName('script');for(i of x){y=i.innerText.match(/(?<=clientId: ").[^"]+/);if(y!=null){console.log(y[0])}}
```
    - The output will be your device token, save this
  - Enter your credentials in the prompt
- Confirm account is added
```
$ yolo -c show_accounts
```

CLI Commands

Use flag -c to enter a command
Use additional flags for command arguments
Examples
- dashboard
  - Shows robinhood dashboard
```
$ yolo -c dashboard
```
- trades
  - Shows profits/losses from all trades
```
$ yolo -c trades
```
- watch
  - Watch current positions with statistics/metrics
```
$ yolo -c watch
```
- DEPRECATED: stop_loss
  - Enable adaptive stop loss on open positions.
    - NOTE: this can prevent gains or could cause poor fills if used too close to market open, warnings are put in place to prevent this, but please use at own risk
    - Stops max loss after 20% loss on option price
    - If option is between 10%-20% gains, stop loss will preserve gains and will sell if price drops to $0.01 over original buy price
    - If option is greater than 20% gains, stop loss will sell after a 20% loss from the high price after the option was purchased
  - Use stop_loss_sim command to get printouts ONLY, no orders will be placed
```
# Stop Loss (places orders)
$ yolo -c stop_loss
# Stop Loss Simulation (printouts only, no orders placed)
$ yolo -c stop_loss_sim
```
- quote
  - Get quote for stock symbol
```
$ yolo -c quote --ticker TSLA
```
- position
  - Show details on open positions and unfilled orders
```
$ yolo -c positions
```
- find
  - Find option contracts
  - Find single contract
    - To find a TSLA call expiring 2019-07-19 that is the current 2nd out of the money option (depth is 0-based)
```
$ yolo -c find --ticker TSLA --expiry 2019-07-19 --option_type call --strike_type otm --depth 1
```
  - Find range of contracts
    - To find the current 3 otm and 3 itm call options expiring 2019-07-19 (6 total)
```
$ yolo -c find --ticker TSLA --expiry 2019-07-19 --option_type call --range 3
```
- buy
  - Buy option
```
$ yolo -c buy --url OPTION_URL_HERE --quantity X_CONTRACTS_HERE --price X_PRICE_PER_CONTRACT_HERE
```
- sell
  - Sell option
```
$ yolo -c sell --url OPTION_URL_HERE --quantity X_CONTRACTS_HERE --price X_PRICE_PER_CONTRACT_HERE
```
- replace
```
$ yolo -c replace --id ORDER_ID_HERE --quantity X_CONTRACTS_HERE --price X_PRICE_PER_CONTRACT_HERE
```
  - order id can be found with the position command. Replaceable orders will be listed under Unfilled Orders
- cancel
```
$ yolo -c cancel --url CANCEL_URL_HERE
```
  - cancel url can be found with the position command. Cancelable orders will be listed under Unfilled Orders
- show_accounts
  - Shows accounts in config
```
$ yolo -c show_accounts
```
- add_account
  - Adds account to config
```
$ yolo -c add_account
```
- edit_account
  - Edits account in config
```
$ yolo -c edit_account
```
- delete_account
  - Deletes account from config
```
$ yolo -c delete_account
```

API Usage

// Uses CLI local data, account(s) need to be added via CLI before first use then credentials persist
api = require('robinhood-yolo')()
// You can also manage your own data elsewhere and the API will not automatically persist data as follows
api = require('robinhood-yolo')({
	configData: {
		d_t: 'BASE64_ENCODED_DEVICE_TOKEN_HERE',
		u_n: 'BASE64_ENCODED_PASSWORD_HERE',
		p_w: 'BASE64_ENCODED_USERNAME_HERE',
		a_t: 'ROBINHOOD_ACCESS_TOKEN_HERE',
		r_t: 'ROBINHOOD_REFRESH_TOKEN_HERE',
		a_b: 'ROBINHOOD_BEARER_TOKEN_HERE',
		t_s: 'ROBINHOOD_LOGIN_TIMESTAMP_HERE'
	}
})

Initialization
```
api = require('robinhood-yolo')({ newLogin: true, configIndex: 0, configData: null, print: true })
```
- Optional args
  - newLogin (boolean)
    - if true does new login request, else uses stored auth token for quicker login
  - configIndex (int)
    - user index in config file (for multi-user use, does not apply if configData is defined)
  - configData (object)
    - By default CLI stores account data with no dependencies, allowing users to login with no credentials after adding the account details
    - If configData arg is null or undefined, credentials will need to be added before using API with yolo -c add_account
    - Else, configData expects object for login data as follows
      - d_t: Device token (Base64 encoded)
      - u_n: Username (Base64 encoded)
      - p_w: Password (Base64 encoded)
      - a_t: Robinhood access token
      - r_t: Robinhood refresh token
      - a_b: Robinhood bearer token
      - t_s: Login timestamp
      - a_u: Account URL
      - a_i: Account ID
  - print (boolean)
    - If false, will skip optional print statements in functions, else will print all info
- Returns true if configData is null/undefined, else returns configData object with updated values
login()
```
await api.login({ newLogin: true, configIndex: 0 })
```
- Logs user into Robinhood
- Optional args
  - newLogin (boolean)
    - if true does new login request, else uses stored auth token for quicker login
  - configIndex (int)
    - user index in config file (for multi-user use)
  - Must be called before using login-only methods, overrides initialization args
getAccount()
```
await api.getAccount()
```
- Gets account info
- Returns dict
- Optional args
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
getPortfolioInfo()
```
await api.getPortfolioInfo()
```
- Gets portfolio Info
- Returns dict
getAccountEquity()
```
await api.getAccountEquity()
```
- Gets account Equity
- Returns number
getCashBalance()
```
await api.getCashBalance()
```
- Gets Robinhood Cash Balance
- Returns number
getTransfers()
```
await api.getTransfers()
```
- Gets account bank transfers
- Returns list
- Optional args * consume (boolean) * if true returns all pages of data, else returns first page of data
getMarketHours()
```
await api.getMarketHours('2019-07-19')
```
- Gets Market Hours info for date
- Required args
  - date (string)
getWatchList()
```
await api.getWatchList({ watchList: 'Default', instrumentData: false, quoteData: false })
```
- Gets Watch List items
- Optional args
  - watchList (string)
    - Watch list name
  - instrumentData (boolean)
    - if true includes instrument data
  - quoteData (boolean)
    - if true includes quote data
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
quotes()
```
await api.quotes('TSLA')
await api.quotes('TSLA', { chainData: false })
```
- Gets quotes for single ticker or list of tickers
- Returns dict for single ticker, list for list of tickers
- Required args
  - ticker(s) (string || array)
- Optional args
  - chainData (boolean)
    - If false does not include chain data, else includes chain data
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
historicals()
```
await api.historicals('TSLA')
await api.historicals('TSLA', { span: 'year', bounds: 'regular' })
```
- Gets historical quotes for single ticker or list of tickers
- Returns dict for single ticker, list for list of tickers
- Required args
  - ticker(s) (string || array)
- Optional args
  - span (string)
    - time span (see src/endpoints.coffee for allowed interval/span combinations)
  - bounds (string)
getOptions()
```
await api.getOptions('TSLA', '2019-07-19')
await api.getOptions('TSLA', '2019-07-19', { optionType: 'call', marketData: false, expired: false })
```
- Gets list of available options for ticker
- Returns list
- Required args
  - symbol (string)
  - expirationDate (string)
- Optional args
  - optionType (string)
    - call || put
  - marketData (boolean)
    - If false does not include market data, otherwise includes market data
  - expired (boolean)
    - if true includes expired options in search, else excludes expired options
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
findOptions()
```
await api.findOptions('TSLA', '2019-07-19')
await api.findOptions('TSLA', '2019-07-19', { optionType: 'call', strikeType: 'itm', strikeDepth: 0, marketData: false, range: null, strike: null, expired: false })
```
- Finds options by args
- Either returns a list of a range of options, or a single option dict
- Required args
  - symbol (string)
  - expirationDate (string)
- Optional args
  - optionType (string)
    - call || put
  - marketData (boolean)
    - If false does not include market data, otherwise includes market data
  - strikeType (string)
    - itm || otm
  - strikeDepth (int)
    - strike price depth, 0-based
  - range (int)
    - if not null, will return list of range. For example, if range equals 3, 3 otm and 3 itm options will be returned
  - strike (Number)
    - if not null, will return option at exact strike price
  - expired (boolean)
    - if true includes expired options in search, else excludes expired options
findOptionsHistoricals()
```
await api.findOptionsHistoricals('TSLA', '2019-07-19')
await api.findOptionsHistoricals('TSLA', '2019-07-19', { optionType: 'call', strikeType: 'itm', strikeDepth: 0, strike: null, expired: true, span: 'month' })
```
- Finds option historical data
- Returns list of data
- Required args
  - symbol (string)
  - expirationDate (string)
- Optional args
  - optionType (string)
    - call || put
  - strikeType (string)
    - itm || otm
  - strikeDepth (int)
    - strike price depth, 0-based
  - strike (Number)
    - if not null, will return option at exact strike price
  - expired (boolean)
    - if true includes expired options in search, else excludes expired options
  - span (string)
    - time span (see src/endpoints.coffee for allowed interval/span combinations)
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
optionsPositions()
```
await api.optionsPositions()
await api.optionsPositions({ marketData: false, orderData: false, openOnly: true, notFilled: false })
```
- Gets list of options positions
- Returns list
- Optional args
  - marketData (boolean)
    - If false does not include market data, otherwise includes market data
  - orderData (boolean)
    - If false does not include order data, otherwise includes order data
  - openOnly (boolean)
    - If true includes open positions only, if false includes all positions
  - notFilled (boolean)
    - If true includes unfilled positions, if false excludes unfilled positions
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
optionsOrders()
```
await api.optionsOrders()
await api.optionsOrders({ urls: null, id: null, notFilled: false, buyOnly: false })
```
- Returns list of options orders
- Optional args
  - urls (list)
    - If not null, gets orders from list of option order urls
  - id (string)
    - If not null, gets order by id
  - notFilled (boolean)
    - If true includes unfilled orders, if false excludes unfilled orders
  - buyOnly (boolean)
    - Only include buy orders if true, else include all
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
stockOrders()
```
await api.stockOrders()
```
- Returns list of stock orders
- Optional args
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
getHistory()
```
await api.getHistory({ options: true, stocks: true, banking: true, consume: true })
```
- Returns formatted list of transactions, including options, stocks, and bank transactions
- Optional args
  - options (boolean)
    - if true gets options data
  - stocks (boolean)
    - if true gets stocks data
  - banking (boolean)
    - if true gets bank transactions data
  - consume (boolean)
    - if true returns all pages of data, else returns first page of data
placeOptionOrder()
```
await api.placeOptionOrder('OPTION_URL_HERE', 1.0, 0.53)
await api.placeOptionOrder('OPTION_URL_HERE', 1.0, 0.53, { direction: 'debit', side: 'buy', positionEffect: 'open', legs: null })
```
- Places option order, returns order confirmation
- Required args
  - option (string)
    - option url
  - quantity (int)
  - price (Number)
    - Price for one contract
- Optional args
  - direction (string)
    - debit || credit
  - side (string)
    - buy || sell
  - positionEffect (string)
    - open || close
  - legs (array)
    - order legs, if not null, other args will be ignored and legs will be used instead
cancelOptionOrder()
```
await api.cancelOptionOrder('CANCEL_URL_HERE')
```
- Cancels option order
- Required args
  - cancelUrl (string)
replaceOptionOrder()
```
await api.replaceOptionOrder(1.0, 0.53, { orderId: 'ORDER_ID_HERE' })
```
- Replaces option order
- Required args
  - quantity (int)
  - price (Number)
    - Price for one contract
- Optional args (must use order || orderId)
  - order (dict)
    - order object, information will be extracted from order object to replace order
  - orderId (string)
    - will get data from order id to replace order

Change Log

v0.4.5
- Deprecated stop_loss and stop_loss_sim from CLI
- Moved config data location from ~/node_json_db/ > ~/.json_config/robinhood/
- Cut down package size with by replacing lodash/uuid with only necessary sub-modules
v0.5.0
- consume: false now returns data as object instead of data.results and pagination info
v0.5.1
- getTransfers() method changed to reflect new cashier.robinhood.com endpoint
- tests updated and all passing
v0.5.2
- getCashBalance() method added

Contributing

To contribute, please submit a pull request!
If making changes to the API, run npm run test and confirm all tests are working
Include tests for new methods in src/tests/test.coffee
NOTE: If the method actually buys or sells anything, please add test logic to ensure testing is only allowed AFTER market close, do not allow tests before market open to ensure a queued order isn't accidentally filled. Please also ensure that the test amounts are ridiculous bids/asks that could not possibly be filled anyways, I.E. a deep-itm AMZN option for $0.01.

Keywords

FAQs

What is robinhood-yolo?

Is robinhood-yolo popular?

Is robinhood-yolo well maintained?

Package last updated on 05 Jul 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install