Perpetual Futures

Trade perpetual futures on Donut Perps with leverage. Go long or short on BTC, ETH, SOL, and more — all through your D0 Bot.

What You Can Do

You Say	What Happens
"Open a 10x long on BTC with 0.01 BTC"	Place a leveraged market order
"Show my positions"	View all open positions with PnL
"Close my BTC position"	Close a position with a reduce-only order
"What's my perps balance?"	Check equity, available balance, and margin
"Deposit 1000 to perps"	Fund your perpetual futures account

How Perps Work on D0

Account Structure

Your Wallet
  └── Deposit → Main Account (holding area)
                  └── Transfer In → Sub-Account (active trading)

• Main Account: Where deposits land. Not used for trading directly.
• Sub-Account: Where your trading happens. Auto-created on your first order.

Supported Operations

Account Management:

• Deposit USDT to main account
• Withdraw USDT from main account
• Transfer funds between main and sub-account
• Check balance (equity, available, margin used)

Trading:

• Market orders (instant execution at current price)
• Limit orders (execute when price reaches your target)
• Reduce-only orders (close positions without opening new ones)
• Configurable leverage per order

Monitoring:

• View open positions with real-time PnL
• List open orders
• View order history
• Check contract specifications (min quantity, max leverage)

Example: Opening Your First Position

1. Check the Contract

You: "Show BTCUSDT perps contract info"

Bot: "BTCUSDT:

• Min quantity: 0.001 BTC
• Max leverage: 50x
• Tick size: 0.1
• Maker fee: 0.02%, Taker fee: 0.06%"

2. Fund Your Account

You: "Deposit 500 to perps and transfer to sub-account"

Bot: "Deposit complete: 500 USDT to main account. Transfer complete: 500 USDT to sub-account. Available balance: $500."

3. Place an Order

You: "Open a 10x long on BTC with 0.005 BTC"

Bot: "Order placed!

• BTCUSDT BUY MARKET 0.005 @ 10x
• Entry: $98,450
• Position value: $492.25
• Margin required: $49.23"

4. Monitor Your Position

You: "Show my positions"

Bot: "| Symbol | Side | Size | Entry | Mark | PnL | Lev | |---|---|---|---|---|---|---| | BTCUSDT | LONG | 0.005 | $98,450 | $98,900 | +$2.25 | 10x |"

5. Close the Position

You: "Close my BTC position"

Bot: "Position closed! SELL MARKET 0.005 BTCUSDT. Exit: $98,900. Realized PnL: +$2.25."

Key Concepts

Symbol Format

Always use BTCUSDT, ETHUSDT, SOLUSDT format (base token + USDT).

Leverage

Leverage is set per order. Higher leverage means higher risk and higher potential returns. Start with 5x or less while learning.

Margin

Margin is the collateral locked for your position. If your losses approach your margin, you risk liquidation.

Reduce-Only

When closing a position, the bot uses reduce-only orders to prevent accidentally opening a new position in the opposite direction.

Tips

• Always check contract specs first — Know minimum sizes and max leverage
• Start with low leverage — 5x or less until you're comfortable
• Monitor margin usage — Keep available balance healthy to avoid liquidation
• Use limit orders for entries — Better entries than market orders in most cases
• Check funding rates — High positive funding means it's expensive to hold longs