Hypurr Exporter

A Prometheus exporter to monitor the Hyperliquid ecosystem.

github
  • 6,605 Raised
  • 1,012 Views
  • 3 Judges

Categories

  • 21. Best use of Alchemy
  • 01. 🛠️ Public Goods
  • 05. Improvements to the HyperEVM RPC
  • 12. Notification System using Node Info API

Description

📝 Project Submission Template

Please use this template when submitting your project. Make sure all links are accessible. Make sure all code is accessible to @HL-Hackathon on github. Submissions without a demo will not be considered.


🧠 Project Name

Hypurr Exporter


🔍 Description

The Hypurr Exporter is a lightweight Rust service that collects both ecosystem-wide and account-specific metrics from Hyperliquid. Builders and power users often struggle with siloed monitoring tools that only cover part of the picture — either systematic risks or personal account/vault risks. The Hypurr Exporter bridges that gap by exposing everything in a single Prometheus-compatible format. With Grafana dashboards on top, users can easily customize and visualize the exact metrics they care about.


🛠️ How It Works

Builders and power users on Hyperliquid need to protect themselves against two kinds of risks:

  • Systematic risks (things happening across the Hyperliquid ecosystem, like network health or fee changes)
  • Individual risks (account- or vault-specific metrics, like PnL or vault performance)

Right now, there are tools for one side or the other — either ecosystem-wide analytics or personal account dashboards. But these solutions are siloed, hard to configure, and don’t give you a unified view. That makes monitoring tedious and less effective.

The Hypurr Exporter brings both worlds together. It pulls systematic metrics and individual account/vault metrics into one place, exposing them in a standard Prometheus format. From there, you can mix and match what matters to you in Grafana dashboards — whether you care about global Hyperliquid health, your vault’s TVL, or both at the same time. This makes monitoring flexible, unified, and customizable to each user’s needs — without juggling multiple tools.

The Hypurr Exporter is a Rust service that connects to Hyperliquid and external APIs (Alchemy + CoinGecko) to collect both on-chain and market data. It exposes this information as Prometheus-formatted metrics over HTTP on port 3000.

Prometheus regularly scrapes these metrics, stores them in its time-series database, and makes them queryable. Grafana then connects to Prometheus to visualize the metrics in real-time dashboards, letting you track things like block height, base fees, account PnL, vault performance, and marketcap.

The exporter is lightweight, fast, and easy to deploy: you can run it locally with Cargo, as a standalone Docker container, or as part of a monitoring stack with Prometheus + Grafana via Docker Compose. This makes it useful both for builders who want to experiment quickly and for teams who want to plug it straight into production-grade monitoring.


💻 Demo

Demo on Loom: https://www.loom.com/share/7ed93b461d2f48a398dd0eb4ac18fc5b?sid=3e9d43d9-e55e-4134-a1be-687f7b83599c


📂 Project Links

The GitHub repository contains the full source code along with a README that covers prerequisites, usage instructions, and a step-by-step guide to demoing the Hypurr Exporter in a local setup that simulates a production-style monitoring environment.

GitHub: https://github.com/eric-official/hypurr-exporter


👥 Team

Eric Näser

Attachments