Metadata-Version: 2.4
Name: blot-sdk
Version: 0.1.0
Summary: Autonomous trading bots SDK for Solana - Self-replicating, AI-powered trading infrastructure
Author-email: BLOT Team <dev@blot.trade>
License: MIT
Project-URL: Homepage, https://blot.trade
Project-URL: Documentation, https://blot.trade/docs
Project-URL: Repository, https://github.com/blot-trade/blot-sdk
Project-URL: Issues, https://github.com/blot-trade/blot-sdk/issues
Keywords: solana,trading,bot,defi,cryptocurrency,autonomous,ai,openclaw
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: solana>=0.30.0
Requires-Dist: solders>=0.18.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: websockets>=11.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

# BLOT SDK

**Autonomous trading bots for Solana** — Self-replicating, AI-powered trading infrastructure.

[![PyPI version](https://badge.fury.io/py/blot.svg)](https://badge.fury.io/py/blot)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

- 🤖 **AI-Powered** — Integrated with OpenClaw for intelligent decision making
- 🔄 **Self-Cloning** — Bots automatically replicate across nodes for 99.99% uptime
- 🔒 **Zero-Logging** — Complete privacy, no transaction data stored
- ⚡ **High Speed** — Sub-50ms execution on Solana
- 🛠️ **Easy to Use** — Simple Python API for complex trading strategies

## Installation

```bash
pip install blot
```

## Quick Start

```python
from blot import Bot, SniperBot, DCABot

# Initialize with your wallet
bot = Bot(
    private_key="your_private_key",
    rpc_url="https://api.mainnet-beta.solana.com"
)

# Create a sniper bot
sniper = SniperBot(
    target="new",           # Snipe all new tokens
    buy_amount=0.5,         # Buy with 0.5 SOL
    take_profit=[2.0, 5.0], # Sell at 2x and 5x
    stop_loss=0.5,          # Stop loss at -50%
)

# Deploy to BLOT infrastructure
bot.deploy(sniper, duration_days=30)
```

## Available Bots

### Sniper Bot
Instantly purchase tokens the moment liquidity is added.

```python
from blot import SniperBot

bot = SniperBot(
    target="new",
    buy_amount=0.5,
    min_liquidity=10,
    take_profit=[2.0, 5.0, 10.0],
    stop_loss=0.5,
    check_honeypot=True,
    check_rug=True,
)
```

### DCA Bot
Dollar-cost averaging into any Solana token.

```python
from blot import DCABot

bot = DCABot(
    token="SOL",
    amount=100,              # USDC per purchase
    frequency="daily",
    time="09:00",
    buy_only_below=150,      # Only buy if SOL < $150
)
```

### Copy Trade Bot
Mirror the trades of successful wallets.

```python
from blot import CopyTradeBot

bot = CopyTradeBot(
    wallets=["wallet1...", "wallet2..."],
    size_mode="percentage",
    size_value=10,           # 10% of their trade size
    copy_sells=True,
)
```

### Grid Bot
Profit from sideways markets with automated grid trading.

```python
from blot import GridBot

bot = GridBot(
    base_token="SOL",
    quote_token="USDC",
    lower_price=120,
    upper_price=180,
    grid_count=20,
    total_investment=100,
)
```

## Self-Cloning

BLOT bots automatically clone themselves across distributed nodes:

```python
bot = SniperBot(
    # ... config ...
    clone_count=5,                    # Minimum active clones
    regions=["us", "eu", "asia"],     # Geographic distribution
    failover_timeout=100,             # ms before electing new leader
)
```

## AI Integration

Leverage OpenClaw AI for intelligent trading decisions:

```python
from blot import Bot, AI

bot = Bot(private_key="...")

# AI-powered market analysis
analysis = await bot.ai.analyze_token("JUP")
print(analysis.sentiment)      # bullish/bearish
print(analysis.risk_score)     # 0-100
print(analysis.recommendation) # buy/sell/hold

# AI-filtered copy trading
copy_bot = CopyTradeBot(
    wallets=["..."],
    ai_filter=True,
    ai_confidence_threshold=0.7,
)
```

## Documentation

Full documentation available at [blot.trade/docs](https://blot.trade/docs)

## Requirements

- Python 3.9+
- Solana wallet with SOL for transaction fees
- $BLOT tokens for runtime access

## Links

- Website: [blot.trade](https://blot.trade)
- Documentation: [blot.trade/docs](https://blot.trade/docs)
- Twitter: [@blaboratory](https://x.com/blaboratory)

## License

MIT License - see [LICENSE](LICENSE) for details.

