falcon-limitless-agent 0.1.0__tar.gz

falcon_limitless_agent-0.1.0/.env.example

@@ -0,0 +1,18 @@
+# Falcon Limitless Agent — copy to .env and fill in values
+FALCON_API_KEY=
+FALCON_WS_URL=wss://api.falconai.pro/ws/signals
+FALCON_API_BASE=https://api.falconai.pro/api/v1/external/limitless
+SIGNAL_PROVIDERS=limitless
+DASHBOARD_PORT=8070
+DRY_RUN=true
+LOG_LEVEL=INFO
+
+# Optional: local Limitless HMAC (otherwise store creds in Falcon dashboard)
+LIMITLESS__API_KEY=
+LIMITLESS__SECRET=
+LIMITLESS__PROFILE_ID=
+
+TRADING__BANKROLL_USD=1000
+TRADING__MAX_POSITION_USD=50
+TRADING__MAX_DAILY_SPEND_USD=200
+TRADING__MAX_OPEN_POSITIONS=10

falcon_limitless_agent-0.1.0/.gitignore

@@ -0,0 +1,61 @@
+# ── Secrets — NEVER commit ────────────────────────────────────────────────────
+.env
+*.env
+!.env.example
+!backend/.env.example
+secrets/
+*.pem
+*.key
+*.p12
+
+# ── Node / Backend ────────────────────────────────────────────────────────────
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.yarn-integrity
+
+# ── Frontend build ────────────────────────────────────────────────────────────
+frontend/dist/
+frontend/build/
+frontend/.vite/
+
+# ── Logs ──────────────────────────────────────────────────────────────────────
+logs/
+*.log
+
+# ── Python (docs/polymarket-copier) ──────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*.pyo
+.Python
+packages/falcon-polymarket-python/dist/
+packages/falcon-mcp-server/*.tgz
+venv/
+.venv/
+env/
+
+# ── IDE ───────────────────────────────────────────────────────────────────────
+.vscode/
+.idea/
+*.swp
+.DS_Store
+Thumbs.db
+
+# ── OS ───────────────────────────────────────────────────────────────────────
+Thumbs.db
+desktop.ini
+
+# ── Test / coverage ───────────────────────────────────────────────────────────
+coverage/
+.nyc_output/
+jest-results/
+
+# ── Uploads & generated files ─────────────────────────────────────────────────
+uploads/
+generated/
+
+# ── Cursor IDE workspace files ────────────────────────────────────────────────
+.cursor/
+*.cursor-*

falcon_limitless_agent-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: falcon-limitless-agent
+Version: 0.1.0
+Summary: Autonomous Limitless Exchange agent — Falcon signals, HMAC execution via Falcon API
+Project-URL: Homepage, https://app.falconai.pro
+Project-URL: Agent setup (app), https://app.falconai.pro/app/limitless/agents/client
+Author: Falcon AI
+License-Expression: MIT
+Keywords: falcon,limitless,prediction-markets,sports,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: 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 Limitless Agent
+
+Desktop client for **Limitless Exchange** copy signals and live execution.
+
+| | |
+|---|---|
+| Dashboard port | **8070** |
+| WebSocket provider | `limitless` |
+| Falcon API base | `/api/v1/external/limitless` |
+
+## What it does
+
+1. Subscribes to Falcon personal copy signals (`providers: ["limitless"]`)
+2. Applies bankroll, position-size, and daily-cap risk rules
+3. **Dry-run** (default) logs intended trades without placing orders
+4. **Live** posts orders via Falcon (`POST /orders`) using HMAC credentials stored in the Falcon app
+
+## Quick start
+
+```bash
+cd client/falcon-limitless-client
+python -m venv .venv
+.venv\Scripts\activate          # Windows
+# source .venv/bin/activate     # Mac/Linux
+pip install -r requirements.txt
+pip install -e .
+copy .env.example .env          # fill FALCON_API_KEY
+falcon-limitless-agent-check
+falcon-limitless-agent
+```
+
+Or on Windows: `install.bat` → `check.bat` → `run.bat`
+
+## Configuration
+
+| Variable | Description |
+|----------|-------------|
+| `FALCON_API_KEY` | Falcon agent API key (Integration → API keys) |
+| `FALCON_WS_URL` | Signal WebSocket (default `wss://api.falconai.pro/ws/signals`) |
+| `FALCON_API_BASE` | Agent SDK base URL |
+| `SIGNAL_PROVIDERS` | `limitless` |
+| `DRY_RUN` | `true` (default) or `false` for live |
+| `DASHBOARD_PORT` | `8070` |
+
+Store **Limitless HMAC** credentials at [/app/limitless/agents/client](https://app.falconai.pro/app/limitless/agents/client) before setting `DRY_RUN=false`.
+
+See also: `docs/CLIENT-ENV-REFERENCE.md` and `/downloads/LIMITLESS-CLIENT-ENV-REFERENCE.md`.
+
+## PyPI
+
+```bash
+pip install falcon-limitless-agent
+falcon-limitless-agent-check
+falcon-limitless-agent
+```

falcon_limitless_agent-0.1.0/README.md

@@ -0,0 +1,55 @@
+# Falcon Limitless Agent
+
+Desktop client for **Limitless Exchange** copy signals and live execution.
+
+| | |
+|---|---|
+| Dashboard port | **8070** |
+| WebSocket provider | `limitless` |
+| Falcon API base | `/api/v1/external/limitless` |
+
+## What it does
+
+1. Subscribes to Falcon personal copy signals (`providers: ["limitless"]`)
+2. Applies bankroll, position-size, and daily-cap risk rules
+3. **Dry-run** (default) logs intended trades without placing orders
+4. **Live** posts orders via Falcon (`POST /orders`) using HMAC credentials stored in the Falcon app
+
+## Quick start
+
+```bash
+cd client/falcon-limitless-client
+python -m venv .venv
+.venv\Scripts\activate          # Windows
+# source .venv/bin/activate     # Mac/Linux
+pip install -r requirements.txt
+pip install -e .
+copy .env.example .env          # fill FALCON_API_KEY
+falcon-limitless-agent-check
+falcon-limitless-agent
+```
+
+Or on Windows: `install.bat` → `check.bat` → `run.bat`
+
+## Configuration
+
+| Variable | Description |
+|----------|-------------|
+| `FALCON_API_KEY` | Falcon agent API key (Integration → API keys) |
+| `FALCON_WS_URL` | Signal WebSocket (default `wss://api.falconai.pro/ws/signals`) |
+| `FALCON_API_BASE` | Agent SDK base URL |
+| `SIGNAL_PROVIDERS` | `limitless` |
+| `DRY_RUN` | `true` (default) or `false` for live |
+| `DASHBOARD_PORT` | `8070` |
+
+Store **Limitless HMAC** credentials at [/app/limitless/agents/client](https://app.falconai.pro/app/limitless/agents/client) before setting `DRY_RUN=false`.
+
+See also: `docs/CLIENT-ENV-REFERENCE.md` and `/downloads/LIMITLESS-CLIENT-ENV-REFERENCE.md`.
+
+## PyPI
+
+```bash
+pip install falcon-limitless-agent
+falcon-limitless-agent-check
+falcon-limitless-agent
+```

falcon_limitless_agent-0.1.0/agent_bootstrap.py

@@ -0,0 +1,11 @@
+"""Ensure this agent's source directory wins import resolution when co-installed with falcon-polymarket-agent."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+_AGENT_ROOT = Path(__file__).resolve().parent
+_ROOT = str(_AGENT_ROOT)
+if _ROOT not in sys.path:
+    sys.path.insert(0, _ROOT)

falcon_limitless_agent-0.1.0/config.py

@@ -0,0 +1,127 @@
+"""Limitless Exchange agent configuration."""
+
+from __future__ import annotations
+
+from typing import Any, List, Literal
+
+from dotenv import load_dotenv
+from pydantic import Field, field_validator, model_validator
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+from paths import client_root
+
+load_dotenv(client_root() / ".env", override=False)
+
+MIN_ORDER_USD = 1.0
+
+_RISK_PRESETS = {
+    "conservative": {"kelly_multiplier": 0.10, "max_bankroll_pct": 0.02},
+    "balanced": {"kelly_multiplier": 0.25, "max_bankroll_pct": 0.05},
+    "aggressive": {"kelly_multiplier": 0.50, "max_bankroll_pct": 0.10},
+}
+
+
+class LimitlessAgentConfig(BaseSettings):
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        env_nested_delimiter="__",
+        case_sensitive=False,
+        extra="ignore",
+    )
+
+    falcon_api_key: str = ""
+    falcon_ws_url: str = "wss://api.falconai.pro/ws/signals"
+    falcon_api_base: str = "https://api.falconai.pro/api/v1/external/limitless"
+
+    limitless__api_key: str = Field("", description="Optional local Limitless HMAC key")
+    limitless__secret: str = Field("", description="Optional local Limitless HMAC secret (base64)")
+    limitless__profile_id: str = Field("", description="Limitless profile id for x-on-behalf-of")
+
+    signal_categories: str = ""
+    signal_types: str = ""
+    signal_providers: str = Field("limitless", description="WS provider filter")
+    sync_strategies_on_start: bool = False
+    signal_min_edge: float = Field(0.0, ge=0.0)
+    signal_min_confidence: float = Field(0.0, ge=0.0, le=1.0)
+
+    trading__bankroll_usd: float = 1000.0
+    trading__max_position_usd: float = 50.0
+    trading__max_daily_spend_usd: float = 200.0
+    trading__max_open_positions: int = 10
+    trading__max_drawdown_usd: float = Field(0.0, ge=0.0)
+    trading__max_drawdown_pct: float = Field(0.0, ge=0.0, le=100.0)
+    trading__drawdown_window_days: int = Field(7, ge=1, le=90)
+    trading__max_daily_loss_usd: float = Field(0.0, ge=0.0)
+    trading__max_trades_per_day: int = Field(0, ge=0)
+    trading__max_pending_exposure_usd: float = Field(0.0, ge=0.0)
+    trading__max_per_market_usd: float = Field(0.0, ge=0.0)
+    trading__one_position_per_market: bool = False
+    trading__category_daily_caps: str = Field("", description="e.g. sports:50")
+    trading__trading_hours_utc: str = Field("", description="e.g. 09:00-17:00")
+    trading__blackout_hours_utc: str = Field("")
+    trading__cooldown_minutes_after_loss: int = Field(0, ge=0)
+    trading__min_minutes_between_trades: int = Field(0, ge=0)
+
+    risk_level: Literal["conservative", "balanced", "aggressive"] = "balanced"
+    dry_run: bool = True
+    log_level: str = "INFO"
+    dashboard_port: int = 8070
+    report_stats_to_platform: bool = False
+
+    @model_validator(mode="before")
+    @classmethod
+    def _ignore_empty_env_strings(cls, data: Any) -> Any:
+        if isinstance(data, dict):
+            return {k: v for k, v in data.items() if not (isinstance(v, str) and v.strip() == "")}
+        return data
+
+    @field_validator("limitless__api_key", "limitless__secret", mode="before")
+    @classmethod
+    def _strip(cls, v: object) -> object:
+        return v.strip() if isinstance(v, str) else v
+
+    @property
+    def categories(self) -> List[str]:
+        raw = self.signal_categories.strip()
+        if not raw or raw.lower() == "all":
+            return []
+        return [c.strip() for c in raw.split(",") if c.strip()]
+
+    @property
+    def providers(self) -> List[str]:
+        raw = self.signal_providers.strip()
+        if not raw or raw.lower() == "all":
+            return []
+        return [p.strip() for p in raw.split(",") if p.strip()]
+
+    @property
+    def allowed_signal_types(self) -> List[str]:
+        raw = self.signal_types.strip()
+        if not raw:
+            return []
+        return [t.strip() for t in raw.split(",") if t.strip()]
+
+    @property
+    def kelly_multiplier(self) -> float:
+        return _RISK_PRESETS[self.risk_level]["kelly_multiplier"]
+
+    @property
+    def max_bankroll_pct(self) -> float:
+        return _RISK_PRESETS[self.risk_level]["max_bankroll_pct"]
+
+    @property
+    def category_daily_caps_map(self) -> dict:
+        from risk_metrics import parse_category_caps
+
+        return parse_category_caps(self.trading__category_daily_caps)
+
+
+_cfg: LimitlessAgentConfig | None = None
+
+
+def get_config() -> LimitlessAgentConfig:
+    global _cfg
+    if _cfg is None:
+        _cfg = LimitlessAgentConfig()
+    return _cfg

falcon_limitless_agent-0.1.0/config_util.py

@@ -0,0 +1,25 @@
+"""Shared config helpers."""
+
+from __future__ import annotations
+
+import re
+
+_PLACEHOLDER_KEY = re.compile(
+    r"(REPLACE|your_|placeholder|changeme|xxx|test_key)",
+    re.I,
+)
+
+
+def is_placeholder_api_key(key: str) -> bool:
+    k = (key or "").strip()
+    if not k:
+        return True
+    if not (k.startswith("fai_") or k.startswith("aif_")):
+        return True
+    if _PLACEHOLDER_KEY.search(k):
+        return True
+    return len(k) < 12
+
+
+def is_runnable_api_key(key: str) -> bool:
+    return not is_placeholder_api_key(key)

falcon_limitless_agent-0.1.0/docs/CLIENT-ENV-REFERENCE.md

@@ -0,0 +1,42 @@
+# Falcon Limitless Agent — environment reference
+
+Copy `falcon-limitless-client.env.example` to `.env` in your client folder.
+
+## Required
+
+| Variable | Example | Notes |
+|----------|---------|-------|
+| `FALCON_API_KEY` | `aif_…` | Claimed sandbox agent key or Integration API key |
+
+## Falcon platform
+
+| Variable | Default | Notes |
+|----------|---------|-------|
+| `FALCON_WS_URL` | `wss://api.falconai.pro/ws/signals` | Personal copy signal stream |
+| `FALCON_API_BASE` | `https://api.falconai.pro/api/v1/external/limitless` | Agent SDK |
+| `SIGNAL_PROVIDERS` | `limitless` | WebSocket filter |
+| `SIGNAL_CATEGORIES` | *(empty = all)* | Comma list, e.g. `sports` |
+| `DASHBOARD_PORT` | `8070` | Local web UI |
+| `DRY_RUN` | `true` | Set `false` only after preflight + HMAC creds in Falcon |
+
+## Risk limits
+
+| Variable | Default |
+|----------|---------|
+| `TRADING__BANKROLL_USD` | `1000` |
+| `TRADING__MAX_POSITION_USD` | `50` |
+| `TRADING__MAX_DAILY_SPEND_USD` | `200` |
+| `TRADING__MAX_OPEN_POSITIONS` | `10` |
+| `RISK_LEVEL` | `balanced` (`conservative` / `aggressive`) |
+
+## Limitless credentials
+
+Prefer storing HMAC in the Falcon dashboard. Optional local overrides:
+
+| Variable | Notes |
+|----------|-------|
+| `LIMITLESS__API_KEY` | Limitless API key |
+| `LIMITLESS__SECRET` | Base64 HMAC secret |
+| `LIMITLESS__PROFILE_ID` | Profile for `x-on-behalf-of` |
+
+Live orders use server-stored credentials via `POST /orders` on the Falcon Agent SDK.