git404hub

what is heimdall fr?

quicknode/heimdall — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · generalComplexity · 3/5LicenseSetup · easy

tl;dr

A pixel-art arcade game where a viking's movement is driven by a real, live Hyperliquid crypto market feed.

vibe map

mindmap
  root((Heimdall))
    What it does
      Turns live prices into gameplay
      Shows real trades and liquidations
      Offers live and simulated modes
    Tech stack
      TypeScript
      React
      Node.js
      gRPC
    Use cases
      Watch a market visually as a game
      Learn how order books behave
      Play with a free simulated market
    Audience
      Traders
      Game hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Play a free arcade game driven by simulated market data with no setup.

VIBE 2

Watch real Hyperliquid order book activity turned into a visual game.

VIBE 3

Learn what whale trades, resting stop orders, and liquidations look like on a live market.

VIBE 4

Run a local relay that turns a Hyperliquid gRPC feed into a browser-friendly WebSocket stream.

what's the stack?

TypeScriptReactZustandViteNode.jsgRPCWebSocket

how it stacks up fr

quicknode/heimdall0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity3/54/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Live data requires a paid Quicknode plan with Hyperliquid gRPC access, simulated mode needs nothing.

Use, modify, and share freely, including for commercial projects, as long as you keep the copyright notice.

in plain english

Heimdall is a browser game that turns a real, live financial market into a retro style arcade experience. A small pixel viking runs across the screen, and his height represents the current price of a chosen asset, with a rainbow trail behind him showing recent price history. Everything else moving around him, resting orders, big trades, and liquidations, is also real market data pulled from Hyperliquid, a crypto trading platform, rather than anything invented for the game. No real money is used anywhere, the in game coins have no value, and the project is explicitly for fun and learning rather than actual trading or financial advice. You can pick from several assets, including tokenized versions of well known stocks like Tesla, Nvidia, and Apple, plus crypto pairs. There is a toggle between a live feed of real data and a built in simulator that needs no setup and works immediately. Ways to play include staking coins that a price level will be reached before it scrolls past, or making a quick bet on whether the price will move up or down, with the odds shaped by real order book imbalance. Big trades appear as whales flying across the sky, and real liquidations trigger a screen shake effect. Behind the scenes, a small server written in Node.js connects to Hyperliquid's data feeds over gRPC and rebroadcasts a simplified version of that data to the browser over a WebSocket connection. When no live credentials are configured, that same server generates a simulated market in the same format, so the game still runs without needing an account or API key. The visible game itself is built with Vite, React, TypeScript, and Zustand, drawn on a single small canvas that scales to fit any screen, with hand made pixel art and a synthesized soundtrack rather than any outside art or audio files. Getting real, live data requires a paid Quicknode account with access to Hyperliquid's gRPC streams, but the simulated mode works out of the box with just the two install and start commands for the server and the web app. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Help me run Heimdall locally in simulated mode using the server and web setup steps.
prompt 2
Show me how to connect Heimdall's relay to a real Quicknode Hyperliquid gRPC endpoint.
prompt 3
Explain how Heimdall turns order book imbalance into the odds for its UP and DOWN bets.
prompt 4
Walk me through adding a new tradable asset to Heimdall's ticker list.

Frequently asked questions

what is heimdall fr?

A pixel-art arcade game where a viking's movement is driven by a real, live Hyperliquid crypto market feed.

What language is heimdall written in?

Mainly TypeScript. The stack also includes TypeScript, React, Zustand.

What license does heimdall use?

Use, modify, and share freely, including for commercial projects, as long as you keep the copyright notice.

How hard is heimdall to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is heimdall for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.