version: "1.0.0" name: bybit-trading description: Trade Bybit perpetual futures via the Eterna MCP Gateway. Supports all linear USDT perpetual pairs with built-in risk management.

Bybit Perpetual Futures Trading

This skill enables trading on Bybit perpetual futures markets through the Eterna MCP Gateway.

Connection

• Gateway URL: https://mcp.eterna.exchange/mcp
• Protocol: MCP Streamable HTTP
• Authentication: Bearer token with eterna_mcp_ prefixed API key

Available Markets

All Bybit linear USDT perpetual contracts are available. Common pairs include:

• BTCUSDT
• ETHUSDT
• SOLUSDT
• XRPUSDT
• DOGEUSDT

Use the get_tickers tool to list all available pairs. Use get_instruments to check contract specifications for a specific symbol (tick size, lot size, min/max leverage).

Account Setup

Margin Mode

All sub-accounts use cross margin mode by default.

Funding

Deposit USDT to your sub-account using the get_deposit_address tool. The cheapest option is USDT on the Arbitrum network. Verify deposits with get_deposit_history.

Risk Rules

The following risk limits are enforced at the gateway level:

• Maximum leverage: 5x
• Maximum concurrent positions: 4
• Position sizing: Use equity / 4 as the base position size to allow room for multiple positions

These rules cannot be overridden by the agent.

Trade Flow

Follow these steps when executing a trade:

1. Check Balance

Call get_balance to confirm available USDT equity.

2. Research the Market

Call get_tickers to see current prices across all pairs.
Call get_instruments with the target symbol to confirm contract specs.
Call get_orderbook with the target symbol to assess liquidity and spread.

3. Set Leverage

Call set_leverage with the symbol and desired leverage (max 5x).

4. Size the Position

Calculate position size based on available equity:

• Use at most equity / 4 for any single position
• Account for the leverage multiplier when determining quantity
• Round quantity to the lot size from get_instruments

5. Place the Order

Call place_order with:
  - symbol: the trading pair (e.g., "BTCUSDT")
  - side: "Buy" or "Sell"
  - orderType: "Market" or "Limit"
  - qty: the calculated quantity as a string
  - price: required for Limit orders, omit for Market

6. Monitor the Position

Call get_positions to verify the position was opened.
Call get_open_orders to check any pending limit orders.

7. Close the Position

To close, place an order in the opposite direction for the same quantity. For example, if you are long 0.01 BTCUSDT, place a Sell Market order for 0.01 BTCUSDT.

Important Notes

• Always check your balance before placing orders.
• Always verify contract specifications with get_instruments before trading a new pair.
• Market orders execute immediately at the current market price. Limit orders require a price and may not fill immediately.
• The gateway validates all orders against risk rules before forwarding to Bybit. Orders that violate risk limits will be rejected with a descriptive error.
• Quantities and prices must be passed as strings, not numbers.