chock_a_block 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 61eac32feffc31892a866b93630c02d84274154f
-  data.tar.gz: 677f850db05f1cb59da016806a43095f0ce4f250
+  metadata.gz: 3c31a5f8019fffb3347eca48196a97cfece3af3f
+  data.tar.gz: 685411389aaabeef552b82fae307c1881e2ecdf4
 SHA512:
-  metadata.gz: a4877e9e853be54c86325aa1e53e97185c06c0bc0ba5f02f6aa5e678fb0feb1d10a0725d900b8a5d363bc50ff29397c43c9d94362c09dd6a0b3f609a6bcae371
-  data.tar.gz: d259a1b9a20153211ab925f07c1b411ed4bbc8e156a7ed16a18d7f6a0dccaa13af506b1c1ae0139088b34177577c41f25cc22577585debe6a67cf4bd4df0d668
+  metadata.gz: 2e5ffb538e95e55736417106d08580fb2f97d44f990553db2760595599cef41a6bf76a1469385525f9d6209e822a95750addb9ce3ec40d02c23c588067bef561
+  data.tar.gz: cb4c8e087f44f7424116025b38e1e274b4e2e560cd4b968337e244fd7899de5a9f97797e228e725111aa3961b62ba4e0be8e0d3580846c6370fb8dbab83fc4b7

data/lib/chock_a_block/stock.rb

@@ -37,8 +37,8 @@ module ChockABlock
     # @return [Hash] representing the best current price/qty offered by bots
     # or retry if best_bid is nil
     def best_bidding
-      @order_book = get_orderbook
-      best_bid = @order_book['bids']&.last
+      order_book = get_orderbook
+      best_bid = order_book['bids']&.last
 
       return best_bid unless best_bid.nil?
 

data/spec/cassettes/ChockABlock/_start_level/prints_errors_about_invalid_API_KEY.yml

@@ -0,0 +1,41 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://www.stockfighter.io/gm/levels/chock_a_block
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Starfighter-Authorization:
+      - API_KEY
+      Connection:
+      - close
+      Host:
+      - www.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 19:56:11 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '144'
+      Connection:
+      - close
+      X-Upstream-Debugging:
+      - 172.31.134.156:8181
+    body:
+      encoding: ASCII-8BIT
+      string: '{"ok":false,"error":"Auth/auth failed: %!(EXTRA *errors.errorString=Couldn''t
+        find that apiKey, service reports: No fighter with that API key.)"}'
+    http_version: 
+  recorded_at: Sun, 21 Feb 2016 19:53:57 GMT
+recorded_with: VCR 3.0.1

data/spec/cassettes/ChockABlock/_start_level/starts_new_AlgoTrader.yml

@@ -0,0 +1,56 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://www.stockfighter.io/gm/levels/chock_a_block
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Starfighter-Authorization:
+      - API_KEY
+      Connection:
+      - close
+      Host:
+      - www.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 20:00:57 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      X-Upstream-Debugging:
+      - 172.31.134.156:8181
+    body:
+      encoding: ASCII-8BIT
+      string: |-
+        {
+          "ok": true,
+          "instanceId": 23585,
+          "account": "HAE78360086",
+          "instructions": {
+            "Instructions": "# Moving up in the world!\n\n**Reminder: These instructions are always available under the Instructions tab if you need to see them again.** \n\nAfter your impressive performance at your last job, you've moved on to Hollings \u0026 Eakins.  Warning: **the gloves are off, now**.\nHere is **account HAE78360086** and a mandate from one of our clients, a pension fund: they want you to purchase them 100,000 shares of \nRockDeathBlossomify (*RDB*).  (Their asset manager thinks the company will have market-beating performance over the next\nfew years.  Maybe they're right, maybe they're not, but either way we get paid and I'm investing my bonus in cat food futures.)\n\nThis is called a **block trade** -- 100,000 shares is a lot of RDB to buy all at once, so the presence of someone wanting to\ndo it suggests that someone who is smart and rich has better-than-market information about the stock.  Executing block trades\nis one of the core problems of trading.\n\nWhy?  Here's one of the reasons we on the sell-side make the big bucks: the client could try to buy these shares themselves,\n but if they just did the obvious thing and put in an order for 100,000 shares, they'd get shellacked.\n\nWhy?  Supply and demand: sudden demand for a product with limited supply, like liquid shares of a stock, makes the market \nclearing price go up.  Also, supply and demand: if you supply a sucker who broadcasts his intentions loudly, capitalism demands that the rest of\nthe market eat the sucker alive.  So instead you've got to be sneaky-sneaky about how you accumulate those 100,000 shares.\n\nLuckily, this market maker is dumb as a box of rocks.  They don't seem to remember prior orders well at all.  You could probably \nget the full allocation done just by calling them up all day and ordering a few shares here and a few shares there... \nbut I hear you're a programmer, and the stock exchange has [an API](https://starfighter.readme.io), so why do anything \nmanual and repetitive when you have a for loop available?\n\n## Your Goal\n* Purchase 100,000 shares of RDB.\n* Avoid causing a \"price impact\" -- our client wants these shares for the cheapest price possible, naturally.\n\n## You'll Be Fired If\n\n* You cause an excessive price impact in the stock.  What's \"excessive\"?  It's up to the risk desk.  \n* You take too long.  The client doesn't need their shares *this instant* but they want them *quickly*.\n* The market moves against you.  What, that's unfair?  Welcome to Wall Street, kid.\n\n### A Note From Starfighter:\n\nWe abstract the notion of time in Stockfighter.  On this level, one trading day in the simulated world corresponds to about five\nseconds of wall-clock time.  In real life, the market generally has off periods between trading days, but most of our levels don't --\nour bots don't need sleep.  Well, OK, technically speaking they do sleep() while waiting on you... like right now, because you're\nreading while you could be trading.  Get coding!\n",
+            "Market Makers": "A **market maker** is a market participant (sometimes a formal role, often not) who provides *liquidity* in a stock, by being willing\nto buy the stock or sell the stock, substantially all of the time.  The market maker seeks to make a small amount of money on\na large amount of transactions by, on average, selling for slightly more than their buying price.  The difference between the price\nthat they're willing to buy at and the price that they're willing to sell at (at any given moment) is called \"the *spread*\".\n\nMarket makers are crucial to the financial markets.  A market without liquidity is a sucky market.  The market for houses has very\nlow liquidity: if you want to sell your house on Tuesday, it is unlikely that anyone wants to buy *exactly* your house on *exactly*\nTuesday, so you'd probably get a very, very poor price for it.  Similarly, if you wanted to buy *exactly* your dream house on *exactly*\nTuesday, you'd probably have to pay a ridiculous premium to the \"fair value\" of the house.\n\nImagine a world where there was someone you would call, name any address in the country, and immediately receive a buying\nprice and a selling price for that house.  That person would be a market maker.  They would make it much, much less difficult\nfor you to get into or out of your desired exposure to a house on Tuesday.\n\nMarket makers are the counter-parties to *most* transactions on the stock exchange.  That sounds unlikely, but it is true: it is\nhighly unlikely that a pension fund seeking to unload 100,000 shares of Google executes that trade at *the exact instant* where\na stadium full of mom-and-pop investors are seeking to buy 2~5 shares of Google apiece.\n\n## What Do Market Makers Not Like?\n\nMarket makers don't like **inventory risk**.  They get paid to take on a small, short-term risk of being long (holding stock) or \nshort (borrowing stock) in the stock they're making a market for, with the intention of quickly having an order in the opposite\ndirection get them out of that position.\n\nIt is dangerous for a market maker to trade with *informed order flow*, i.e. someone with better-than-market understanding of\nthe near term future for a stock.  Someone who is trading a block (a lot of stock at once) is automatically informed order flow,\nsince they know that their current transaction for buying 100 shares is going to be followed not by a 50/50 chance of a sell but\nrather with a buy, a buy, another buy, some more buys, followed by more buying.\n\nIf a market maker continues to allow informed order flow to trade with them, they may find themselves with a larger position than\nthey anticipated at a price which is expensive to get out of, given the present state of the market.\n\n## How Do Market Makers Deal With This?\n\n1. *Profile incoming orders.*  Market makers, beginning with humans with \"a sense of the flow of the market\" and continuing to\nHFT algorithms in the present day, are in a constant cat-and-mouse game with informed order flow.  They'd prefer to transact\nminimally (if at all) with informed orders.\n\n2.  *Hedge.*  More sophisticated strategies are available after a market maker has multiple instruments they can trade in.  For\nexample, they can hedge a long position in a stock with options which synthetically cancel out some features of the position.\nThey could also e.g. hedge a position in a particular stock with an offsetting position in a separate stock believe to be highly\ncorrelated with the original stock (e.g. if you're long Toyota, sell Honda), with indexes/exchange traded funds, or with other\nderivatives.\n\n## How Do I Make Markets?\n\nBuy low.  Sell high.  Trade frequently.\n\n## No, Really?\n\nObserve what the provided market makers do, in particular how they quote spreads and periodically cancel orders when\nthe market moves in either direction.  The provided market makers are as unsophisticated as they can be and possibly work\n(n.b. under 100 lines of Ruby code).  You should be able to easily exploit their blind spots.  \n\nA freebie, since **people who\nactually read docs should be rewarded**: our least sophisticated market maker has no memory of closed orders and looks\nat the order book every N seconds as if the universe had just sprung into being.  That probably suggests at least one way\nto trick it into doing what you want.  \n\nBonus points: if what you do to get what you want doesn't leave a signature in the order\nbook, it will *never* catch on.  (Note that a dumb market maker with smart participants next to it can function as a smart system\neven if they're not intentionally colluding, however.  One of the core insights of markets in general is that they quickly converge\non solutions which are better than individual participants would have come up with.  A market maker can surf on the market,\nwhich converges to a solution to your manipulation, without itself understanding that your manipulation even exists.)\n\nIn general, you want to \n\n1. quote a tighter spread (if the bot would quote $10 / $10.50, and you quote $10.05 / $10.45, you'll\nget the fills rather than the bot)\n2. attempt to profile incoming orders, for example by keeping state of your own recent orders and whether you appear to be\nhaving many similar ones happen in the same direction\n3. cancel and re-file your bids/asks when you develop inventory in either direction, potentially at a less favorable price if you're\nscared\n4. look for patterns in the market and in behavior of other participants.  Patterns which suggest anomalous behavior, which\nroutinely divulge that an order is from a sophisticated or unsophisticated source, or which allow you to predict the near-term\nbehavior of another participant are *very valuable indeed.*\n\n## Stockfighter Notes\n\nTake a look at the API docs for viewing an order's fills or the details of an execution.  Note that we don't expose any identifying\ninformation about your counterparty.  Now, try to think of creative ways that one can \"cheat\" the non-availability of that information.\n"
+          },
+          "tickers": [
+            "STK"
+          ],
+          "venues": [
+            "VENUE"
+          ],
+          "secondsPerTradingDay": 5
+        }
+    http_version:
+  recorded_at: Sun, 21 Feb 2016 19:58:43 GMT
+recorded_with: VCR 3.0.1

data/spec/cassettes/ChockABlock_Stock/_best_bidding/retries_again.yml

@@ -0,0 +1,137 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 21:15:56 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '358'
+      Connection:
+      - close
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubdomains
+    body:
+      encoding: ASCII-8BIT
+      string: |-
+        {
+          "ok": true,
+          "venue": "VENUE",
+          "symbol": "STK",
+          "ts": "2016-02-21T21:14:04.301520932Z",
+          "bids": null,
+          "asks": [
+            {
+              "price": 10403,
+              "qty": 11898,
+              "isBuy": false
+            },
+            {
+              "price": 10454,
+              "qty": 11898,
+              "isBuy": false
+            },
+            {
+              "price": 10505,
+              "qty": 11898,
+              "isBuy": false
+            }
+          ]
+        }
+    http_version:
+  recorded_at: Sun, 21 Feb 2016 21:13:42 GMT
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 21:15:58 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '579'
+      Connection:
+      - close
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubdomains
+    body:
+      encoding: ASCII-8BIT
+      string: |-
+        {
+          "ok": true,
+          "venue": "VENUE",
+          "symbol": "STK",
+          "ts": "2016-02-21T21:14:07.142397315Z",
+          "bids": [
+            {
+              "price": 9891,
+              "qty": 13078,
+              "isBuy": true
+            },
+            {
+              "price": 9842,
+              "qty": 13078,
+              "isBuy": true
+            },
+            {
+              "price": 9793,
+              "qty": 13078,
+              "isBuy": true
+            }
+          ],
+          "asks": [
+            {
+              "price": 9989,
+              "qty": 11921,
+              "isBuy": false
+            },
+            {
+              "price": 10038,
+              "qty": 11873,
+              "isBuy": false
+            },
+            {
+              "price": 10087,
+              "qty": 11873,
+              "isBuy": false
+            }
+          ]
+        }
+    http_version:
+  recorded_at: Sun, 21 Feb 2016 21:13:44 GMT
+recorded_with: VCR 3.0.1

data/spec/cassettes/ChockABlock_Stock/_best_bidding/return_best_bid.yml

@@ -0,0 +1,79 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 20:56:13 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '574'
+      Connection:
+      - close
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubdomains
+    body:
+      encoding: ASCII-8BIT
+      string: |-
+        {
+          "ok": true,
+          "venue": "VENUE",
+          "symbol": "STK",
+          "ts": "2016-02-21T20:54:21.828875543Z",
+          "bids": [
+            {
+              "price": 2357,
+              "qty": 15434,
+              "isBuy": true
+            },
+            {
+              "price": 2346,
+              "qty": 15434,
+              "isBuy": true
+            },
+            {
+              "price": 2335,
+              "qty": 15434,
+              "isBuy": true
+            }
+          ],
+          "asks": [
+            {
+              "price": 2437,
+              "qty": 9066,
+              "isBuy": false
+            },
+            {
+              "price": 2449,
+              "qty": 9565,
+              "isBuy": false
+            },
+            {
+              "price": 2461,
+              "qty": 9565,
+              "isBuy": false
+            }
+          ]
+        }
+    http_version:
+  recorded_at: Sun, 21 Feb 2016 20:53:59 GMT
+recorded_with: VCR 3.0.1
+

data/spec/cassettes/ChockABlock_Stock/_get_orderbook/raises_StockNotFoundError.yml

@@ -0,0 +1,38 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 500
+      message: Internal Server Error
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 20:47:12 GMT
+      Content-Type:
+      - text/plain; charset=utf-8
+      Content-Length:
+      - '65'
+      Connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"ok":false,"error":"symbol STK does not exist on venue VENUE"}
+
+'
+    http_version:
+  recorded_at: Sun, 21 Feb 2016 20:44:58 GMT
+recorded_with: VCR 3.0.1

data/spec/cassettes/ChockABlock_Stock/_get_orderbook/raises_VenueNotFoundError.yml

@@ -0,0 +1,38 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 20:45:37 GMT
+      Content-Type:
+      - text/plain; charset=utf-8
+      Content-Length:
+      - '61'
+      Connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"ok":false,"error":"No venue exists with the symbol VENUE"}
+
+'
+    http_version: 
+  recorded_at: Sun, 21 Feb 2016 20:43:23 GMT
+recorded_with: VCR 3.0.1

data/spec/cassettes/ChockABlock_Stock/_get_orderbook/return_JSON_Hash_of_the_order_book.yml

@@ -0,0 +1,78 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 20:56:13 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '574'
+      Connection:
+      - close
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubdomains
+    body:
+      encoding: ASCII-8BIT
+      string: |-
+        {
+          "ok": true,
+          "venue": "VENUE",
+          "symbol": "STK",
+          "ts": "2016-02-21T20:54:21.828875543Z",
+          "bids": [
+            {
+              "price": 2357,
+              "qty": 15434,
+              "isBuy": true
+            },
+            {
+              "price": 2346,
+              "qty": 15434,
+              "isBuy": true
+            },
+            {
+              "price": 2335,
+              "qty": 15434,
+              "isBuy": true
+            }
+          ],
+          "asks": [
+            {
+              "price": 2437,
+              "qty": 9066,
+              "isBuy": false
+            },
+            {
+              "price": 2449,
+              "qty": 9565,
+              "isBuy": false
+            },
+            {
+              "price": 2461,
+              "qty": 9565,
+              "isBuy": false
+            }
+          ]
+        }
+    http_version:
+  recorded_at: Sun, 21 Feb 2016 20:53:59 GMT
+recorded_with: VCR 3.0.1

data/spec/cassettes/ChockABlock_Stock/_get_quote/raises_StockNotFoundError.yml

@@ -0,0 +1,38 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK/quote
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 21:01:41 GMT
+      Content-Type:
+      - text/plain; charset=utf-8
+      Content-Length:
+      - '61'
+      Connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"ok":false,"error":"No venue exists with the symbol VENUE"}
+
+'
+    http_version: 
+  recorded_at: Sun, 21 Feb 2016 20:59:27 GMT
+recorded_with: VCR 3.0.1

data/spec/cassettes/ChockABlock_Stock/_get_quote/return_JSON_Hash_of_the_quote.yml

@@ -0,0 +1,53 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.stockfighter.io/ob/api/venues/VENUE/stocks/STK/quote
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Connection:
+      - close
+      Host:
+      - api.stockfighter.io
+      User-Agent:
+      - http.rb/1.0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx/1.8.0
+      Date:
+      - Sun, 21 Feb 2016 21:02:32 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '300'
+      Connection:
+      - close
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubdomains
+    body:
+      encoding: ASCII-8BIT
+      string: |-
+        {
+          "ok": true,
+          "symbol": "STK",
+          "venue": "VENUE",
+          "bid": 2630,
+          "ask": 2656,
+          "bidSize": 14749,
+          "askSize": 9912,
+          "bidDepth": 44263,
+          "askDepth": 30412,
+          "last": 2656,
+          "lastSize": 338,
+          "lastTrade": "2016-02-21T21:00:36.605689657Z",
+          "quoteTime": "2016-02-21T21:00:36.605987278Z"
+        }
+    http_version:
+  recorded_at: Sun, 21 Feb 2016 21:00:18 GMT
+recorded_with: VCR 3.0.1

data/spec/chock_a_block/stock_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+describe ChockABlock::Stock do
+  subject { ChockABlock::Stock.new('VENUE', 'STK') }
+
+  describe '#get_orderbook' do
+    it 'raises VenueNotFoundError', :vcr do
+      expect{ subject.get_orderbook }.to raise_error ChockABlock::VenueNotFoundError
+    end
+
+    it 'raises StockNotFoundError', :vcr do
+      expect{ subject.get_orderbook }.to raise_error ChockABlock::StockNotFoundError
+    end
+
+    it 'return JSON Hash of the order_book', :vcr do
+      order_book = subject.get_orderbook
+      expect(order_book).to be_a Hash
+      expect(order_book.keys).to\
+        include 'ok', 'venue', 'symbol', 'ts', 'bids', 'asks'
+    end
+  end
+
+  describe '#get_quote' do
+    it 'raises StockNotFoundError', :vcr do
+      expect{ subject.get_quote }.to raise_error ChockABlock::StockNotFoundError
+    end
+
+    it 'return JSON Hash of the quote', :vcr do
+      quote = subject.get_quote
+      expect(quote).to be_a Hash
+      expect(quote.keys).to\
+        include'ok', 'symbol', 'venue', 'bid', 'ask', 'bidSize', 'askSize',
+          'bidDepth', 'askDepth', 'last', 'lastSize', 'lastTrade', 'quoteTime'
+    end
+  end
+
+  describe '#best_bidding' do
+    it 'return best_bid', :vcr do
+      best_bid = subject.best_bidding
+
+      expect(best_bid['price']).to be_an Integer
+      expect(best_bid['qty']).to be_an Integer
+      expect(best_bid['isBuy']).to be true
+    end
+
+    it 'retries again', :vcr do
+      expect_any_instance_of(Object).to receive(:sleep).with(2)
+      expect(subject).to receive(:best_bidding).twice.and_call_original
+      best_bid = subject.best_bidding
+
+      expect(best_bid['price']).to be_an Integer
+      expect(best_bid['qty']).to be_an Integer
+      expect(best_bid['isBuy']).to be true
+    end
+  end
+end

data/spec/chock_a_block_spec.rb

@@ -1,11 +1,31 @@
 require 'spec_helper'
 
 describe ChockABlock do
-  it 'has a version number' do
-    expect(ChockABlock::VERSION).not_to be nil
+  it 'BASE_URL' do
+    expect(ChockABlock::BASE_URL).not_to be_nil
   end
 
-  it 'does something useful' do
-    expect(false).to eq(true)
+  it 'GAME_URL' do
+    expect(ChockABlock::GAME_URL).not_to be_nil
+  end
+
+  describe '.start_level' do
+    it 'prints errors about invalid API_KEY', :vcr do
+      expect { ChockABlock.start_level('API_KEY') }.to output(
+        "\"Invalid API_KEY API_KEY\"\n" +
+        "\"Please use a correct API_KEY to start the level\"\n"
+      ).to_stdout
+    end
+
+    it 'starts new AlgoTrader', :vcr do
+      expect_any_instance_of(ChockABlock::AlgoTrader).to receive(:basic_strategy)
+      expect { ChockABlock.start_level('API_KEY') }.to output(
+        "\"Game Started\"\n" +
+        "\"Please Navigate to:\"\n" +
+        "\"   https://www.stockfighter.io/ui/play/blotter#chock_a_block\"\n" +
+        "\"to see the game in action\"\n" +
+        "\"--------------------------------------------------------\"\n"
+      ).to_stdout
+    end
   end
 end

data/spec/spec_helper.rb

@@ -1,2 +1,11 @@
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 require 'chock_a_block'
+require 'vcr'
+require 'webmock/rspec'
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/cassettes'
+  c.hook_into :webmock
+  c.allow_http_connections_when_no_cassette = true
+  c.configure_rspec_metadata!
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chock_a_block
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Ahmed Abdel-Razzak
@@ -80,20 +80,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -134,6 +120,16 @@ files:
 - lib/chock_a_block/broker.rb
 - lib/chock_a_block/errors.rb
 - lib/chock_a_block/stock.rb
+- spec/cassettes/ChockABlock/_start_level/prints_errors_about_invalid_API_KEY.yml
+- spec/cassettes/ChockABlock/_start_level/starts_new_AlgoTrader.yml
+- spec/cassettes/ChockABlock_Stock/_best_bidding/retries_again.yml
+- spec/cassettes/ChockABlock_Stock/_best_bidding/return_best_bid.yml
+- spec/cassettes/ChockABlock_Stock/_get_orderbook/raises_StockNotFoundError.yml
+- spec/cassettes/ChockABlock_Stock/_get_orderbook/raises_VenueNotFoundError.yml
+- spec/cassettes/ChockABlock_Stock/_get_orderbook/return_JSON_Hash_of_the_order_book.yml
+- spec/cassettes/ChockABlock_Stock/_get_quote/raises_StockNotFoundError.yml
+- spec/cassettes/ChockABlock_Stock/_get_quote/return_JSON_Hash_of_the_quote.yml
+- spec/chock_a_block/stock_spec.rb
 - spec/chock_a_block_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/artmees/chock_a_block
@@ -161,4 +157,3 @@ signing_key:
 specification_version: 4
 summary: Solution to chock_a_block
 test_files: []
-has_rdoc: