fere-sdk 0.5.0.dev35__tar.gz → 0.5.0.dev39__tar.gz

{fere_sdk-0.5.0.dev35 → fere_sdk-0.5.0.dev39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fere-sdk
-Version: 0.5.0.dev35
+Version: 0.5.0.dev39
 Summary: Python SDK for the FereAI Gateway API
 Author-email: Fere AI <info@fere.ai>
 License-Expression: MIT

{fere_sdk-0.5.0.dev35 → fere_sdk-0.5.0.dev39}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fere-sdk"
-version = "0.5.0.dev35"
+version = "0.5.0.dev39"
 description = "Python SDK for the FereAI Gateway API"
 readme = "README.md"
 requires-python = ">=3.10"

{fere_sdk-0.5.0.dev35 → fere_sdk-0.5.0.dev39}/src/fere_sdk/client.py

@@ -28,6 +28,10 @@ from .models import (
     PerpOpenRequest,
     PerpWithdrawRequest,
     SecurityCheckResponse,
+    SpotBuyRequest,
+    SpotCancelRequest,
+    SpotSellRequest,
+    SpotTpSlRequest,
     SwapRequest,
     TokenToCheck,
     WithdrawRequest,
@@ -169,7 +173,12 @@ class FereClient:
         timeout: int = DEFAULT_TIMEOUT,
         **kwargs,
     ) -> dict:
-        """Execute a swap and wait for completion."""
+        """Execute a swap and wait for completion.
+
+        Fully gasless for the user (no native gas token needed on any
+        chain). One call handles same-chain, cross-chain, and
+        EVM↔Solana bridge swaps, with bridging built in.
+        """
         req = SwapRequest(
             chain_id_in=chain_id_in,
             chain_id_out=chain_id_out,
@@ -384,10 +393,95 @@ class FereClient:
         )
         return await self._api.perp_withdraw(req, wait=True, timeout=timeout)
 
+    # ----------------------------------------------------------
+    # Spot (venue-neutral HyperCore spot)
+    # ----------------------------------------------------------
+
+    async def spot_hl_buy(
+        self,
+        asset: str,
+        size: float,
+        order_type: str = "market",
+        limit_price: float | None = None,
+        slippage_pct: float = 0.5,
+        tp_price: float | None = None,
+        sl_price: float | None = None,
+        timeout: int = DEFAULT_TIMEOUT,
+    ) -> dict:
+        """Buy a spot asset with USDC and wait for completion.
+
+        ``asset`` is a base symbol (USDC-quoted); ``size`` is the base-token
+        amount.
+        """
+        req = SpotBuyRequest(
+            asset=asset,
+            size=size,
+            order_type=order_type,
+            limit_price=limit_price,
+            slippage_pct=slippage_pct,
+            tp_price=tp_price,
+            sl_price=sl_price,
+        )
+        return await self._api.spot_hl_buy(req, wait=True, timeout=timeout)
+
+    async def spot_hl_sell(
+        self,
+        asset: str,
+        size: float | None = None,
+        order_type: str = "market",
+        limit_price: float | None = None,
+        slippage_pct: float = 0.5,
+        timeout: int = DEFAULT_TIMEOUT,
+    ) -> dict:
+        """Sell a held spot asset (omit size for full balance) and wait."""
+        req = SpotSellRequest(
+            asset=asset,
+            size=size,
+            order_type=order_type,
+            limit_price=limit_price,
+            slippage_pct=slippage_pct,
+        )
+        return await self._api.spot_hl_sell(req, wait=True, timeout=timeout)
+
+    async def spot_hl_set_tp_sl(
+        self,
+        asset: str,
+        tp_price: float | None = None,
+        sl_price: float | None = None,
+        size: float | None = None,
+        timeout: int = DEFAULT_TIMEOUT,
+    ) -> dict:
+        """Attach TP/SL sell triggers to a held spot asset and wait."""
+        req = SpotTpSlRequest(
+            asset=asset,
+            tp_price=tp_price,
+            sl_price=sl_price,
+            size=size,
+        )
+        return await self._api.spot_hl_set_tp_sl(req, wait=True, timeout=timeout)
+
+    async def spot_hl_cancel_order(
+        self,
+        asset: str,
+        order_id: int,
+        timeout: int = DEFAULT_TIMEOUT,
+    ) -> dict:
+        """Cancel an open spot order and wait for completion."""
+        req = SpotCancelRequest(asset=asset, order_id=order_id)
+        return await self._api.spot_hl_cancel_order(
+            req, wait=True, timeout=timeout
+        )
+
     # ----------------------------------------------------------
     # Read-only (pass-through)
     # ----------------------------------------------------------
 
+    async def get_spot_hl_markets(self, search_text: str | None = None) -> dict:
+        return await self._api.get_spot_hl_markets(search_text=search_text)
+
+    async def get_spot_hl_orders(self) -> dict:
+        return await self._api.get_spot_hl_orders()
+
     async def get_perp_markets(self, search_text: str | None = None) -> dict:
         return await self._api.get_perp_markets(search_text=search_text)
 

{fere_sdk-0.5.0.dev35 → fere_sdk-0.5.0.dev39}/src/fere_sdk/low_level.py

@@ -23,6 +23,10 @@ from .models import (
     PerpWithdrawRequest,
     SecurityCheckResponse,
     SecurityCheckSummary,
+    SpotBuyRequest,
+    SpotCancelRequest,
+    SpotSellRequest,
+    SpotTpSlRequest,
     SwapRequest,
     TaskResponse,
     TaskStatusResponse,
@@ -510,6 +514,65 @@ class FereAPI:
             "/v1/perp/withdraw", request.to_dict(), wait, timeout
         )
 
+    # ----------------------------------------------------------
+    # Spot (venue-neutral HyperCore spot)
+    # ----------------------------------------------------------
+
+    async def get_spot_hl_markets(self, search_text: str | None = None) -> dict:
+        """GET /v1/spot/markets"""
+        params = {}
+        if search_text:
+            params["search_text"] = search_text
+        return await self._authed_get("/v1/spot/markets", params=params)
+
+    async def get_spot_hl_orders(self) -> dict:
+        """GET /v1/spot/orders"""
+        return await self._authed_get("/v1/spot/orders")
+
+    async def spot_hl_buy(
+        self,
+        request: SpotBuyRequest,
+        wait: bool = False,
+        timeout: int = 120,
+    ) -> TaskResponse | dict:
+        """POST /v1/spot/buy"""
+        return await self._perp_task(
+            "/v1/spot/buy", request.to_dict(), wait, timeout
+        )
+
+    async def spot_hl_sell(
+        self,
+        request: SpotSellRequest,
+        wait: bool = False,
+        timeout: int = 120,
+    ) -> TaskResponse | dict:
+        """POST /v1/spot/sell"""
+        return await self._perp_task(
+            "/v1/spot/sell", request.to_dict(), wait, timeout
+        )
+
+    async def spot_hl_set_tp_sl(
+        self,
+        request: SpotTpSlRequest,
+        wait: bool = False,
+        timeout: int = 120,
+    ) -> TaskResponse | dict:
+        """POST /v1/spot/tp-sl"""
+        return await self._perp_task(
+            "/v1/spot/tp-sl", request.to_dict(), wait, timeout
+        )
+
+    async def spot_hl_cancel_order(
+        self,
+        request: SpotCancelRequest,
+        wait: bool = False,
+        timeout: int = 120,
+    ) -> TaskResponse | dict:
+        """POST /v1/spot/orders/cancel"""
+        return await self._perp_task(
+            "/v1/spot/orders/cancel", request.to_dict(), wait, timeout
+        )
+
     async def _perp_task(
         self,
         path: str,

{fere_sdk-0.5.0.dev35 → fere_sdk-0.5.0.dev39}/src/fere_sdk/models.py

@@ -14,6 +14,14 @@ from .perp_models import (  # noqa: E402,F401
     PerpWithdrawRequest,
 )
 
+# Spot models live in their own module; re-exported here for back-compat.
+from .spot_models import (  # noqa: E402,F401
+    SpotBuyRequest,
+    SpotCancelRequest,
+    SpotSellRequest,
+    SpotTpSlRequest,
+)
+
 __all__ = [
     "TaskResponse",
     "TaskStatusResponse",
@@ -32,6 +40,10 @@ __all__ = [
     "PerpCancelRequest",
     "PerpFundRequest",
     "PerpWithdrawRequest",
+    "SpotBuyRequest",
+    "SpotSellRequest",
+    "SpotTpSlRequest",
+    "SpotCancelRequest",
     "TokenToCheck",
     "TokenSecurityResult",
     "SecurityCheckSummary",

fere_sdk-0.5.0.dev39/src/fere_sdk/spot_models.py

@@ -0,0 +1,103 @@
+"""Venue-neutral HyperCore spot request models.
+
+Kept in a dedicated module (per the team convention of giving new model groups
+their own file) and re-exported from ``models.py``. Assets are base symbol only
+and always USDC-quoted; ``size`` is the base-token amount.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+__all__ = [
+    "SpotBuyRequest",
+    "SpotSellRequest",
+    "SpotTpSlRequest",
+    "SpotCancelRequest",
+]
+
+
+@dataclass
+class SpotBuyRequest:
+    """Buy a spot asset with USDC. size is the base-token amount."""
+
+    asset: str
+    size: float
+    order_type: str = "market"
+    limit_price: float | None = None
+    slippage_pct: float = 0.5
+    tp_price: float | None = None
+    sl_price: float | None = None
+    tp_is_market: bool = True
+    sl_is_market: bool = True
+
+    def to_dict(self) -> dict:
+        d: dict = {
+            "asset": self.asset,
+            "size": self.size,
+            "order_type": self.order_type,
+            "slippage_pct": self.slippage_pct,
+            "tp_is_market": self.tp_is_market,
+            "sl_is_market": self.sl_is_market,
+        }
+        if self.limit_price is not None:
+            d["limit_price"] = self.limit_price
+        if self.tp_price is not None:
+            d["tp_price"] = self.tp_price
+        if self.sl_price is not None:
+            d["sl_price"] = self.sl_price
+        return d
+
+
+@dataclass
+class SpotSellRequest:
+    asset: str
+    size: float | None = None
+    order_type: str = "market"
+    limit_price: float | None = None
+    slippage_pct: float = 0.5
+
+    def to_dict(self) -> dict:
+        d: dict = {
+            "asset": self.asset,
+            "order_type": self.order_type,
+            "slippage_pct": self.slippage_pct,
+        }
+        if self.size is not None:
+            d["size"] = self.size
+        if self.limit_price is not None:
+            d["limit_price"] = self.limit_price
+        return d
+
+
+@dataclass
+class SpotTpSlRequest:
+    asset: str
+    tp_price: float | None = None
+    sl_price: float | None = None
+    size: float | None = None
+    tp_is_market: bool = True
+    sl_is_market: bool = True
+
+    def to_dict(self) -> dict:
+        d: dict = {
+            "asset": self.asset,
+            "tp_is_market": self.tp_is_market,
+            "sl_is_market": self.sl_is_market,
+        }
+        if self.tp_price is not None:
+            d["tp_price"] = self.tp_price
+        if self.sl_price is not None:
+            d["sl_price"] = self.sl_price
+        if self.size is not None:
+            d["size"] = self.size
+        return d
+
+
+@dataclass
+class SpotCancelRequest:
+    asset: str
+    order_id: int
+
+    def to_dict(self) -> dict:
+        return {"asset": self.asset, "order_id": self.order_id}