Botfleet Docs

Introduction

The dYdX v4 Telegram Trading Bot allows you to trade directly on the dYdX v4 platform through Telegram. This guide will walk you through setting up your account and performing basic trading operations.

Getting Started

Setting Up Your Wallet

  1. Start the bot with the /start command
  2. Choose one of the options:
    • 🔑 Create new wallet: Generates a new address for use with dYdX
    • 📥 Import existing wallet: Use your existing dYdX secret phrase

Main Dashboard

  • Available USDC balance
  • Current leverage setting
  • Open positions (if any)
  • Pending orders (if any)

Basic Operations

Portfolio Management

💼

Click the Portfolio button to view:

  • USDC balance details
  • Open positions with profit/loss metrics
  • Pending orders overview

Deposits and Withdrawals

Deposit to Subaccount

Access Deposit Menu

  • From main menu, click "💰 Deposit"

Enter Amount

  • Type the USDC amount you want to deposit
  • Minimum deposit: $1.00 USDC

Confirm Deposit

  1. Review the transaction details
  2. Click "✅ Confirm" to proceed
  3. Funds will be transferred to your dYdX subaccount

Withdraw from Subaccount

Access Withdraw Menu

  • From main menu, click "💸 Withdraw"

Select Amount

  • Choose from preset amounts (25%, 50%, 75%, 100%)
  • Or enter custom amount in USDC

Confirm Withdrawal

  1. Review withdrawal details
  2. Click "✅ Confirm" to proceed
  3. Funds will be withdrawn to your main account

Trading Operations

Market Orders

Execute trades immediately at the best available price:

Long Market Order

  1. Click 📈 Long
  2. Select Market
  3. Enter position size in USDC
  4. Confirm the trade

Short Market Order

  1. Click 📉 Short
  2. Select Market
  3. Enter position size in USDC
  4. Confirm the trade

Limit Orders

Place orders at specific price levels:

Long Limit Order

  1. Click 📈 Long
  2. Select Limit
  3. Enter desired entry price
  4. Enter position size in USDC
  5. Confirm the order

Short Limit Order

  1. Click 📉 Short
  2. Select Limit
  3. Enter desired entry price
  4. Enter position size in USDC
  5. Confirm the order

Conditional Orders

Set up trigger-based orders:

Stop Loss Orders

  1. Select position to protect
  2. Click Set Stop Loss
  3. Enter trigger price
  4. Choose Market or Limit execution
  5. Confirm the order

Take Profit Orders

  1. Select position to take profit
  2. Click Set Take Profit
  3. Enter target price
  4. Choose Market or Limit execution
  5. Confirm the order

Command-based Orders

Execute trades directly with text commands:

Long Position Command

/long <PAIR> <leverage> <size>

Example:

/long BTC-USD 5 100

This will create a long position for BTC-USD with 5x leverage and $100 size

Short Position Command

/short <PAIR> <leverage> <size>

Example:

/short BTC-USD 5 100

This will create a short position for BTC-USD with 5x leverage and $100 size

Order Management

Modify Orders

  1. Go to Open Orders section
  2. Select order to modify
  3. Choose Edit
  4. Update price or quantity
  5. Confirm changes

Cancel Orders

  1. Go to Open Orders section
  2. Select order to cancel
  3. Click Cancel
  4. Confirm cancellation

Position Management

Opening Positions

  1. Select 📈 Long for bullish positions or 📉 Short for bearish positions
  2. Choose your desired market (BTC-USD, ETH-USD, etc.)
  3. Set position size and confirm the operation

Closing Positions

Access Positions Menu

  1. Start the bot with /start
  2. Click on "📈 Positions" button

View Open Positions

The bot will display all your open positions with:

  • Market name (e.g., BTC/USD)
  • Position side (Long/Short)
  • Size and entry price
  • Current P&L
  • Leverage used

Close Position

  1. Click on the position you want to close
  2. Select "Close Position" option
  3. Confirm the closure
  4. The position will be closed at market price

Advanced Features

Leverage Adjustment

Click the 🎯 Leverage button and select your desired level:

1x 2x 5x 10x 20x

Slippage Configuration

Control the maximum price slippage allowed for your orders:

How to Access

  1. Click on Slippage: X% in the order menu
  2. The slippage configuration panel will appear

Available Options

0.5% 1% 2% 3% 5% 10% Custom

Higher slippage increases the chance of your order being executed, but may result in less favorable prices.

Best Practices

  • Always keep your secret phrase in a secure location
  • Regularly monitor your positions to manage risk exposure
  • Set leverage according to your trading strategy and risk tolerance
  • Consider using stop-loss orders for risk management

Troubleshooting

If you encounter any issues:

  • Ensure your USDC balance is sufficient for your trades
  • Check network connectivity if operations seem delayed
  • For persistent problems, contact support through the Help button

Security Recommendations

  • Never share your secret phrase with anyone
  • Periodically review your account activity
  • Use secure networks when accessing the bot
  • Enable additional security features when available