ubdcc-dashboard 0.1.0.dev0

Browser-based live dashboard for the UNICORN Binance DepthCache Cluster (UBDCC).

UBDCC Dashboard

Browser-based live dashboard for the UNICORN Binance DepthCache Cluster (UBDCC) — monitor every depth cache in your cluster at a glance, spot out-of-sync caches instantly, and add or remove caches on the fly.

Part of the UNICORN Binance Suite.

---

Features

• Compact mini-orderbook tiles per depth cache — top-3 asks/bids with quantity bars and spread in bps.
• Continuous, low-overhead polling: IntersectionObserver + filter gate means only on-screen, matching tiles hit the cluster.
• Status colouring per tile: out-of-sync (error_id #6000) turns red, other errors yellow with a compact error message.
• Add DepthCaches modal with live exchangeInfo symbol lookup for spot, margin, futures, options (incl. testnets). Shows only actively tradable symbols. Free-text fallback for exchanges without a public exchangeInfo.
• Bulk × Remove filtered with two-click confirmation — only active when a filter is set, so you can never accidentally remove every DC.
• Per-tile × remove with two-click confirmation and 3 s auto-disarm.
• Disconnect button to stop polling and cut load on the cluster.
• Refresh-rate throttle from max down to 2 s. Default 2 s is polite to the cluster; crank it up when you need a live feel.
• Dark theme, tabular-numeric fonts, no framework, no tracking — a single HTML file served by a minimal stdlib HTTP server.

---

Authorship & License

Author / Maintainer: Oliver Zehentleitner (https://github.com/oliver-zehentleitner) License: MIT — free for commercial and private use. No paid license, no subscription, no commercial tier.

---

Installation and Upgrade

pip install -U ubdcc-dashboard

Requires Python 3.9+. No external dependencies — uses only the standard library.

---

Quick Start

ubdcc-dashboard start

The server binds to 127.0.0.1:8080 (localhost only) by default and opens the dashboard in your browser. Enter the URL of your UBDCC MGMT node (typical: http://<cluster-host>:42081) and hit Connect.

CLI options

ubdcc-dashboard start [--host HOST] [--port PORT] [--no-browser]
                      [--proxy-timeout SECONDS] [--batch-workers N]

Flag	Default	Description
--host	127.0.0.1	Interface to bind. Localhost only by default — secure. Use --host 0.0.0.0 to expose the dashboard on your network.
--port	8080	TCP port to listen on.
--no-browser	off	Do not auto-open the browser on start.
--proxy-timeout	10.0	Timeout (seconds) for the CORS proxy's outbound fetches.
--batch-workers	32	Worker threads used for /proxy_batch fan-out.

Exposing on the network

ubdcc-dashboard start --host 0.0.0.0 --port 8080

Note: The proxy is unauthenticated. Only expose the dashboard on a trusted network.

---

How it works

The dashboard is a single index.html (vanilla JS, no framework) served by a small stdlib HTTP server. The server also acts as a tiny CORS proxy so the browser can query a remote UBDCC cluster that does not send Access-Control-Allow-Origin headers.

Under the hood:

• GET /proxy?url=… — passes a single GET through.
• POST /proxy {url, body} — passes a single JSON POST through.
• POST /proxy_batch {base, requests} — fans out a list of GETs over a thread pool (default 32 workers) for snappy orderbook refreshes.

The unicorn-binance-depth-cache-cluster project is the server side of this story — the dashboard just paints what the cluster already exposes via its REST API.

---

Change Log

https://oliver-zehentleitner.github.io/ubdcc-dashboard/changelog.html

Documentation

• General
• CLI Reference

Related Articles

• UNICORN Binance Suite Article Series

Project Homepage

https://github.com/oliver-zehentleitner/ubdcc-dashboard

Wiki

https://github.com/oliver-zehentleitner/ubdcc-dashboard/wiki

Social

• Discussions
• https://t.me/unicorndevs
• https://dev.binance.vision

Receive Notifications

To receive notifications on available updates you can watch the repository on GitHub, or subscribe to the releases discussion category.

To receive news (like inspection windows/maintenance) about the Binance API's subscribe to their telegram groups:

• https://t.me/binance_api_announcements
• https://t.me/binance_api_english
• https://t.me/Binance_USA
• https://t.me/TRBinanceTR
• https://t.me/BinanceExchange

How to report Bugs or suggest Improvements?

List of planned features — give a 👍 if you need one of them, or suggest a new feature!

Before you report a bug, try the latest release. If the issue still exists, provide the error trace, OS, Python version, browser, and explain how to reproduce the error. A minimal reproduction (commands + cluster setup) is appreciated.

If you don't find an issue related to your topic, please open a new issue!

Report a security bug!

Contributing

UBDCC Dashboard is an open source project which welcomes contributions which can be anything from simple documentation fixes and reporting dead links to new features. To contribute follow this guide.

Contributors

We ❤ open source!

---

AI Integration

This project provides a llms.txt file for AI tools (ChatGPT, Claude, Copilot, etc.) with structured usage instructions, CLI reference and architecture notes.

---

Disclaimer

This project is for informational purposes only. You should not construe this information or any other material as legal, tax, investment, financial or other advice. Nothing contained herein constitutes a solicitation, recommendation, endorsement or offer by us or any third party provider to buy or sell any securities or other financial instruments in this or any other jurisdiction in which such solicitation or offer would be unlawful under the securities laws of such jurisdiction.

If you intend to use real money, use it at your own risk!

Under no circumstances will we be responsible or liable for any claims, damages, losses, expenses, costs or liabilities of any kind, including but not limited to direct or indirect damages for loss of profits.