> ## Documentation Index > Fetch the complete documentation index at: https://docs.dotrade.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Telegram Bot > Trade directly from Telegram with dotrade ## Overview A trading interface built on Hyperliquid, Extended and Privy's non-custodial wallet infrastructure. Users can execute market and limit orders, manage positions, and set dynamic risk parameters (trailing stops, take profits) directly through Telegram commands. The bot abstracts exchange complexity while maintaining full custody through delegated signing. ## Key Features Full custody of your assets through Privy's wallet infrastructure. Execute complex trades with simple Telegram commands. Trailing stops, take profits, and dynamic risk management. Support for Hyperliquid and Extended (more coming soon). ## Commands Reference ### Setup Commands Initializes the bot and creates a Privy account for you, where you can deposit tokens and bridge them to your preferred exchange to start trading. **Usage:** ``` /start ``` **Example Response:** ``` Welcome to the dotrade bot! @username Wallet Address: ``` Configures your preferred exchange for trading. Currently, we support Hyperliquid and Extended. **Usage:** ``` /setexchange [exchange_name] ``` **Example:** ``` /setexchange hyperliquid ``` Sets your referrer code to join the referral program. By using someone's referral code, you become their direct referral and they will earn a percentage of your fees generated. **Usage:** ``` /setreferrer [referral_code] ``` **Example:** ``` /setreferrer ABC123 ``` This command can only be used once. Make sure you have the correct referral code before setting it. Bridges tokens from your account to your trading exchange. Transfers your deposited tokens (currently only USDC) from your account to your selected exchange so you can start trading. **Usage:** ``` /bridge [amount] ``` **Example:** ``` /bridge 100 ``` There is a bridge fee associated with this operation, which is primarily for sponsoring the bridge transaction. ### Information Commands Shows a comprehensive list of all bot commands with brief descriptions. **Usage:** ``` /help ``` Gets the current market price for any trading instrument. Returns the mid price of the instrument on your selected exchange. **Usage:** ``` /price [instrument] ``` **Example:** ``` /price ETH ``` **Response:** ``` Current ETH price: 4450.00 ``` Views all your active positions. Retrieves and displays all open positions on your selected exchange, including entry price, current PnL, size, and leverage. **Usage:** ``` /positions ``` Checks your account balances. Shows your available USDC balance and equity on your selected exchange, including unrealized PnL from open positions. **Usage:** ``` /balances ``` Lists all pending orders. Displays all active limit orders, stop losses, and take profit orders that haven't been filled yet, along with their trigger prices and sizes. **Usage:** ``` /openorders ``` ### Trading Commands Executes an immediate market order at the best available price with 5% slippage by default. **Usage:** ``` /market [instrument] [side] [size] ``` **Parameters:** * `instrument` - Trading pair (e.g., ETH, BTC, SOL) * `side` - Direction: long or short * `size` - Position size in USD **Examples:** ``` /market ETH long 1000 /market BTC short 500 ``` Places a limit order at a specific price. Creates a pending order that will only execute when the market reaches your specified price. **Usage:** ``` /limit [instrument] [side] [price] [size] ``` **Parameters:** * `instrument` - Trading pair (e.g., ETH, BTC, SOL) * `side` - Direction: long or short * `price` - Desired execution price * `size` - Position size in USD **Example:** ``` /limit ETH long 3000 1000 ``` Closes a specific position at market price by executing a market reduce-only order in the opposite direction. **Usage:** ``` /close [instrument] [size] ``` **Parameters:** * `instrument` - Trading pair to close * `size` - Amount to close (can use percentages) **Example:** ``` /close ETH 50% ``` Closes all open positions immediately by executing market reduce-only orders across all instruments. **Usage:** ``` /closeall ``` This action closes ALL positions. Use with caution. Cancels a specific pending order before it gets filled. **Usage:** ``` /cancel [instrument] [order_id] ``` **Example:** ``` /cancel ETH 12345 ``` Due to exchange latency, the order may not be cancelled immediately sometimes. Cancels all pending orders across all instruments. Your open positions remain unaffected. **Usage:** ``` /cancelall ``` ### Risk Management Commands Sets a take profit order to lock in gains. Places an order that automatically closes your position when the price reaches your target profit level. **Usage:** ``` /tp [instrument] [price] ``` **Parameters:** * `instrument` - Trading pair * `price` - Target price to take profit **Example:** ``` /tp ETH 3000 ``` If you're long ETH, this will automatically close your position when ETH reaches \$3,000. Sets a stop loss order to limit potential losses. Places a protective order that automatically closes your position if the price moves against you. **Usage:** ``` /sl [instrument] [price] ``` **Parameters:** * `instrument` - Trading pair * `price` - Stop loss trigger price **Example:** ``` /sl ETH 2700 ``` If you're long ETH, this will close your position if ETH drops to \$2,700. Sets a dynamic stop loss that follows price movements. The stop loss automatically adjusts as the price moves in your favor, maintaining a fixed percentage distance. **Usage:** ``` /trailingsl [instrument] [percentage] ``` **Parameters:** * `instrument` - Trading pair * `percentage` - Trailing distance as a percentage **Example:** ``` /trailingsl ETH 5 ``` If you're long ETH at $2,800 and it rises to $3,000, a 5% trailing stop loss will trigger if the price drops to \$2,850. **For Long positions:** Stop loss trails up as price increases. **For Short positions:** Stop loss trails down as price decreases. The stop loss never moves in an unfavorable direction. Trailing orders require delegated signing authority. Most DEXes don't natively support trailing orders, so dotrade manages them by modifying orders on your behalf as prices change. Sets a dynamic take profit that moves with the mid price of the instrument. **Usage:** ``` /trailingtp [instrument] [percentage] ``` **Parameters:** * `instrument` - Trading pair * `percentage` - Trailing distance as a percentage **Example:** ``` /trailingtp ETH 3 ``` If ETH is trending upward and reaches $3,100, a 3% trailing take profit will trigger if the price drops back to $3,007. Trailing orders require delegated signing authority. ## Quick Reference | Command | Description | | -------------- | ------------------------------------- | | `/start` | Initialize bot and get wallet address | | `/setexchange` | Set preferred exchange | | `/setreferrer` | Set your referrer code | | `/bridge` | Bridge funds to exchange | | `/help` | Show all commands | | `/price` | Get current price | | `/positions` | View open positions | | `/balances` | Check account balance | | `/openorders` | List pending orders | | `/market` | Execute market order | | `/limit` | Place limit order | | `/close` | Close position | | `/closeall` | Close all positions | | `/cancel` | Cancel specific order | | `/cancelall` | Cancel all orders | | `/tp` | Set take profit | | `/sl` | Set stop loss | | `/trailingsl` | Set trailing stop loss | | `/trailingtp` | Set trailing take profit | ## Risk Warning Trading perpetual futures involves significant risk. Always do your own research and never trade with money you can't afford to lose.