Skip to main content

​
Getting Started

Perpsbot is an AI-powered trading bot for Telegram that allows you to trade Hyperliquid perpetual futures using natural language commands and the telegram mini-app. Simply tell the bot what you want to trade in English, or any of the other 50+ supported languages.
You can access advanced charting, position management, referral system and much more in the Telegram mini-app.
When you first use the bot, it will prompt you to connect your wallet. Click “Connect Wallet,” choose your preferred wallet (MetaMask, Trust Wallet, etc.), and sign the permission messages. The bot only receives trading permissions - never withdrawal access.
You retain exclusive withdrawal permissions and never share your private key.
You can trade all perpetual futures pairs available on HyperLiquid (200+). This includes major cryptocurrencies like BTC, ETH, SOL, and many altcoins and memecoins. Spot trading is not currently supported.

Any perpetual future that gets listed on HyperLiquid is instantly available to trade through perps.bot.
Yes. Your funds remain on Hyperliquid in your own wallet. Perpsbot only has trading permissions via API and cannot withdraw your funds. You maintain full control of your assets at all times.

​
Using the Bot

There are two ways to trade via perps.bot:\
  1. Telegram mini-app (advanced charts, direct trading, referrals, orderbook, position management & more)\
  2. **Natural language commands **(AI)
For the mini-app, just press the button mini-app in Telegram.For Natural language commands (AI), simply tell the bot what you want to do in natural language (English & 50+ other languages):
  • "Long 10 BTC"
  • "Short $500 worth of ETH"
  • "Close my SOL position"
  • "Show me my portfolio"
  • "Long market the top 3 by volume, $15 each please"
The AI understands your intent and executes the appropriate trade.
Yes! You can train the AI to remember your personal shortcuts:
  • "Remember /dca as buy $100 BTC and ETH"
  • Later, just type /dca to execute
Create any custom commands for your common trading actions.
This feature is in BETA, and should not be fully relied on. The AI can make mistakes.
By default, the bot shows a confirmation button before executing trades. This protects against accidental large orders. You can disable confirmations in settings for faster trading.These confirmations happen both in the mini-app and via language interface.
All Hyperliquid order types are supported:
  • Market orders (instant execution)
  • Limit orders (specific price)
  • Stop loss orders
  • Take profit orders
  • Conditional and bracket orders

​
Mini App

The Telegram Mini App provides a full trading interface within Telegram, including professional charts, order books, portfolio management, and more. It’s like having a complete trading platform in your messenger.
You can easily turn it into a native RWA app available from your homescreen. Instructions
Yes! You can save the mini app to your device homescreen on both iOS and Android. It will function like a native app without installing anything.
The mini app integrates with Hyperliquid’s official bridge. You can deposit from Arbitrum to Hyperliquid and withdraw back. Transactions typically complete in 2-5 minutes.

​
Referral System

You earn commissions from your referrals’ trading fees:
  • Level 1 (direct referrals): 20%
  • Level 2 (sub-referrals): 8%
  • Level 3 (sub-sub-referrals): 2%
Your referral link is automatically generated when you sign up.For a full explanation on the referral system, please read this.
No! There are no caps on referral earnings. You earn as long as your referral network keeps trading.
Referral earnings are claimable over the $10 threshold. There is no set time, you can claim any time you want.

​
Technical Questions

Command interpretation (natural language interface) typically takes under 2 seconds. Trade execution depends on Hyperliquid’s system, usually completing within seconds for market orders.Mini app order execution is near instant.
When asking for more complex information, such as a breakdown of your portfolio and a market overview - the AI might take longer to respond due to the amount of information required and displayed.
Currently, Perpsbot supports 🇬🇧 English, 🇩🇪 Deutsch, 🇫🇷 Français, 🇪🇸 Español, 🇹🇷 Türkçe, 🇰🇷 한국어, 🇨🇳 中文, 🇯🇵 日本語, 🇮🇩 Bahasa Indonesia, 🇨🇿 Čeština, 🇵🇱 Polski, 🇩🇰 Dansk, 🇳🇱 Nederlands, 🇳🇴 Norsk, 🇮🇹 Italiano, 🇷🇺 Русский, 🇷🇴 Română, 🇧🇬 Български, 🇭🇷 Hrvatski, 🇷🇸 Српски, 🇧🇦 Bosanski, & many more (although the AI might make mistakes in translations).

Additional full language support may be added based on user demand.
Mini-app interface is also multilingual. You can select your preferences in Settings.
The AI has 98%+ accuracy for properly structured commands. If it doesn’t understand something, it will ask for clarification rather than guessing.
If you’re dealing with substantial amounts (per your standard), consider leave the default safety confirmation option turned ON.
We store minimal data required for functionality:
  • Telegram user ID
  • Connected wallet address (public)
  • Custom commands
  • Trade history for analytics
  • Referral information
We never store private keys (and we never have access to them) or personal information.

​
Fees & Costs

Perps.bot charges 0.05% per trade. Referred users get a 10% discount on this fee, which makes it a 0.045% fee base.
No gas fees for trading! Hyperliquid operates on its own chain with no gas costs for trading operations. You only pay small gas fees when depositing/withdrawing.

​
Security

Security layers include:
  • Telegram 2FA protection
  • Encrypted data storage
  • Enclaved AI tool access
  • Proper endpoint security
  • Trading-only API permissions
  • Session timeouts and monitoring
  • No withdrawal capabilities for the bot
Your funds remain safe in your wallet on Hyperliquid. You’ll lose access to trading through the bot and may forfeit unclaimed referral earnings. Enable 2FA to prevent account loss.
Yes, we conduct regular security audits and maintain transparency about our security practices. We will also be introducing a bug bounty soon.
If you’re a whitehat and have found vulnerabilities in our platform, please reach out.

​
Troubleshooting

If you’ve sent a complex query, please try waiting a little bit.Otherwise, try restarting Telegram.

If the bot does not restore responsiveness, please create a ticket in our Discord.
Common solutions:
  • Switch to Arbitrum, Hyperliquid, or Ethereum network
  • Restart the wallet
  • Use a differet wallet
  • Try doing the set up from a desktop device
  • Wait 5 minutes for updates (if you’ve just bridged)
  • Try restarting Telegram
  • Ask bot to refresh: "Update my balance"

​
Getting Help

Discord Community

Join our Discord for live support and community discussions

Troubleshooting Guide

Detailed solutions for common technical issues
Still have questions? Ask the bot directly: "I need help with [your question]" or join our Discord community for live support!