# LuckySt Python SDK

Python client for the LuckySt Trading Terminal API. Deploy and manage automated market making instances on Kalshi, Turbine, and Polymarket.

## Install

```bash
pip install luckyst
```

## Quick Start

```python
from luckyst import LuckyStClient

client = LuckyStClient(
    base_url="https://luckyst.com/api/v1",
    username="your_username",
    password="your_password",
)

# Deploy a Kalshi instance
instance = client.deploy(
    platform="kalshi",
    markets=["KXBTC-25MAR05-B55000-T55999"],
    kalshi_api_key="xxxxxxxx-xxxx-4xxx-xxxx-xxxxxxxxxxxx",
    rsa_key_path="-----BEGIN PRIVATE KEY-----\n...",
    min_spread=2,
    max_spread=7,
    position_increment=10,
    max_position=500,
)

# Monitor
status = client.get_status(instance.id)
print(f"P&L: {status.pnl}, Position: {status.position}")

# Control
client.control(instance.id, "toggle_pause")
client.jump(instance.id, market_index=0)
client.stop(instance.id)
```

## Exchanges

### Kalshi
```python
instance = client.deploy(
    platform="kalshi",
    markets=["KXBTC-25MAR05-B55000-T55999"],
    kalshi_api_key="your-uuid-key",
    rsa_key_path="-----BEGIN PRIVATE KEY-----\n...",
)
```

### Turbine
```python
instance = client.deploy(
    platform="turbine",
    markets=["BTC"],
    turbine_private_key="0xabc...def",
    turbine_asset="BTC",
    trade_strategy="cdf",
    price_feed="pyth",
)
```

### Polymarket
```python
instance = client.deploy(
    platform="polymarket",
    markets=["ETH"],
    poly_private_key="0xabc...def",
    poly_market_type="interval",
    poly_asset="ETH",
    poly_interval="5m",
    trade_strategy="cdf",
    price_feed="pyth",
)
```