bitget-python 1.0.2

A Python client for the Bitget API with comprehensive position management

🚀 Bitget API V2 Python Client

A comprehensive Python client for the Bitget API V2, providing extensive functionality for futures trading, account management, and market data access.

✨ Features

• 📊 Complete futures market trading capabilities
• 💼 Account management and settings
• 📈 Real-time and historical market data
• 🔄 Automatic rate limiting and request handling
• 🛡️ Comprehensive error handling and validation
• 📝 Detailed debug logging capabilities
• 🎯 Type hints and dataclass models for better code completion

🛠️ Installation

# Install using PIP
pip install git+https://github.com/Tentoxa/bitpy

🔧 Quick Start

from bitpy import BitgetAPI

# For market data only - no API keys needed
client = BitgetAPI(
    api_key=None,
    secret_key=None,
    api_passphrase=None
)

# Get market data without authentication
ticker = client.market.get_ticker(
    symbol="BTCUSDT",
    product_type="USDT-FUTURES"
)

# Get candlestick data
candles = client.market.get_candlestick(
    symbol="BTCUSDT",
    product_type="USDT-FUTURES",
    granularity="1m",
    limit=100
)

For account and position operations, API keys are required:

# For trading operations - API keys required
client = BitgetAPI(
    api_key="your_api_key",
    secret_key="your_secret_key",
    api_passphrase="your_passphrase",
    debug=True
)

# Get account information (requires authentication)
account = client.account.get_account(
    symbol="BTCUSDT",
    product_type="USDT-FUTURES",
    margin_coin="USDT"
)

🔑 Core Components

Account Management

• Account information and settings
• Leverage and margin configuration
• Position mode management
• Asset mode settings
• Interest and bill history

Position Management

• Position tracking and history
• Position tier information
• Multiple position modes support

Market Data

• Real-time tickers and depth
• Candlestick data with multiple timeframes
• Funding rates and open interest
• Historical transaction data
• Contract specifications

💹 Supported Markets

Market Type	Description
USDT-FUTURES	USDT margined futures
COIN-FUTURES	Coin margined futures
USDC-FUTURES	USDC margined futures
SUSDT-FUTURES	Simulated USDT futures
SCOIN-FUTURES	Simulated coin futures
SUSDC-FUTURES	Simulated USDC futures

⚠️ Error Handling

from bitpy.exceptions import InvalidProductTypeError, BitgetAPIError

try:
    positions = client.position.get_all_positions("INVALID-TYPE")
except InvalidProductTypeError as e:
    print(f"Invalid product type: {e}")
except BitgetAPIError as e:
    print(f"API Error {e.code}: {e.message}")

🔄 Rate Limiting

The client implements a smart token bucket algorithm for rate limiting, automatically tracking and managing request limits per endpoint to ensure optimal API usage.

📊 Advanced Market Data

# Get candlestick data
candles = client.market.get_candlestick(
    symbol="BTCUSDT",
    product_type="USDT-FUTURES",
    granularity="1m",
    limit=100
)

# Get market depth
depth = client.market.get_merge_depth(
    symbol="BTCUSDT",
    product_type="USDT-FUTURES",
    precision="0.1"
)

🤝 Contributing

Contributions are welcome! Feel free to submit a Pull Request. For feature requests or bug reports, please open an issue.

📄 License

This project is licensed under the MIT License.