trading-cli 0.3.0__py3-none-any.whl

fastbooks_cli/commands/config.py

@@ -0,0 +1,294 @@
+"""Config command group — service URLs, defaults, diagnostics."""
+
+from __future__ import annotations
+
+import os
+
+import click
+
+from ..client import FastBooksClient, DEFAULT_ROUTING_URL, DEFAULT_BOTS_URL
+from ..output import emit, emit_error
+from .. import config_store
+
+
+@click.group()
+def config():
+    """Configuration and diagnostics.
+
+    Environment variables:
+        FASTBOOKS_ROUTING_URL  — Routing/API service (default: http://localhost:3002)
+        FASTBOOKS_BOTS_URL     — Bots service (default: http://localhost:8003)
+        ALPACA_API_KEY         — Alpaca API key
+        ALPACA_API_SECRET      — Alpaca API secret
+        EODHD_API_TOKEN        — EODHD market data token
+        IBKR_ENCRYPTION_KEY    — AES-256 encryption key for IBKR credentials
+        SOLANA_RPC_URL         — Solana RPC endpoint
+    """
+    pass
+
+
+@config.command()
+@click.pass_context
+def show(ctx):
+    """Show current configuration and service URLs.
+
+    Example: fastbooks config show
+    """
+    client: FastBooksClient = ctx.obj
+    data = {
+        "routing_url": client.routing_url,
+        "bots_url": client.bots_url,
+        "timeout": client.timeout,
+        "env": {
+            "FASTBOOKS_ROUTING_URL": os.environ.get("FASTBOOKS_ROUTING_URL", f"(default: {DEFAULT_ROUTING_URL})"),
+            "FASTBOOKS_BOTS_URL": os.environ.get("FASTBOOKS_BOTS_URL", f"(default: {DEFAULT_BOTS_URL})"),
+            "ALPACA_API_KEY": "***" if os.environ.get("ALPACA_API_KEY") else "(not set)",
+            "ALPACA_API_SECRET": "***" if os.environ.get("ALPACA_API_SECRET") else "(not set)",
+            "EODHD_API_TOKEN": "***" if os.environ.get("EODHD_API_TOKEN") else "(not set)",
+            "IBKR_ENCRYPTION_KEY": "***" if os.environ.get("IBKR_ENCRYPTION_KEY") else "(not set)",
+            "SOLANA_RPC_URL": os.environ.get("SOLANA_RPC_URL", "(not set)"),
+        },
+    }
+    data["stored"] = config_store.redacted()
+    emit(ctx, data, lambda d: _format_config(d))
+
+
+@config.command("set-key")
+@click.argument("exchange")
+@click.option("--api-key", "api_key", default=None, help="Exchange API key.")
+@click.option("--secret", default=None, help="Exchange API secret / wallet key.")
+@click.option("--password", default=None, help="Passphrase (okx/kucoin/etc.), if required.")
+@click.pass_context
+def set_key(ctx, exchange, api_key, secret, password):
+    """Store trading keys for a ccxt exchange in the local config (agent-friendly, non-interactive).
+
+    e.g. fastbooks config set-key binance --api-key AK --secret SK
+    """
+    if not any([api_key, secret, password]):
+        emit_error(ctx, "Provide at least one of --api-key / --secret / --password.")
+        ctx.exit(1)
+    config_store.set_credentials(exchange, api_key, secret, password)
+    config_store.activate(exchange)
+    emit(ctx, {"exchange": exchange.lower(), "stored": True, "activated": True},
+         lambda d: f"  Stored keys for {d['exchange']} and activated it.")
+
+
+@config.command("activate")
+@click.argument("exchange")
+@click.pass_context
+def activate_cmd(ctx, exchange):
+    """Activate an exchange (data + trading if keys are set)."""
+    config_store.activate(exchange)
+    emit(ctx, {"activated": config_store.activated()}, lambda d: f"  Activated. Now: {', '.join(d['activated'])}")
+
+
+@config.command("deactivate")
+@click.argument("exchange")
+@click.pass_context
+def deactivate_cmd(ctx, exchange):
+    """Deactivate an exchange."""
+    config_store.deactivate(exchange)
+    emit(ctx, {"activated": config_store.activated()}, lambda d: f"  Deactivated. Now: {', '.join(d['activated']) or '(none)'}")
+
+
+def _format_config(data: dict) -> str:
+    lines = [
+        "",
+        "  FastBooks CLI Configuration",
+        "  ===========================",
+        f"  Routing URL:  {data['routing_url']}",
+        f"  Bots URL:     {data['bots_url']}",
+        f"  Timeout:      {data['timeout']}s",
+        "",
+        "  Environment Variables:",
+    ]
+    for key, val in data.get("env", {}).items():
+        lines.append(f"    {key}: {val}")
+    return "\n".join(lines)
+
+
+@config.command()
+@click.pass_context
+def health(ctx):
+    """Check connectivity to FastBooks services.
+
+    Tests connection to the routing API and bots service.
+
+    Example: fastbooks config health
+    """
+    client: FastBooksClient = ctx.obj
+    results = {}
+
+    # Test routing service
+    try:
+        client._get(client.routing_url, "/api/execution/venues")
+        results["routing"] = {"status": "ok", "url": client.routing_url}
+    except Exception as e:
+        results["routing"] = {"status": "error", "url": client.routing_url, "error": str(e)}
+
+    # Test bots service
+    try:
+        client._get(client.bots_url, "/bots")
+        results["bots"] = {"status": "ok", "url": client.bots_url}
+    except Exception as e:
+        results["bots"] = {"status": "error", "url": client.bots_url, "error": str(e)}
+
+    emit(ctx, results, lambda d: _format_health(d))
+
+
+def _format_health(data: dict) -> str:
+    lines = ["", "  Service Health", "  =============="]
+    for service, info in data.items():
+        status = info.get("status", "unknown")
+        color = "green" if status == "ok" else "red"
+        symbol = "+" if status == "ok" else "x"
+        line = f"  [{symbol}] {service}: {info.get('url', '?')}"
+        if info.get("error"):
+            line += f" — {info['error']}"
+        lines.append(click.style(line, fg=color))
+    return "\n".join(lines)
+
+
+@config.command()
+@click.pass_context
+def exchanges(ctx):
+    """List all supported exchanges with their capabilities and requirements.
+
+    Example: fastbooks config exchanges
+    """
+    data = {
+        "exchanges": [
+            {
+                "name": "binance",
+                "type": "CEX",
+                "markets": ["spot", "perpetual"],
+                "auth": "API key + secret",
+                "features": ["orders", "balance", "positions", "leverage"],
+                "notes": "Testnet available. Most liquid crypto exchange.",
+            },
+            {
+                "name": "bybit",
+                "type": "CEX",
+                "markets": ["spot", "perpetual"],
+                "auth": "API key + secret",
+                "features": ["orders", "balance", "positions", "leverage"],
+                "notes": "Unified trading account.",
+            },
+            {
+                "name": "okx",
+                "type": "CEX",
+                "markets": ["spot", "perpetual"],
+                "auth": "API key + secret + passphrase",
+                "features": ["orders", "balance", "positions", "leverage"],
+                "notes": "Passphrase required.",
+            },
+            {
+                "name": "kraken",
+                "type": "CEX",
+                "markets": ["spot", "perpetual"],
+                "auth": "API key + secret",
+                "features": ["orders", "balance", "positions"],
+                "notes": "Pro API for perps.",
+            },
+            {
+                "name": "coinbase",
+                "type": "CEX",
+                "markets": ["spot"],
+                "auth": "API key + secret",
+                "features": ["orders", "balance"],
+                "notes": "Advanced Trade API. Spot only.",
+            },
+            {
+                "name": "kucoin",
+                "type": "CEX",
+                "markets": ["spot"],
+                "auth": "API key + secret + passphrase",
+                "features": ["orders", "balance"],
+                "notes": "Passphrase required. Spot only.",
+            },
+            {
+                "name": "hyperliquid",
+                "type": "DEX (on-chain perps)",
+                "markets": ["perpetual"],
+                "auth": "EVM private key (64 hex chars)",
+                "features": ["orders", "positions", "leverage"],
+                "notes": "On-chain perpetuals on Arbitrum. No API secret needed, uses wallet signing.",
+            },
+            {
+                "name": "ibkr",
+                "type": "Traditional broker",
+                "markets": ["stock", "options", "forex", "futures"],
+                "auth": "Gateway connection + encrypted credentials",
+                "features": ["orders", "balance", "positions", "order_history"],
+                "notes": "Requires IB Gateway running (port 4001/4002). Paper/live modes.",
+            },
+            {
+                "name": "alpaca",
+                "type": "Traditional broker",
+                "markets": ["stock", "crypto"],
+                "auth": "API key + secret",
+                "features": ["orders", "balance"],
+                "notes": "Paper mode via sandbox flag. Commission-free stocks.",
+            },
+            {
+                "name": "deribit",
+                "type": "CEX (options)",
+                "markets": ["options", "perpetual"],
+                "auth": "API key + secret",
+                "features": ["orderbooks", "options_chain"],
+                "notes": "Options and perps. Testnet available.",
+            },
+            {
+                "name": "polymarket",
+                "type": "Prediction market (Polygon)",
+                "markets": ["prediction"],
+                "auth": "EVM private key (POLYMARKET_PRIVATE_KEY) for trading; read-only without",
+                "features": [
+                    "markets", "events", "search", "tags",
+                    "orderbooks", "prices", "price-history",
+                    "limit-orders", "market-orders", "cancel",
+                    "positions", "balance", "trades",
+                    "ctf-split", "ctf-merge", "ctf-redeem",
+                    "bridge", "approvals", "leaderboard",
+                ],
+                "notes": "Full Polymarket integration: browse, trade, CTF ops, bridging. Use 'fastbooks polymarket' subcommands.",
+            },
+            {
+                "name": "limitless",
+                "type": "Prediction market",
+                "markets": ["prediction"],
+                "auth": "None (read-only)",
+                "features": ["orderbooks"],
+                "notes": "Alternative prediction market.",
+            },
+            {
+                "name": "jupiter",
+                "type": "DEX aggregator (Solana)",
+                "markets": ["spot"],
+                "auth": "Solana wallet",
+                "features": ["tickers", "swap"],
+                "notes": "5000+ Solana tokens. Best price routing.",
+            },
+            {
+                "name": "uniswap",
+                "type": "DEX (Ethereum)",
+                "markets": ["spot"],
+                "auth": "EVM wallet",
+                "features": ["tickers", "pools"],
+                "notes": "Uniswap V3. Ethereum mainnet.",
+            },
+        ]
+    }
+    emit(ctx, data, lambda d: _format_exchanges(d))
+
+
+def _format_exchanges(data: dict) -> str:
+    lines = ["", "  Supported Exchanges", "  ===================", ""]
+    for ex in data["exchanges"]:
+        lines.append(f"  {ex['name'].upper()} ({ex['type']})")
+        lines.append(f"    Markets:  {', '.join(ex['markets'])}")
+        lines.append(f"    Auth:     {ex['auth']}")
+        lines.append(f"    Features: {', '.join(ex['features'])}")
+        lines.append(f"    Notes:    {ex['notes']}")
+        lines.append("")
+    return "\n".join(lines)