Skip to main content
Hyperoru integrates with Telegram and Discord to deliver trade notifications, alerts, and enable chat-based interaction with the platform.

​
Telegram bot

The Telegram integration uses a webhook-based architecture. Hyperoru receives messages from Telegram’s API and responds through the bot.

​
Setup

1

Create a Telegram bot

Message @BotFather on Telegram:
  1. Send /newbot
  2. Choose a name and username
  3. Copy the bot token
2

Configure the bot in Hyperoru

curl -X POST https://api.hyperoru.com/api/bots/telegram \
  -H "Content-Type: application/json" \
  -d '{
    "bot_token": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
    "webhook_url": "https://hyperoru.example.com/api/bots/telegram/webhook",
    "user_id": "your-user-id"
  }'
3

Set the webhook with Telegram

Hyperoru automatically registers the webhook with Telegram’s API. Verify it’s active:
curl "https://api.telegram.org/bot{token}/getWebhookInfo"
4

Start chatting

Open your bot in Telegram and send /start to initialize the connection.
For local development, use a tunneling service like ngrok to expose your local webhook URL to Telegram.

​
Discord bot

The Discord integration uses a gateway-based connection, maintaining a persistent WebSocket to Discord’s API.

​
Setup

1

Create a Discord application

  1. Go to the Discord Developer Portal
  2. Create a new application
  3. Navigate to the Bot section and create a bot
  4. Copy the bot token
  5. Enable the Message Content Intent under Privileged Gateway Intents
2

Invite the bot to your server

Generate an invite URL with these permissions:
  • Send Messages
  • Read Message History
  • Embed Links
https://discord.com/api/oauth2/authorize?client_id=YOUR_APP_ID&permissions=67584&scope=bot
3

Configure the bot in Hyperoru

curl -X POST https://api.hyperoru.com/api/bots/discord \
  -H "Content-Type: application/json" \
  -d '{
    "bot_token": "your-discord-bot-token",
    "guild_id": "your-server-id",
    "user_id": "your-user-id"
  }'

​
Notification types

Both Telegram and Discord support the same notification categories:
NotificationTriggerContent
Trade ExecutedOrder filled on exchangeSymbol, direction, size, entry price
Position ClosedPosition closed (TP/SL/manual)Symbol, PnL, duration, exit reason
Signal FiredSignal pool conditions metPool name, triggered signals, matched values
Strategy ErrorStrategy execution failedError type, trader name, details
Daily SummaryScheduled (configurable time)PnL, open positions, active traders

​
Notification preferences

Configure which notifications you receive: 
curl -X PUT https://api.hyperoru.com/api/bots/{bot_id}/notifications \
  -H "Content-Type: application/json" \
  -d '{
    "trade_executed": true,
    "position_closed": true,
    "signal_fired": false,
    "strategy_error": true,
    "daily_summary": true,
    "daily_summary_time": "09:00"
  }'

​
Chat bindings

Bind a bot to a specific trader to scope notifications and commands: 
curl -X POST https://api.hyperoru.com/api/bots/{bot_id}/bindings \
  -H "Content-Type: application/json" \
  -d '{
    "trader_id": "trader-uuid",
    "channel_id": "telegram-chat-id-or-discord-channel-id"
  }'
With bindings, you can:
  • Send notifications for a specific trader to a dedicated channel
  • Use chat commands to query that trader’s status, positions, and history
  • Route different traders to different channels for organized monitoring

Multiple bindings

Bind multiple traders to different channels for organized notification routing.

Chat commands

Query positions, PnL, and trader status directly from Telegram or Discord.
Bot tokens are stored encrypted in the database using the same encryption key as exchange credentials. Keep your HYPERLIQUID_ENCRYPTION_KEY secure.