Streaming changes according to Schwab_Trader_API_-_Streamer_Guide.pdf (#127)

* Field names changed according documentation

* Documentation changed to reflect function name changes for NYSE_BOOK service

* Changes as requested in the second round of comments from @alexgolec

* TIMESALE_EQUITY, TIMESALE_FUTURES, TIMESALE_OPTIONS and NEWS_HEADLINE services removed because aren't supported by Schwab

* Added support for SCREENER_EQUITY and SCREENER_OPTION services.

* Added LOGOUT and ADD functions on level one and book services.

* Minor fixes requested by @alexgolec

Author: jacabreragt

docs/streaming.rst

@@ -76,6 +76,15 @@ exception.
 .. automethod:: schwab.streaming.StreamClient.login
 
 
+-----------
+Logging Out
+-----------
+
+For a clean exit, it's recommended to log out of the stream when you're done.
+
+.. automethod:: schwab.streaming.StreamClient.logout
+
+
 ----------------------
 Subscribing to Streams
 ----------------------
@@ -96,14 +105,24 @@ subscription methods again seems to clear the old subscription and create a new
 one. Note this behavior is not officially documented, so this interpretation may 
 be incorrect.
 
+
+----------------------
+Add symbols to Streams
+----------------------
+
+These functions have names that follow the pattern ``SERVICE_NAME_add``.
+These functions send a request to add to the list of subscribed symbols for a
+particular data stream.
+
+
 -------------------------
 Un-Subscribing to Streams
 -------------------------
 
-These functions have names that follow the pattern ``SERVICE_NAME_unsubs``.  
-These functions send a request to disable the symbols of a streaming data for a 
-particular data stream. They are *not* thread safe, so they should only be 
-called in series. When unsubscribing to services with symbols, symbols which 
+These functions have names that follow the pattern ``SERVICE_NAME_unsubs``.
+These functions send a request to disable the symbols of a streaming data for a
+particular data stream. They are *not* thread safe, so they should only be
+called in series. When unsubscribing to services with symbols, symbols which
 were not explicitly unsubscribed remain subscribed.
 
 
@@ -224,12 +243,15 @@ to our `Discord server <https://discord.gg/BEr6y6Xqyv>`__. We'll be updating
 this page as we discover new things.
 
 The following streams are confirmed working:
- * :ref:`equity_charts`
- * :ref:`level_one_quotes_stream`
- * :ref:`level_one_option_stream`
+ * :ref:`charts`
+ * :ref:`level_one`
  * :ref:`level_two`
+ * :ref:`screener`
+ * :ref:`account_activity`
 
 
+.. _charts:
+
 ++++++++++++
 OHLCV Charts
 ++++++++++++
@@ -293,6 +315,7 @@ Level one quotes for equities traded on NYSE, AMEX, and PACIFIC.
 
 .. automethod:: schwab.streaming::StreamClient.level_one_equity_subs
 .. automethod:: schwab.streaming::StreamClient.level_one_equity_unsubs
+.. automethod:: schwab.streaming::StreamClient.level_one_equity_add
 .. automethod:: schwab.streaming::StreamClient.add_level_one_equity_handler
 .. autoclass:: schwab.streaming::StreamClient.LevelOneEquityFields
   :members:
@@ -311,12 +334,15 @@ available option symbols.
 
 .. automethod:: schwab.streaming::StreamClient.level_one_option_subs
 .. automethod:: schwab.streaming::StreamClient.level_one_option_unsubs
+.. automethod:: schwab.streaming::StreamClient.level_one_option_add
 .. automethod:: schwab.streaming::StreamClient.add_level_one_option_handler
 .. autoclass:: schwab.streaming::StreamClient.LevelOneOptionFields
   :members:
   :undoc-members:
 
 
+.. _level_one_futures_stream:
+
 --------------
 Futures Quotes
 --------------
@@ -325,25 +351,14 @@ Level one quotes for futures.
 
 .. automethod:: schwab.streaming::StreamClient.level_one_futures_subs
 .. automethod:: schwab.streaming::StreamClient.level_one_futures_unsubs
+.. automethod:: schwab.streaming::StreamClient.level_one_futures_add
 .. automethod:: schwab.streaming::StreamClient.add_level_one_futures_handler
 .. autoclass:: schwab.streaming::StreamClient.LevelOneFuturesFields
   :members:
   :undoc-members:
 
 
-------------
-Forex Quotes
-------------
-
-Level one quotes for foreign exchange pairs.
-
-.. automethod:: schwab.streaming::StreamClient.level_one_forex_subs
-.. automethod:: schwab.streaming::StreamClient.level_one_forex_unsubs
-.. automethod:: schwab.streaming::StreamClient.add_level_one_forex_handler
-.. autoclass:: schwab.streaming::StreamClient.LevelOneForexFields
-  :members:
-  :undoc-members:
-
+.. _level_one_futures_options_stream:
 
 ----------------------
 Futures Options Quotes
@@ -353,12 +368,30 @@ Level one quotes for futures options.
 
 .. automethod:: schwab.streaming::StreamClient.level_one_futures_options_subs
 .. automethod:: schwab.streaming::StreamClient.level_one_futures_options_unsubs
+.. automethod:: schwab.streaming::StreamClient.level_one_futures_options_add
 .. automethod:: schwab.streaming::StreamClient.add_level_one_futures_options_handler
 .. autoclass:: schwab.streaming::StreamClient.LevelOneFuturesOptionsFields
   :members:
   :undoc-members:
 
 
+.. _level_one_forex_stream:
+
+------------
+Forex Quotes
+------------
+
+Level one quotes for foreign exchange pairs.
+
+.. automethod:: schwab.streaming::StreamClient.level_one_forex_subs
+.. automethod:: schwab.streaming::StreamClient.level_one_forex_unsubs
+.. automethod:: schwab.streaming::StreamClient.level_one_forex_add
+.. automethod:: schwab.streaming::StreamClient.add_level_one_forex_handler
+.. autoclass:: schwab.streaming::StreamClient.LevelOneForexFields
+  :members:
+  :undoc-members:
+
+
 .. _level_two:
 
 ++++++++++++++++++++
@@ -419,12 +452,14 @@ book is called "listed." Testing indicates this stream corresponds to the NYSE
 book, but if you find any behavior that suggests otherwise please
 `let us know <https://github.com/alexgolec/schwab-api/issues>`__.
 
-.. automethod:: schwab.streaming::StreamClient.listed_book_subs
-.. automethod:: schwab.streaming::StreamClient.listed_book_unsubs
-.. automethod:: schwab.streaming::StreamClient.add_listed_book_handler
+.. automethod:: schwab.streaming::StreamClient.nyse_book_subs
+.. automethod:: schwab.streaming::StreamClient.nyse_book_unsubs
+.. automethod:: schwab.streaming::StreamClient.nyse_book_add
+.. automethod:: schwab.streaming::StreamClient.add_nyse_book_handler
 
 .. automethod:: schwab.streaming::StreamClient.nasdaq_book_subs
 .. automethod:: schwab.streaming::StreamClient.nasdaq_book_unsubs
+.. automethod:: schwab.streaming::StreamClient.nasdaq_book_add
 .. automethod:: schwab.streaming::StreamClient.add_nasdaq_book_handler
 
 
@@ -440,64 +475,60 @@ exchanges, although this is an admittedly an uneducated guess.
 
 .. automethod:: schwab.streaming::StreamClient.options_book_subs
 .. automethod:: schwab.streaming::StreamClient.options_book_unsubs
+.. automethod:: schwab.streaming::StreamClient.options_book_add
 .. automethod:: schwab.streaming::StreamClient.add_options_book_handler
 
 
-++++++++++++
-Time of Sale
-++++++++++++
+.. _screener:
 
-The data in :ref:`level_two` describes the bids and asks for various 
-instruments, but by itself is insufficient to determine when trades actually 
-take place. The time of sale streams notify on trades as they happen. Together 
-with the level two data, they provide a fairly complete picture of what is 
-happening on an exchange.
+++++++++
+Screener
+++++++++
 
-All time of sale streams uss a common set of fields:
+Top 10 advances and decliners by volume, trades, percent change and average percent
+volume.
 
-.. autoclass:: schwab.streaming::StreamClient.TimesaleFields
-  :members:
-  :undoc-members:
+Symbols in upper case and separated by commas.
 
+(PREFIX)_(SORTFIELD)_(FREQUENCY) where PREFIX is:
+ * Indices: $COMPX $DJI, $SPX.X, INDEX_ALL
+ * Exchanges: NYSE, NASDAQ, OTCBB, EQUITY_ALL
+ * Option: OPTION_PUT, OPTION_CALL, OPTION_ALL
 
--------------
-Equity Trades
--------------
+and sortField is:
+ * VOLUME, TRADES, PERCENT_CHANGE_UP, PERCENT_CHANGE_DOWN, AVERAGE_PERCENT_VOLUME
 
-.. automethod:: schwab.streaming::StreamClient.timesale_equity_subs
-.. automethod:: schwab.streaming::StreamClient.timesale_equity_unsubs
-.. automethod:: schwab.streaming::StreamClient.add_timesale_equity_handler
+and frequency is:
+ * 0, 1, 5, 10, 30 60 minutes (0 is for all day)
 
+Both the equity and option screener streams use a common set of fields:
 
---------------
-Futures Trades
---------------
+.. autoclass:: schwab.streaming::StreamClient.ScreenerFields
+  :members:
+  :undoc-members:
 
-.. automethod:: schwab.streaming::StreamClient.timesale_futures_subs
-.. automethod:: schwab.streaming::StreamClient.timesale_futures_unsubs
-.. automethod:: schwab.streaming::StreamClient.add_timesale_futures_handler
 
+---------------
+Screener Equity
+---------------
 
---------------
-Options Trades
---------------
+.. automethod:: schwab.streaming::StreamClient.screener_equity_subs
+.. automethod:: schwab.streaming::StreamClient.screener_equity_unsubs
+.. automethod:: schwab.streaming::StreamClient.screener_equity_add
+.. automethod:: schwab.streaming::StreamClient.add_screener_equity_handler
 
-.. automethod:: schwab.streaming::StreamClient.timesale_options_subs
-.. automethod:: schwab.streaming::StreamClient.timesale_options_unsubs
-.. automethod:: schwab.streaming::StreamClient.add_timesale_options_handler
 
+---------------
+Screener Option
+---------------
 
-++++++++++++++
-News Headlines
-++++++++++++++
+.. automethod:: schwab.streaming::StreamClient.screener_option_subs
+.. automethod:: schwab.streaming::StreamClient.screener_option_unsubs
+.. automethod:: schwab.streaming::StreamClient.screener_option_add
+.. automethod:: schwab.streaming::StreamClient.add_screener_option_handler
 
-.. automethod:: schwab.streaming::StreamClient.news_headline_subs
-.. automethod:: schwab.streaming::StreamClient.news_headline_unsubs
-.. automethod:: schwab.streaming::StreamClient.add_news_headline_handler
-.. autoclass:: schwab.streaming::StreamClient.NewsHeadlineFields
-  :members:
-  :undoc-members:
 
+.. _account_activity:
 
 ++++++++++++++++
 Account Activity