Metadata-Version: 2.4
Name: falcon-sxbet-agent
Version: 0.1.0
Summary: Autonomous SX Bet sports agent — Falcon signals, local EIP-712 execution
Project-URL: Homepage, https://app.falconai.pro
Project-URL: Agent setup (app), https://app.falconai.pro/app/sx-bet/agents/client
Author: Falcon AI
License-Expression: MIT
Keywords: falcon,prediction-markets,sports,sx-bet,trading-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.11
Requires-Dist: colorlog<7,>=6.8
Requires-Dist: eth-account<1,>=0.11
Requires-Dist: falcon-agent-webui>=0.1.0
Requires-Dist: flask-cors<6,>=4.0
Requires-Dist: flask<4,>=3.0
Requires-Dist: httpx<1,>=0.27
Requires-Dist: pydantic-settings<3,>=2.0
Requires-Dist: pydantic<3,>=2.0
Requires-Dist: python-dotenv<2,>=1.0
Requires-Dist: waitress<4,>=3.0
Requires-Dist: websockets<16,>=12.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: hatchling>=1.24; extra == 'dev'
Requires-Dist: pytest<9,>=8.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# Falcon SX Bet Agent

Desktop client for **SX Bet** sports copy signals and local wallet execution.

| | |
|---|---|
| Dashboard port | **8071** |
| WebSocket provider | `sx_bet` |
| Falcon API base | `/api/v1/external/sx-bet` |

## What it does

1. Subscribes to Falcon personal copy signals (`providers: ["sx_bet"]`)
2. Applies risk rules (bankroll, caps, cooldowns)
3. **Dry-run** logs intended trades
4. **Live** enqueues fills via Falcon (`POST /execution/enqueue`), polls `GET /execution/pending`, signs with your **local Ethereum wallet** (private key never leaves your machine)

## Quick start

```bash
cd client/falcon-sxbet-client
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
pip install -e .
copy .env.example .env
falcon-sxbet-agent-check
falcon-sxbet-agent
```

Windows: `install.bat` → `check.bat` → `run.bat`

## Configuration

| Variable | Description |
|----------|-------------|
| `FALCON_API_KEY` | Claimed agent API key |
| `ETHEREUM__PRIVATE_KEY` | Hex key for EIP-712 signing (live only) |
| `EXECUTION_POLL_SECONDS` | Poll interval for pending queue (default `15`) |
| `DRY_RUN` | `true` default |

See `/downloads/SXBET-CLIENT-ENV-REFERENCE.md`.

## PyPI

```bash
pip install falcon-sxbet-agent
falcon-sxbet-agent-check
falcon-sxbet-agent
```
