FlowMap Trade Terminal

FlowMap Trade Terminal is a desktop application for studying liquidity and order flow in crypto and US equities. It combines a live depth heatmap, a depth-of-market ladder, time and sales, and recorded-session replay. It reads market data and supports visual analysis; it does not place orders or hold funds.

Download releases · User guide · Architecture

• Displays bid and ask liquidity with a WebGL2 heatmap, adjustable price and time scales, and sum, bid, ask, or imbalance views.
• Adds trade bubbles, best bid and offer, VWAP, cumulative volume delta, volume profile, and feed-gap markers.
• Provides symbol search, watchlists, drawings, technical indicators, and local price alerts.
• Records sessions to Parquet and replays the recorded data with seeking, pause, and speed controls. The default recording limit is 20 GB; older recordings are removed when the cap is exceeded.
• Exports chart images and finalized depth columns as CSV or JSON.
• Runs in a Tauri desktop shell or as a local browser client. The interface supports English and Turkish, themes, and keyboard controls.

Feed badges show the active data tier and tape source. Replay uses available recordings; it cannot recover unrecorded historical depth. Network failures, source gaps, and aggregation affect what can be shown. The application is an analysis tool, and its indicators do not establish trading performance.

flowchart LR
    V[Market REST and WebSocket feeds] --> P[Python feed adapters]
    P --> G[Session manager and density grid]
    G --> W[Binary WebSocket stream]
    W --> C[React and WebGL2 client]
    G --> R[(Parquet recordings)]
    R --> G
    T[Tauri desktop shell] -. starts and monitors .-> P
    T -. hosts .-> C

• server/ contains the Python 3.13 FastAPI service. Crocodile adapters normalize crypto events; equity and simulation adapters use the same session protocol. The service manages the density grid, recordings, replay, and HTTP endpoints.
• client/ contains the React, TypeScript, and WebGL2 renderer. It receives binary depth columns and market events, caches chart history, and draws overlays and interaction tools.
• app/ contains the Tauri 2 Rust shell. Packaged builds include the client and a relocatable Python runtime. The shell starts the local service, monitors its health, and stops it when the application closes.

The service binds to loopback. It is intended for local use and has no user authentication. See SECURITY.md for the network and storage model, and docs/architecture.md for protocol and replay details.

Use Python 3.13+, uv, and Node.js 22.13+ or 24 with npm. Packaged releases bundle their runtime and do not need a source setup.

git clone https://github.com/nazmiefearmutcu/FlowMap-Trade-Terminal.git
cd FlowMap-Trade-Terminal

Start the service in one terminal:

cd server
uv sync
uv run python -m flowmap_server

Start the client from the repository root in another terminal:

cd client
npm ci
npm run dev

Open http://localhost:5173. The development client connects directly to 127.0.0.1:8720, with a proxy fallback. Select SIM-DEMO to check the interface without a network connection, or choose a live symbol such as BTCUSDT.

The server resolves Crocodile from the wheel included in server/vendor/. Source helpers are also available at scripts/dev-windows.ps1 and scripts/dev-unix.sh; these disable recording unless explicitly enabled. For Windows paths containing non-ASCII characters, see the troubleshooting guidance in the user guide.

Set environment variables before starting the service. Common settings are:

Defaults and validation are defined in config.py. Use market-data credentials appropriate to the provider; FlowMap has no order-execution integration.

# In client/
npm test
npm run lint
npm run build

# In server/
uv run pytest -q
uv run ruff check .

Development guide covers browser end-to-end tests, the Rust shell, and packaging. See the desktop build guide, contribution guide, changelog, and roadmap for further work.

Apache License 2.0.

Estimated minimum requirements. See benchmark notes for validation limits.

Created By Aylin (Nazmi Efe Armutcu)