fere-cli 0.4.0__tar.gz → 0.4.0.dev37__tar.gz

{fere_cli-0.4.0 → fere_cli-0.4.0.dev37}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: fere-cli
-Version: 0.4.0
+Version: 0.4.0.dev37
 Summary: Terminal CLI for FereAI crypto trading and research
 Author-email: Fere AI <info@fere.ai>
 License-Expression: MIT
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1
-Requires-Dist: fere-sdk>=0.5.0
+Requires-Dist: fere-sdk>=0.4.0.dev37
 Requires-Dist: httpx>=0.27
 Requires-Dist: rich>=13.0
 Provides-Extra: dev

{fere_cli-0.4.0 → fere_cli-0.4.0.dev37}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "fere-cli"
-version = "0.4.0"
+version = "0.4.0.dev37"
 description = "Terminal CLI for FereAI crypto trading and research"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
 authors = [{ name = "Fere AI", email = "info@fere.ai" }]
 dependencies = [
-    "fere-sdk>=0.5.0",
+    "fere-sdk>=0.4.0.dev37",
     "httpx>=0.27",
     "click>=8.1",
     "rich>=13.0",

fere_cli-0.4.0.dev37/src/fere_cli/commands/spot_hl.py

@@ -0,0 +1,229 @@
+"""Spot commands: fere spot (markets, orders, buy, sell, tp-sl, cancel).
+
+Venue-neutral HyperCore spot trading. Assets are base symbol only (always
+USDC-quoted); ``size`` is the base-token amount.
+"""
+
+from __future__ import annotations
+
+import click
+from rich.console import Console
+
+from ..async_util import async_command, get_client, is_tty
+from ..output import print_error, print_success
+
+console = Console()
+
+
+@click.group()
+def spot_hl():
+    """Trade HyperCore spot assets (buy, sell, tp-sl)."""
+    pass
+
+
+@spot_hl.command()
+@click.option("--search", default=None, help="Filter the asset universe.")
+@click.pass_context
+@async_command
+async def markets(ctx, search):
+    """List the tradable spot market universe."""
+    try:
+        client = await get_client(ctx)
+        data = await client.get_spot_hl_markets(search_text=search)
+        await client.close()
+        print_success(data)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@spot_hl.command()
+@click.pass_context
+@async_command
+async def orders(ctx):
+    """List open spot orders (incl. TP/SL triggers)."""
+    try:
+        client = await get_client(ctx)
+        data = await client.get_spot_hl_orders()
+        await client.close()
+        print_success(data)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@spot_hl.command()
+@click.option("--asset", required=True, help="Base asset symbol, e.g. HYPE.")
+@click.option("--size", required=True, type=float, help="Base-token amount.")
+@click.option(
+    "--order-type",
+    default="market",
+    type=click.Choice(["market", "limit"]),
+)
+@click.option("--limit-price", default=None, type=float)
+@click.option("--slippage-pct", default=0.5, type=float)
+@click.option("--tp-price", default=None, type=float, help="Take-profit.")
+@click.option("--sl-price", default=None, type=float, help="Stop-loss.")
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation.")
+@click.pass_context
+@async_command
+async def buy(
+    ctx,
+    asset,
+    size,
+    order_type,
+    limit_price,
+    slippage_pct,
+    tp_price,
+    sl_price,
+    timeout,
+    yes,
+):
+    """Buy a spot asset with USDC."""
+    if not yes and is_tty():
+        click.echo(f"Buy {size} {asset} ({order_type})")
+        if not click.confirm("Proceed?"):
+            raise SystemExit(0)
+    try:
+        client = await get_client(ctx)
+        with console.status("Buying..."):
+            result = await client.spot_hl_buy(
+                asset=asset,
+                size=size,
+                order_type=order_type,
+                limit_price=limit_price,
+                slippage_pct=slippage_pct,
+                tp_price=tp_price,
+                sl_price=sl_price,
+                timeout=timeout,
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@spot_hl.command()
+@click.option("--asset", required=True, help="Base asset symbol to sell.")
+@click.option(
+    "--size",
+    default=None,
+    type=float,
+    help="Base-token amount; omit to sell the full balance.",
+)
+@click.option(
+    "--order-type",
+    default="market",
+    type=click.Choice(["market", "limit"]),
+)
+@click.option("--limit-price", default=None, type=float)
+@click.option("--slippage-pct", default=0.5, type=float)
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation.")
+@click.pass_context
+@async_command
+async def sell(
+    ctx, asset, size, order_type, limit_price, slippage_pct, timeout, yes
+):
+    """Sell a held spot asset back to USDC."""
+    if not yes and is_tty():
+        amt = f"{size}" if size is not None else "full balance"
+        click.echo(f"Sell {amt} {asset} ({order_type})")
+        if not click.confirm("Proceed?"):
+            raise SystemExit(0)
+    try:
+        client = await get_client(ctx)
+        with console.status("Selling..."):
+            result = await client.spot_hl_sell(
+                asset=asset,
+                size=size,
+                order_type=order_type,
+                limit_price=limit_price,
+                slippage_pct=slippage_pct,
+                timeout=timeout,
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@spot_hl.command(name="tp-sl")
+@click.option("--asset", required=True, help="Held asset symbol to protect.")
+@click.option("--tp-price", default=None, type=float, help="Take-profit.")
+@click.option("--sl-price", default=None, type=float, help="Stop-loss.")
+@click.option(
+    "--size",
+    default=None,
+    type=float,
+    help="Base amount; omit for the full held balance.",
+)
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.pass_context
+@async_command
+async def tp_sl(ctx, asset, tp_price, sl_price, size, timeout):
+    """Attach reduce-side TP/SL sell triggers to a held spot asset."""
+    if tp_price is None and sl_price is None:
+        print_error("Provide at least one of --tp-price / --sl-price")
+        raise SystemExit(1)
+    try:
+        client = await get_client(ctx)
+        with console.status("Setting TP/SL..."):
+            result = await client.spot_hl_set_tp_sl(
+                asset=asset,
+                tp_price=tp_price,
+                sl_price=sl_price,
+                size=size,
+                timeout=timeout,
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@spot_hl.command()
+@click.option("--asset", required=True, help="Asset symbol of the order.")
+@click.option(
+    "--order-id", required=True, type=int, help="Venue order id (oid)."
+)
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.pass_context
+@async_command
+async def cancel(ctx, asset, order_id, timeout):
+    """Cancel an open spot order by its venue order id."""
+    try:
+        client = await get_client(ctx)
+        with console.status("Cancelling order..."):
+            result = await client.spot_hl_cancel_order(
+                asset=asset, order_id=order_id, timeout=timeout
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)

{fere_cli-0.4.0 → fere_cli-0.4.0.dev37}/src/fere_cli/main.py

@@ -12,6 +12,7 @@ from .commands.hooks import hooks
 from .commands.limit_order import limit_order
 from .commands.perp import perp
 from .commands.portfolio import holdings, notifications, wallets
+from .commands.spot_hl import spot_hl
 from .commands.swap import swap
 from .commands.utility import chains, config, status
 from .update import maybe_check_for_updates
@@ -94,6 +95,9 @@ cli.add_command(earn)
 # Perp (venue-neutral perpetual futures)
 cli.add_command(perp)
 
+# Spot (venue-neutral HyperCore spot)
+cli.add_command(spot_hl, name="spot-hl")
+
 # Utility
 cli.add_command(chains)
 cli.add_command(status)