HodlEye Crypto Price Tracker

A lightweight Docker-based web tool to monitor cryptocurrency prices (via Binance and OKX) with unlimited alarms and unlimited crypto tracking, outshining typical TradingView limitations. It also provides quick access to multiple RSS-based crypto news sources and a live Economic Calendar.

Demo

Check out the live demo here: HodlEye Demo

Default Login Data
User: admin
Password: admin

---

Table of Contents

1. Overview
2. Features
   • Unlimited Alarms & Tracking
   • Price Updates
   • Alarm Functionality
   • Crypto News
   • Economic Calendar
   • TradingView Chart
3. Installation & Usage
   • Requirements
   • Environment variables (.env)
   • Docker Build & Run
4. Windows Notification App: HodlEye_Notify
5. Project Structure
   • Frontend (index.html & magic.js)
   • News Feed Server (Node.js)
6. Important Notes / Limitations
7. Coming Soon
8. Privacy & Data Disclaimer
9. License

---

Overview

HodlEye Crypto Price Tracker is a Dockerized application that aims to surpass typical limitations of other tracking platforms (like TradingView), offering:

• Unlimited Alarms: No cap on the number of alarms you can set.
• Unlimited Crypto Tracking: Easily add as many coins as you want.
• Real-Time Price Updates (every 1 seconds): Uses Binance and OKX data.
• Crypto News & Economic Calendar: Stay updated on the latest events affecting the market.
• TradingView Modal Integration: Click on any crypto pair to open a TradingView modal for in-depth chart analysis.New

The tool refreshes prices every 1 seconds, which may introduce a slight delay in alarm triggers if the price quickly touches the threshold in between intervals.

---

 

Features

Unlimited Alarms & Tracking

• You can set as many alarms as you like — no daily or total limit.
• Track any number of cryptocurrencies in the list simultaneously.

 

Price Updates

• Binance and OKX are integrated as the primary data sources.
• By default, HodlEye tries Binance first; if that fails or is forced off, it falls back to OKX.
• It automatically fetches the current price, 24h open, 1h open, and calculates the 24h and 1h percentage changes every 1 seconds.

 

Alarm Functionality

• Set alarms for each coin (e.g., BTC/USDT), choosing:
  • Alarm Price (threshold)
  • Direction (Rising, Falling, or Both)
  • Frequency (Once or Recurring)
• When triggered, a popup and sound notification appear, with optional desktop notifications.
• Once alarms are marked locally in the browser (not removed from the server) so they do not trigger again unless reloaded or manually reset.

 

Crypto News

• News from multiple RSS sources:
  • https://crypto.news/feed/
  • https://cointelegraph.com/rss
  • https://thedefiant.io/api/feed
  • https://newsbtc.com/feed
  • https://news.bitcoin.com/feed (may be inaccessible in certain regions)
  • https://bitcoinmagazine.com/feed
  • https://cryptopanic.com/news/rss/
  • https://decrypt.co/feed
• Quickly view and filter recent articles within the built-in News modal.

 

Economic Calendar

• The Economic Calendar button opens a modal with an Investing.com iframe, showing major economic events such as central bank decisions and market-impacting announcements.

 

TradingView Chart

• The TradingView Chart Crypto Box Currency click opens a modal with a Tradingview Chart Window iframe, get a better overview of the charts.

 

Login Screen

• The Login Screen provides a certain level of security from prying eyes.

---

 

Installation & Usage

Requirements

• Docker installed.
• (Optional) Docker-Compose if you want a more complex or multi-container setup.

 

Environment Variables (.env)

You can store the username, password, and a secret key in the .env file to protect the application from unauthorized access. Make sure to change the default credentials to your own secure values:

LOGIN_USER=admin
LOGIN_PASS=admin
SESSION_SECRET=some_secret_key

• LOGIN_USER: The username for logging into the application.
• LOGIN_PASS: The password for logging into the application.
• SESSION_SECRET: A random, secret value to secure sessions.

After building and starting the container, a login prompt will appear when accessing the application, ensuring that only authorized users can proceed.

 

---

Docker Build & Run

1. Clone this repository

   git clone https://github.com/Gerald-Ha/HodlEye-Crypto-Price-Tracker.git
   cd HodlEye
   

2. Build the Docker image

   docker buildx build -t hodleye-crypto-tracker .
   

   (Make sure you’re in the same directory as the Dockerfile.)

3. Run the container

   docker run -p 3099:3099 -p 5001:5001 --env-file .env -v hodleye_data:/app/data --name hodleye-container hodleye-crypto-tracker
   

   • Port 3099 serves the main web interface.
   • Port 5001 is used by the Node.js server that fetches news RSS feeds.

4. Access the application

   • Main UI: http://localhost:3099
   • News Feed Endpoint: http://localhost:5001/api/news

---

 

Windows Notification App: HodlEye_Notify

If you prefer not to keep the HodlEye Crypto Price Tracker web interface open in your browser all the time, you can use a lightweight Windows application called HodlEye_Notify. This tool connects directly to the same endpoint as the Docker container and will display notifications on your desktop whenever an alarm is triggered.

 

1. Setup

   • Enter the IP address and port of your HodlEye Docker container (for example, http://192.168.1.112:3099/) in the HodlEye_Notify window.
   • Click Connect to establish a WebSocket connection.
   • Once connected, you’ll see the status change to “Connected.”

2. Autostart

   • Add HodlEye_Notify to your Windows Startup folder so it automatically launches when Windows starts. This way, you’ll continuously receive notifications without needing to reopen the program manually.

3. Testing Notifications

   • From the machine running the Docker container, you can trigger a test notification using the following curl command:

   Ubuntu

    curl -X POST http://192.168.1.112:3099/api/notifications \
         -H "Content-Type: application/json" \
         -d "{\"message\": \"⚠️ ALARM (Recurring, Both): BTC reached 92250\", \"timestamp\": \"2025-03-06T06:19:58.584Z\"}"
   

   Windows CMD

   
   curl -X POST http://192.168.1.112:3099/api/notifications -H "Content-Type: application/json" -d "{\"message\": \"⚠️ ALARM (Recurring, Both): BTC reached 92250\", \"timestamp\": \"2025-03-06T06:19:58.584Z\"}"
   

• If everything is configured correctly, you should receive a desktop notification from HodlEye_Notify indicating the alarm has triggered.

This application simplifies the process of staying informed about your alarms, letting you work on other tasks without leaving the HodlEye web interface open.

---

 

Project Structure

Below is an example directory tree (based on your structure). Yours may vary slightly:

HodlEye-Crypto-Price-Tracker
├── Dockerfile
├── LICENSE.txt
├── PRIVACY.md
├── README.md
├── data
│   └── data.json
├── public
│   ├── font
│   │   └── BreeSerif-Regular.ttf
│   ├── images
│   │   ├── Gitea_Logo.svg
│   │   ├── coffee.svg
│   │   ├── favicon.png
│   │   └── github-mark.svg
│   ├── index.html
│   ├── magic.js
│   ├── news.js
│   ├── tradingview.js
│   ├── script.js
│   ├── responsive.css
│   ├── sound
│   │   ├── cashing.mp3
│   │   └── ping.mp3
│   ├── style.css
│   └── update.js
├── server
│   ├── newsfeed
│   │   ├── node_modules
│   │   ├── package-lock.json
│   │   ├── package.json
│   │   └── server.js
│   ├── node_modules
│   ├── package-lock.json
│   ├── package.json
│   └── server.js
├── sound
│   ├── cashing.mp3
│   └── ping.mp3
├── update.json
└── .env

 

Frontend (index.html & magic.js)

• index.html
  • Main interface containing modals and buttons (Add Crypto, Edit List, Alarms, Options, etc.).
  • Includes buttons for:
    • Crypto News (opens a news modal)
    • Economic Calendar (Investing.com iframe)
    • Unlimited Alarms management
    • Options (Dark mode, alarm sounds, desktop notifications)
    • Buy me a Coffee donation button
• magic.js
  • Core logic:
    • Fetches cryptos (/api/cryptos)
    • Loads alarms (/api/alarms) and notifications (/api/notifications)
    • Pulls prices from Binance/OKX every 1 seconds
    • Checks and triggers alarms
    • Handles UI rendering (prices, alarms, notifications, drag & drop reorder)

 

News Feed Server (Node.js)

• A minimal Node.js Express server (in server.js or similar) which:
  • Retrieves the listed RSS feeds and parses them via xml2js
  • Serves them in JSON format at /api/news
• Default port is 5001 (overridden by process.env.PORT if set).
• Example local usage (non-Docker):

  cd feed-server
  npm install
  node server.js
  

  • Accessible at http://localhost:5001/api/news.

(Within Docker, it’s already bundled, so just expose 5001.)

---

 

Important Notes / Limitations

1. 1-second polling

   • There’s a potential delay in alarms because price thresholds are only checked every 1 seconds. If a price briefly touches and moves away between polls, you might miss that exact trigger moment.

2. API availability

   • Binance/OKX may be temporarily down or might not support certain symbols.
   • HodlEye tries Binance → fallback to OKX if needed.

3. Unlimited Alarms (Once vs. Recurring)

   • Once alarms become locally “triggered” to avoid repeated alerts but are not server-side deactivated.
   • Recurring triggers repeatedly every time the threshold is crossed.

4. RSS Feeds

   • Some feeds might be inaccessible in certain regions (bitcoin_news in Germany, for instance).
   • Economic Calendar content is loaded from an <iframe> pointing to Investing.com.

---

 

Upcoming planned changes with the next versions

• Portfolio Management: Track your crypto holdings in real-time with easy-to-read analytics.
• Big Movement Alarm: Alarm function for rapid short or long events.
• Android: Android app with synchronization option to HodlEye Docker (First early alpha already available internally)
• HodlEye Notify Alarm with various sound selections and HodlEye Alarms
• Windows HodlEye Notify Update: Windows app bugfix and updates

Stay tuned for updates!

---

 

Privacy & Data Disclaimer

• No Data Collection by This Application: HodlEye itself does not collect, store, or process any personal data or usage analytics.
• External Services: Certain features (e.g., news feeds, iframes) rely on third-party websites or APIs. We do not control and are not responsible for the data-collection practices or privacy policies of these external providers. Please refer to the privacy policies of those services for details.

---

 

🛡️ License

Custom Non-Commercial License. See LICENSE file for details.

---