Skip to content

Commit

Permalink
Changes to reflect new tooltip functionality
Browse files Browse the repository at this point in the history
  • Loading branch information
pmaji authored Feb 22, 2018
1 parent 2788091 commit 2b56798
Showing 1 changed file with 8 additions and 4 deletions.
12 changes: 8 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,13 +39,17 @@ While these two may seem different, their market impacts are often comparable. I

As can be seen from the UI screenshot below, for each currency pairing the user can easily examine the most obvious whales hiding amongst the walls. The algorithm used displays only those orders that make up >= 1% of the volume of the portion of the order book shown in the visualization (which is presently +/-5% from present market price). This methodology makes our analysis robust both in times of price stability--when there is both resistance and support similar in magnitude--as well as during times of large price fluctuation--when there may be very little support or very little resistance. Thanks to the creative coloring algorithm behind the visualization, the brightest colors are those most likely to be whales (i.e. substantial volume at a single price point via a single limit order). The colors become progressively darker as the number of distinct orders at a pricepoint increases, allowing for easy visual identification of whales in the market.

![Main UI](https://raw.githubusercontent.com/pmaji/crypto-whale-whatching-app/master/screenshots/new_main_app_ui.JPG)
![Main UI](https://raw.githubusercontent.com/pmaji/crypto-whale-watching-app/master/screenshots/main_app_ui_screenshot.JPG)

In addition to the main views which provide at-a-glance information about the largest orders, users can freeze the live refresh within the app in order to zoom in on particular sections of the order book, or to take better advantage of the tooltip capabilities of the Plotly visualization. Given that we now track both single price-point and ladder price-point whales, there are often times when bubbles overlap the linebar charts. When this happens, simply freeze the visualization and zoom in on a particular area to separate the two in a more detailed view. An example of both the tooltip and annotation functionalities can be seen via the screenshot below, with a walkthrough of what is being displayed thereafter.
In addition to the main views which provide at-a-glance information about the largest orders, users can freeze the live refresh within the app in order to zoom in on particular sections of the order book, or to take better advantage of the tooltip capabilities of the Plotly visualization. Given that we now track both single price-point and ladder price-point whales, there are often times when bubbles overlap the linebar charts. When this happens, simply freeze the visualization and zoom in on a particular area to separate the two in a more detailed view. An example of the tooltip functionalities for both the ladder and single price-point whales can be seen via the screenshots below.

<img src="https://raw.githubusercontent.com/pmaji/crypto-whale-whatching-app/master/screenshots/new_ui_tooltip_screenshot2.JPG" width="700" height="300">
<img src="https://raw.githubusercontent.com/pmaji/crypto-whale-watching-app/master/screenshots/bubble_tooltip_screenshot.JPG" width="600" height="250">

Here we are looking at a zoom-in on the chart of ETH/USD. The bubble chart that we have hovered over in the top right hand corner is bright red in color given that we are highly confident that this is a single price-point whale. We can see that this is one unique sell order placed for 503.62 ETH at the $962.33 price point. Below the market price line we see two occurencies of what is likely a ladder price-point whale. The annotation on the green line at 350 on the x-axis (7 * 50.0) tells us that there are 7 unique orders for 50 ETH each set in the ladder span of the range of the green line. The thickness of the line is also proportional to the size of each rung on the order ladder. This is why the right-most ladder price-point whale is shown via a thinner line, as that set of orders is 52 unique orders for 10 ETH each, which, while smaller in individual order size, is actually larger in total volume.
In the image above we are looking at a zoom-in on the chart of LTC/USD. The bubble that we have hovered over on the left hand side is bright red in color given that we are highly confident that this is a single price-point whale. We can see that this is one unique sell order placed for 300 LTC at the $221.48 price point.

<img src="https://raw.githubusercontent.com/pmaji/crypto-whale-watching-app/master/screenshots/ladder_tooltip_screenshot.JPG" width="600" height="250">

In the image above we are looking at the same chart for LTC/USD, but now zoomed in on a zone towards the other end of x-axis (so we're looking at much larger orders), now hovering over a large ladder price-point whale. Here we can see that the tooltip calls out the total number of rungs on the ladder--8 orders of 100 LTC each--as well as the price range in which those orders are found, and the total market value of those orders. The thickness of the line is also proportional to the size of each rung on the order ladder.

We cannot be as certain that ladder price-point whales are, in fact, individual whales, as it could just be a few people who place similar orders of identical size at different psychological modal points, but in most cases this is unlikely, and we leave it up to the user to make the ultimate determination as to whether or not they believe a particular order or set of orders to be a whale or not. That said, we do recognize that the ladder price-point whale methodology could perhaps be improved with variable controls, and we are actively looking into this along with other improvements. Our app only serves to provide the information, and to ascribe some semblance of a probability to the likelihood that an observation is a whale or not.

Expand Down

1 comment on commit 2b56798

@jihadd1987
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hi sir - why the project now working ? crypto- and the website not working ( https://whales.cracklord.com ) i need this tool - can you help me ? thanks

Please sign in to comment.