Demo Server

🚀 Bybit MCP Interface Server Usage Guide

This guide provides a comprehensive overview of using the Bybit MCP Interface Server, including environment variable setup, API key configuration, supported trading categories, additional features, sponsorship information, and contact details.

🚀 Quick Start

Before running the server, you must set the following environment variables:

ACCESS_KEY=YOUR_BYBIT_API_KEY
SECRET_KEY=YOUR_BYBIT_SECRET_KEY
TESTNET=false # Optional: Set to true to use the testnet

✨ Features

📦 API Key Configuration

To use this Bybit API interface, you need to create an API key. Follow these steps:

1. Log in to your Bybit account.
2. Navigate to the API management page.
3. Create a new API key.
4. Important Security Settings:
   • Enable IP restrictions (if available).
   • Add the unique IP address where the server will run (external IP of your local PC, server, or Docker container).
   • Never share your API keys or expose them in public repositories.
   • Recommended Permission Settings:
     • Read (Required)
     • Trade (Required for order execution operations)
     • Wallet (Required for checking balances)

📦 Environment Variable Examples

ACCESS_KEY=2XbSafBXcYKwWNNJgZu4HtuL5YseWQYPKV7 # Example API key
SECRET_KEY=c4d36a196c08ef2e639d5f570d4708d4 # Example secret key
TESTNET=false

📦 Supported Trading Categories

💻 Spot Trading

• Functions: Account balance inquiry, order placement (limit/market orders), order cancellation, etc.

💻 Futures Trading

• Functions: Contract information inquiry, position management, order placement (limit/market orders), position closing, etc.
• Parameter Example:

// Order placement example
{
    "category": "swap",
    "symbol": "BTCUSDT",
    "side": "Buy",  // Buy or sell
    "orderType": "Limit",  // Order type
    "qty": 0.01,  // Quantity
    "price": 45000,  // Price (required for limit orders)
    "positionIdx": 0,  // Contract type identifier
    "timeInForce": "GTC"  // Time setting (optional)
}

💻 Options Trading

• Functions: Options contract information inquiry, order placement, etc.
• Parameter Example:

// Order placement example
{
    "category": "option",
    "symbol": "BTCUSDT-240615-C-45000",
    "side": "Sell",  // Sell
    "orderType": "Market",  // Market order
    "qty": 1,  // Quantity
    "positionIdx": 0  // Contract type identifier
}

📦 Additional Features

💻 Setting Stop Loss and Take Profit

{
    "category": "future",  // Futures trading category
    "symbol": "BTCUSDT",
    "side": "Long",  // Long position
    "tp_price": 46000,  // Take profit price (optional)
    "sl_price": 44000   // Stop loss price (optional)
}

💻 Querying Historical Orders

{
    "category": "spot",
    "symbol": "ETHUSDT",
    "order_id": "123456"  // Order ID
}

📦 Sponsorship Information

💻 Corporate Sponsorship

• Name: XYZ Technology Company
• Address: 123 Tech Road, Innovation City
• Contact: support@xyz.com

💻 Individual Sponsorship

• Name: Zhang San
• Email: zhangsan@example.com
• LinkedIn Link: linkedin.com/in/zhangsan

📦 Contact Information

• Email: contact@bybit.com
• Phone: +800 123456789
• Address: Bybit Company, No. 45 Blockchain Avenue, Crypto City

Thank you for using our MCP Interface Server! If you have any questions, please feel free to contact our support team.