EthoswarmSuperiorTrade_Suite
Superior Trade API v1.3.9 integration for algorithmic trading on Hyperliquid. Supports strategy creation from natural language, backtesting with full historical candle data, and live/paper deployment of cloud-hosted trading bots. Covers crypto perpetuals, spot pairs, and non-crypto assets (stocks, commodities, FX) via the HIP-3 XYZ DEX. API key obtained through agent-initiated magic-link flow: agent calls POST /auth/sign-in/magic-link with user's email, user receives API key (prefixed st_live_) directly in their inbox, and pastes it back to the agent. No website visit required.
Start or cancel a backtest by ID. Use action 'start' to begin a pending backtest, or 'cancel' to abort a running one.
Start or stop a deployment by ID. Use action 'start' to begin (live if credentials stored, paper if not) or 'stop' to halt. WRITE operation — requires explicit Steward confirmation before starting a live deployment.
Create a new backtest by submitting strategy code, configuration, and a historical timerange. Returns a backtest ID in 'pending' status. Must call SuperiorTrade_ControlBacktest with action 'start' to begin execution.
Create a new trading bot deployment with strategy code and configuration. Returns deployment ID in 'pending' status. Credentials must be submitted separately for live trading; without credentials the bot runs in paper (dry-run) mode. WRITE operation — requires explicit Steward confirmation before execution.
Delete a backtest or deployment by ID. Permanent removal — requires explicit Steward confirmation. WRITE operation.
Retrieve full backtest details including config, code, timerange, status, results metrics, and timestamps. Use after completion for comprehensive result analysis.
Poll the current status of a backtest. Returns status ('pending', 'running', 'completed', 'failed', 'cancelled') and results metrics when completed (total_trades, win_rate, total_profit, max_drawdown, sharpe_ratio).
Retrieve full deployment details including config, code, name, status, pod info, credentials status, and timestamps.
Retrieve logs for a backtest or deployment. Supports cursor-based pagination. Returns timestamped log entries with severity levels. All timestamps are UTC.
List all backtests with cursor-based pagination. Returns items array and nextCursor for paging.
List all deployments with cursor-based pagination. Returns items array and nextCursor for paging.
Initiate the magic-link authentication flow by sending an API key to the user's email. Calls POST /auth/sign-in/magic-link with the user's email address. The user receives an email containing their API key (prefixed 'st_live_') — no clickable links or verification steps. The user then pastes the key back to the agent for use in the x-api-key header on all subsequent requests. This is the ONLY way to obtain a Superior Trade API key — never direct the user to a website.
Submit Hyperliquid wallet credentials for a deployment to enable live trading. Requires an agent wallet private key (from app.hyperliquid.xyz/API) and the user's main trading wallet address. WRITE operation — requires explicit Steward confirmation with clear warning that this enables real-money trading.