hubble-futures 0.2.13__py3-none-any.whl

hubble_futures-0.2.13.dist-info/METADATA

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: hubble-futures
+Version: 0.2.13
+Summary: Unified futures exchange client library for Hubble trading platform
+Project-URL: Homepage, https://github.com/hubble-ecosystem/hubble-futures
+Project-URL: Repository, https://github.com/hubble-ecosystem/hubble-futures
+Project-URL: Documentation, https://github.com/hubble-ecosystem/hubble-futures/blob/main/README.md
+Project-URL: Bug Tracker, https://github.com/hubble-ecosystem/hubble-futures/issues
+Author-email: Hubble Team <dev@hubble.com>
+License: MIT
+License-File: LICENSE
+Keywords: api,aster,binance,cryptocurrency,exchange,futures,trading,weex
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.10; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: python-dotenv>=1.0.0; extra == 'dev'
+Requires-Dist: responses>=0.23.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: types-requests>=2.28.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Hubble Futures
+
+Unified futures exchange client library for Hubble trading platform.
+
+## Features
+
+- **Unified Interface**: Single API for multiple exchanges
+- **Exchange Support**: Aster DEX, WEEX (Binance, OKX coming soon)
+- **Type Safe**: Full type hints and mypy strict mode
+- **Adapter Pattern**: Exchange-specific differences handled internally
+- **Retry Logic**: Automatic retry with exponential backoff for rate limits
+- **Decimal Precision**: Proper decimal formatting for all exchanges
+
+## Installation
+
+```bash
+pip install hubble-futures
+```
+
+## Quick Start
+
+```python
+from hubble_futures import create_client, ExchangeConfig
+
+# Create exchange configuration
+config = ExchangeConfig(
+    name="asterdex",
+    api_key="your_api_key",
+    api_secret="your_api_secret"
+)
+
+# Create client
+client = create_client(config)
+
+# Fetch market data
+klines = client.get_klines("BTCUSDT", "1h", 200)
+account = client.get_account()
+positions = client.get_positions()
+
+# Place order
+order = client.place_order(
+    symbol="BTCUSDT",
+    side="BUY",
+    order_type="LIMIT",
+    quantity=0.01,
+    price=50000
+)
+```
+
+## Supported Exchanges
+
+| Exchange | Name | Passphrase Required |
+|----------|------|---------------------|
+| Aster DEX | `asterdex` or `aster` | No |
+| WEEX | `weex` | Yes |
+
+### WEEX Configuration
+
+WEEX requires an additional `passphrase` parameter:
+
+```python
+config = ExchangeConfig(
+    name="weex",
+    api_key="your_api_key",
+    api_secret="your_api_secret",
+    passphrase="your_passphrase"  # Required for WEEX
+)
+```
+
+## API Reference
+
+### Market Data
+
+- `get_klines(symbol, interval, limit)` - Fetch candlestick data
+- `get_mark_price(symbol)` - Fetch mark price and funding rate
+- `get_depth(symbol, limit)` - Fetch orderbook
+- `get_ticker_24hr(symbol)` - Fetch 24h statistics
+- `get_exchange_info()` - Fetch exchange metadata
+- `get_symbol_filters(symbol)` - Fetch trading rules
+
+### Account & Trading
+
+- `get_account()` - Fetch account information
+- `get_positions(symbol)` - Fetch open positions
+- `get_balance()` - Fetch balance summary
+- `place_order(...)` - Place an order
+- `cancel_order(symbol, order_id)` - Cancel an order
+- `get_open_orders(symbol)` - Get open orders
+- `set_leverage(symbol, leverage)` - Set leverage
+- `close_position(symbol, percent)` - Close position
+
+## Development
+
+### Setup
+
+```bash
+# Clone repository
+git clone https://github.com/hubble/hubble-futures.git
+cd hubble-futures
+
+# Install dependencies
+pip install -e ".[dev]"
+```
+
+### Running Tests
+
+```bash
+# Unit tests
+pytest tests/unit -m unit
+
+# Integration tests (mocked API)
+pytest tests/integration -m integration
+
+# E2E tests (requires .env with API credentials)
+pytest tests/e2e -m e2e
+```
+
+### Code Quality
+
+```bash
+# Format check
+ruff check hubble_futures tests
+
+# Type check
+mypy hubble_futures
+
+# Coverage
+pytest --cov=hubble_futures --cov-report=html
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│  User Code                                  │
+│  (Agent, Trading Bot, etc.)                 │
+└─────────────────────────────────────────────┘
+                 ↓ uses
+┌─────────────────────────────────────────────┐
+│  Factory: create_client(config)             │
+└─────────────────────────────────────────────┘
+                 ↓ creates
+┌─────────────────────────────────────────────┐
+│  BaseFuturesClient (Abstract)               │
+│  - Unified interface                        │
+│  - Common retry logic                       │
+│  - Decimal formatting                       │
+└─────────────────────────────────────────────┘
+           ↓ implemented by
+┌─────────────┬─────────────┬─────────────────┐
+│  Aster      │  WEEX       │  Future         │
+│  Adapter    │  Adapter    │  Adapters       │
+│             │             │  (Binance, OKX) │
+└─────────────┴─────────────┴─────────────────┘
+```
+
+### Adapter Responsibilities
+
+Each exchange adapter handles:
+- API authentication (different signing methods)
+- Symbol format conversion (e.g., `BTCUSDT` ↔ `cmt_btcusdt`)
+- Parameter mapping (e.g., `side` ↔ `type`)
+- Response normalization (unified return format)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details
+
+## Contributing
+
+Contributions are welcome! Please:
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new features
+4. Ensure all tests pass (`pytest`)
+5. Submit a pull request
+
+## Support
+
+For issues and questions:
+- GitHub Issues: https://github.com/hubble/hubble-futures/issues
+- Documentation: https://docs.hubble.com/futures-client

hubble_futures-0.2.13.dist-info/RECORD

@@ -0,0 +1,11 @@
+hubble_futures/__init__.py,sha256=u3TDlDj1Khttkfwc_ytuv6SJyzNFYMPKv3uQH24S1ck,4334
+hubble_futures/aster.py,sha256=QO0aJaFZGDrK22WzSyrl6iebGNk-nx2N6E-Loo-7pmA,22549
+hubble_futures/base.py,sha256=K_ZvopbKzEmrtxjimc83cBVVhNyTtg9--KmupTG9Eqo,15365
+hubble_futures/config.py,sha256=yt09OBKhCNjqOTAQl_csOAL32HfpsFUAmDkhSYAxNgE,944
+hubble_futures/function_log.py,sha256=7Bc7naU_vwR84DyBL4lER8kC-HfRPeGWBPxQvnWBF80,9826
+hubble_futures/version.py,sha256=MnhAN1VBJNAwq5OsAtryg4nVIuz-bFXTGb_dYhAVDpU,222
+hubble_futures/weex.py,sha256=4T1P4wUDRJTfccGttO0WNjYTBfbnHI9ISR-JISEZRCg,49429
+hubble_futures-0.2.13.dist-info/METADATA,sha256=MjwVWnMXU3MIs2Rl7MWbBM6I0xTJmZoG7CCzgC8Q9M8,6945
+hubble_futures-0.2.13.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+hubble_futures-0.2.13.dist-info/licenses/LICENSE,sha256=gfURDQ-cSA67QqAYRnns4svB6qj1dAA5PrJdW9JGGRM,1068
+hubble_futures-0.2.13.dist-info/RECORD,,

hubble_futures-0.2.13.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

hubble_futures-0.2.13.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hubble Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.