Hyperliquid Tracker

This bot monitors Hyperliquid trades and sends notifications to a Telegram channel when significant trades occur.

Prerequisites

Before you begin, make sure you have the following installed:

• Node.js (version 22.4.0 or higher)
• npm (comes with Node.js) - pnpm can be used as well
• Git (for cloning the repository)

Step-by-Step Setup Guide

1. Clone the Repository trough your terminal

git clone https://github.com/gabriel-azara/hyperliquid-tracker
cd hyperliquid-tracker

2. Create Your Telegram Bot

1. Open Telegram and search for @BotFather
2. Start a chat with BotFather and send /newbot
3. Follow the instructions to create your bot
4. Save the API token that BotFather gives you - you'll need it later
5. Start a chat with your new bot by clicking the link BotFather provides

3. Get Your Telegram Chat ID

1. Create a new Telegram channel where you want to receive notifications
2. Add your bot to the channel as an administrator
3. Forward any message from your channel to @userinfobot
4. The bot will reply with information including the chat ID (it will look like -100xxxxxxxxxx)

4. Set Up Environment Variables

1. Create a file named .env in the project root directory
2. Copy the contents from .env.example into .env
3. Fill in your Telegram bot token and chat ID and replace the values in your own .env file

5. Install Dependencies

npm install

6. Build the Project

npm run build

7. Start the Bot

npm start

For development, you can use:

npm run dev

Configuration

You can customize the bot by modifying the following in src/config/index.ts:

• SUPPORTED_COINS: List of cryptocurrencies to monitor
• MIN_NOTIONAL_VALUE: Minimum trade value to trigger notifications (default: 1,000,000)

Features

• Real-time trade monitoring on Hyperliquid
• Automatic notifications for large trades.
• Support for multiple cryptocurrencies (can be extended)
• Automatic reconnection on connection loss
• Health check endpoint

Troubleshooting

1. Bot not sending messages:
   • Verify your bot token and chat ID in .env
   • Ensure the bot is an administrator in your channel
   • Check if the bot has permission to