Skip to content

timothyyu/SignificantTrades

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SignificantTrades Build Status

Live cryptocurrency trades visualizer.
Currently supporting BitMEX, Bitfinex, Binance, Gdax, Bitstamp, Huobi, Okex, Hitbtc, Poloniex, Coinex and Liquid (see server/src/exchanges/ for detail)

screenshot

What it do

  • Aggregate trades from exchanges on a specific pair (default BTCUSD)
  • Filter trades by amount (by stacking them up under very short timespan)
  • Chart averaged price, buy & sell volume, price sma, volume ema
  • Play audio when trade show up
  • Visualize historical data

How it works

The app is written in vue.js, use the javascript WebSocket interface to connect to the exchanges API directly and listen to the trades events. From there it dispatch the trades to difference components within the app :

  • The trade list that shows the N previous significant orders
  • The chart that shows the averaged price action
  • The counters that sum up buy & sell volume by interval (buy/sell last 15m, last 1h, 2h etc)
  • The stats component that show basic number about whats happened under one specific interval (default 1m)

Check out the demo

How to install & run locally

  1. Clone the repo
git clone https://github.com/Tucsky/SignificantTrades
  1. Install dependencies
npm install
  1. Run dev mode

Dev mode is

npm run dev

This will automatically open a browser window at localhost:8080

Otherwise can build the application

npm run build

and access the index.html directly in the browser later without having to run a command

...

  1. Profit !

Settings

Name Description
Pair The pair you want to track. BTCUSD by default
Max rows Define the maximum lines shown in the trade list
Decimal precision To override the default rounding behavior (might be useful for alts)
Thresholds First line define the minimum amount that a trade must have to be shown in the trade list
Second line is the significant threshold and define the minimum amount for a trade to be highlighted
Third threshold is used to identify rare trades and ask you a keyword for the kind of it will show on that trade
Fourth is same as third one except you can choose another gif keyword :-)
Audio Will play audio (bip bip) when big orders are made
It use the significant as a reference to play sound loud or not
Stats Toggle stats component
The text field let you choose the stats interval (ex: 60s)
Counters Toggle counters component
The texxt field let you define the counters intervals, separed by a comma (ex: 60s, 5m, 30m etc...)
Chart Toggle chart
Margin Add margin on the right of the chart, after printed candle (% of the visible range)
Candlestick Toggle candlestick chart (enabled by default)
Show line otherwise
Liquidations Toggle liquidation serie (will add a purple bar serie on top of the buy & sell area series)
Volume averages Toggle EMA on buys & sells
The number is the average length (default 14)
Exchanges List the available exchanges
Will be grey if the exchange doesn't match current pair
Red if error
Green if currently connected
Name will be striked when disabled. Click on it to enable exchange
Exchange visibility Eye symbol indicate visibility of the exchange. A connected exchange can be hidden temporarily while still capturing trades that can be shown later on
Exchange threshold Use the slider to ajust exchange threshold relative to the main threshold set above
Exchange OHLC Include exchange in chart (enabled by default for most of the exchanges)
Include exchange with the most relevant price action

Supported pairs

The app fetch the available exchanges products when it starts the first time. So technically every pairs of the supported exchanges are supported. Just type the name in the "pair" settings (without any spaces or caret !).

Adblocker issue (and solution)

Some adblocker restrict access to exchanges websocket feeds. I know uBlock origin block many thing including huobi websocket API. Just disable Adblock on the app and you should be alright.

Cross-Domain (CORS) policy issue (and solution)

In order to fetch the products the app need to make calls to the exchanges API. Most of thoses API tell the browser they only allow access from the exchange domain (see https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS). The only way to bypass this is to use a server that will make the call for us. The cors proxy settings let u set the url of this server, which is set to mine by default. Running PROXY_URL=http://my-personnal-cors-proxy.me/ npm run dev will start the app with another cors proxy which I encourage you to do.

About the historical data

I use my servers (api.aggr.trade) to store and serve historical trades on demand. It currently support BTCUSD, ETHUSD and XRPUSD. The current source for the server part is located in the feature/server branch. Set up your own node and run API_URL=http://localhost:3000/{pair}/{from}/{to}/{timeframe} npm run dev to get access to this very usefull functionnality.

About

better than 1 min chart

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 63.5%
  • JavaScript 30.6%
  • CSS 5.4%
  • HTML 0.5%