The battlefield in one minute
- The front line is the price. It sits at the aggregated ETH/USD price (next section). Lower prices — the buy side, the bulls — are on one side; higher prices — the sell side, the bears — on the other. The line flashes green or red for a moment when the price moves.
- Armies are resting orders. Bids and asks within ±1% of the price become units. One soldier stands for a fixed dollar amount of resting orders; the legend under the depth chart shows the current value (for example "1 soldier ≈ $20K"), and it is re-chosen as liquidity changes. A single price level holding 25 soldiers' worth of orders becomes a tank. Orders right at the price form the rows that hug the front; orders further out stand in squads at their price level; orders beyond a base are counted as reserves and shown as a number above the base.
- A round is a ±0.25% race. Each round starts at the current price and places the two bases ±0.25% away (the
rangeparameter). When the price reaches the bear base the bulls win, and vice versa: the loser's flag comes down, the base is shelled, and after 6 seconds a new round starts at the price of that moment. The war bar at the top shows both target prices, a short narration ("Bulls advancing", "Ask liquidity absorbed"…) and the score. - Artillery is market events. Large taker trades, liquidations and large option trades fire shells across the line (see Events). Bigger amounts make bigger explosions; soldiers caught in a blast are knocked down and get up again.
- Skirmish fire is activity. Front-row soldiers trade rifle fire at a rate that follows taker buy and sell volume over the last 5 seconds. It is visual only.
The price index (the front line)
The front line follows one number: a volume-weighted index of the latest trade price on each connected spot exchange.
- Each exchange's last price is converted to US dollars. USDT-quoted markets (OKX, Bybit, Binance) are converted with Kraken's live USDT/USD rate; if that rate is unavailable, 1.00 is used.
- Each exchange is weighted by its 24-hour traded value in the quote currency. An exchange that does not deliver a 24-hour volume ticker to the browser (currently Bitstamp) is weighted by its traded value over the last 10 minutes, scaled to a day, so its weight is small until the window fills.
- Exchanges whose price is more than 0.5% away from the median, or that have not reported a trade for 120 seconds, are left out of the index for that moment. Exchanges that cannot be reached at all simply do not take part.
- The 24-hour change shown under the price uses the same weights on each exchange's 24-hour open.
The exchange list in the top-right corner shows, for every venue, whether its feeds are connected, its current weight in the index, and its deviation from the index in basis points. The index is therefore a blend that can differ slightly from any single exchange and from your broker's quote; it is not a reference rate.
Timing: trades arrive over WebSocket with the usual network latency; the game logic runs every 250 ms; the front line glides toward the new price rather than jumping, so the drawn line lags the number in the HUD by a fraction of a second.
Data sources
All feeds are public exchange WebSocket streams that need no API key. The page opens about ten connections directly from your browser; there is no ETH War server in between.
| Exchange | Market | Used for |
|---|---|---|
| Coinbase | ETH-USD spot | Trades and 24-hour ticker; full order book (level 2) |
| Kraken | ETH/USD spot, USDT/USD | Trades, order book (500 levels), ticker; the USDT/USD conversion rate |
| OKX | ETH-USDT spot; ETH perpetual swaps | Trades, order book (400 levels), ticker; liquidations |
| Bybit | ETHUSDT spot; USDT perpetuals | Trades, order book (200 levels), ticker; liquidations |
| Bitstamp | ETH/USD spot | Trades; top-100 order-book snapshots |
| Binance | ETHUSDT spot (public market-data host); USDⓈ-M futures | Trades, top-20 order book, 24-hour ticker; liquidations |
| Deribit | ETH options | Option trades (premium in USD); not part of the price index |
Order books are kept per exchange and merged into the depth chart (bottom-left, about ±0.4% around the price) and the two liquidity figures (±1% on each side); levels further than 5% from the mid price are discarded, and a book that has not updated for 30 seconds is ignored. The drop-down on the depth chart switches between the aggregated book and a single exchange.
If a connection drops, the page reconnects with increasing delays. While an exchange is unreachable it shows as offline in the list and is simply absent from the index and the armies. If no exchange sends a spot trade within 12 seconds of opening the page, or for 20 seconds while running, a notice asks you to check your network; it disappears by itself once data flows again. The notice does not appear in simulation mode.
Events: large trades, liquidations, options
The market feed in the bottom-right corner lists the latest events with time, exchange, type and amount. The same events fire the artillery; ordinary trades do not.
Large trades
Trade prints from the same aggressive order (same exchange, same side, no more than 100 ms apart) are merged into one. If the merged amount reaches the current threshold it becomes a large buy or large sell: a soldier or tank near the front on the buyer's (bull) or seller's (bear) side fires a shell to the other side of the line. The threshold adapts to activity so that roughly ten events a minute appear: it moves between $2,000 and $10,000 using the last five minutes of trades, and the feed's title shows the value in force ("≥ $5.3K"). ?big=5000 fixes it instead.
Liquidations
Forced closes of ETH perpetual positions on OKX, Bybit and Binance of $1,000 or more arrive as shorts liquidated or longs liquidated. They are heavy artillery fired from behind the attacker's lines: liquidated shorts land on the bears' side (they push the price up), liquidated longs on the bulls' side.
Option trades
Deribit ETH option trades with a premium of $500 or more appear as option buy / option sell and launch a flare behind the buying or selling side. Option prices do not move the front line.
What you see
- Shell size grows with the amount. Liquidations of $125,000 or more, and any event of $300,000 or more, make the cinematic camera cut to a close-up.
- Explosions are rate-limited so a burst of prints does not flood the scene; every event is still listed in the feed. Events of $250,000 or more are never dropped.
- The war bar's narration compares the bull/bear progress, taker flow and the liquidity close to the price over the last 10–20 seconds; the market label in the top-left corner ("Quiet market", "Volatile market"…) comes from the realized volatility of the last 5 minutes.
Live mode vs. simulation mode
Live is the default. The badge in the top-left corner reads ● LIVE, and the exchange list in the top-right corner shows which venues are connected. Everything on screen then comes from the feeds described above.
Simulation (/?sim) replaces every feed with a built-in generator: a random walk starting near $2,720 with synthetic order books, trades, liquidations and option prints. The badge reads ● SIMULATION and the only venue listed is "Simulator". It exists for demos, offline use and testing — prices in simulation mode are not market data. seed and speed change the random sequence and its pace.
Controls, sound and URL parameters
The camera starts in cinematic mode and directs itself: overviews, charges and close-ups of big events. Any manual input takes over; C or the Cinematic button hands control back.
| Action | Mouse / keyboard | Touch |
|---|---|---|
| Rotate | Drag | One-finger drag |
| Zoom | Scroll wheel | Pinch |
| Pan | W A S D or the arrow keys | — |
| Orbit | Q / E | — |
| Cinematic camera on/off | C or the camera button | Camera button |
| Look at the front line | F or the target button | Target button |
| Fullscreen | Fullscreen button | Fullscreen button |
| Sound on/off | M or the speaker button | Speaker button |
| Language | L or the 中文 / EN button | 中文 / EN button |
| Lighting | Drop-down in the top-left panel: automatic by your local time of day, golden hour, daylight or night | |
| Depth source | Drop-down on the depth chart: aggregated book or one exchange | |
Sound
An orchestral score switches between a calm theme, a battle march and a victory cue as the fight heats up; rifles, tank guns, explosions, incoming liquidation shells and flares are placed in stereo according to where they happen. Sound is on by default; most browsers only allow it after a click or a key press, so a hint at the bottom asks you to click anywhere once. M or the speaker button toggles it, and the choice is remembered on this device.
URL parameters
| Parameter | Effect | Default |
|---|---|---|
sim | Use the offline simulation instead of live feeds | off |
seed, speed | Random seed and pace of the simulation | 7, 1 |
range | Half-width of a round in percent: a base is captured at ±range | 0.25 |
big | Large-trade threshold in USD after merging; auto adapts between $2,000 and $10,000 | auto |
sources | Comma-separated exchanges to connect, e.g. coinbase,kraken,okx | all |
light | auto, golden, day or night | auto |
lang | en or zh; otherwise the last choice on this device, then the browser language | browser |
post | 0 turns off post-processing (bloom, tilt-shift, vignette) | on |
q | low turns off shadows and post-processing and renders at 1× pixel ratio | high |
sound | 0 starts muted for this visit | on |
Limits and privacy
- It is a visualization, not a trading tool. The index, the armies and the events are a way of looking at public market data. Nothing here is financial advice, and the page never places orders.
- Your browser does the connecting. Data quality depends on your network: an exchange that is blocked or slow where you are is missing or late on your screen, and the index is then built from fewer venues. There is no server-side history, so the page starts empty for a second or two and remembers nothing between visits except your language and sound preferences.
- Numbers are approximations. Soldier counts are rounded to the current per-soldier amount; reserve labels round the same way; the depth chart buckets prices.
- Simulation mode is synthetic. Its prices and amounts are generated locally and have no connection to the market.
- Privacy. No account, no cookies, no wallet connection. The language and sound choices are stored in your browser's local storage. The published site counts page views with Cloudflare Web Analytics, which does not use cookies or collect personal data; development and preview builds do not report anything.
- Performance. The scene draws up to a few thousand animated units with shadows and post-processing. On phones or older laptops, add
?q=low.
FAQ
Is ETH War free?
Yes. There is no account, subscription or payment, and the source code is public under a noncommercial license.
Do I need a wallet or an exchange account?
No. The page only reads public market data; it never connects to a wallet or trades.
Is the price real-time?
In live mode, yes: it is built from exchange trade feeds as they arrive, typically within seconds. In simulation mode (?sim) the price is synthetic.
Why does the price differ from the one on my exchange?
It is a volume-weighted blend of several exchanges' last trades, with USDT markets converted to USD. Any single venue can sit a few basis points away from it.
Why is an exchange shown as offline?
Its WebSocket feed could not be reached from your network, or it has not sent data recently. The page keeps retrying; the index uses the venues that are connected.
Why is the market feed empty?
In quiet hours there are few large trades. The threshold lowers itself to $2,000 over a few minutes; if the feed stays empty, check the exchange list for connection problems.
Does it work on a phone?
Yes. The layout adapts to portrait and landscape phones and tablets. Use ?q=low if it stutters.
Can I reuse the code or the images?
Under the PolyForm Noncommercial 1.0.0 license you may copy, modify and share the project for noncommercial purposes with the required notice; commercial use needs permission from the author. Third-party components (three.js, the Inter font, the MuseScore General sound font) keep their own licenses.
Is ETH War related to Newhedge's Bitcoin Battlefield?
It is an independent, unofficial project inspired by it. It is not affiliated with or endorsed by Newhedge.
Is this financial advice?
No. It is a visualization of public market data for information and entertainment.