* Generic JSON request with standardized response * System/network errors are already intercepted and shown via toast * Only business errors are

CreateFill creates fill record

IsXyzDexAsset checks if a symbol is an xyz dex asset

Stop stops the automatic trading

Helper functions

convertSymbol converts generic symbol to KuCoin format e.g. BTCUSDT -> XBTUSDTM (KuCoin uses XBT for BTC)

Exchange gets exchange storage

New creates an Agent for one chat session.

Run starts a background loop calling syncFn at the given interval until stop is closed. After each consecutive failure the wait doubles (capped at max

getSzDecimals gets quantity precision for coin

getTraderFromQuery resolves a trader from the ?trader_id= query parameter, strictly scoped to the authenticated caller. Ownership is always enforced

CloseLong Close long position (quantity=0 means close all)

GetOpenPositions gets all open positions

GetStatus gets system status (for API)

NewIndodaxTrader creates a new Indodax trader instance

User gets user storage

calculateEMA calculates EMA

getContract fetches contract info with caching

getInstrument gets instrument info

isStaleData detects stale data (consecutive price freeze) Fix DOGEUSDT-style issue: consecutive N periods with completely unchanged prices indicate da

leftPad32 pads a byte slice to 32 bytes on the left (ABI encoding).

CloseShort Close short position (quantity=0 means close all)

Get returns the global configuration

GetOrderByExchangeID gets order by exchange order ID

GetPerpDexCoins returns current tradable USDC perp assets for a given Hyperliquid dex, served from a TTL cache. When the upstream fetch fails (e.g. HT

NewPromptBuilder creates a new prompt builder for the given language

RebuildPositionsFromTrades reconstructs complete position records from trade history This is the unified algorithm used by all exchanges Algorithm: 1

Save bot token only (Web UI sets this)

ValidateDecisionFormat validates that the decision format is correct

WithMaxRetries sets maximum retry count Usage example: client := mcp.NewClient(mcp.WithMaxRetries(5))

============================================================ AI Parameter Options ============================================================ WithMax

formatSize formats contract size

newIdleTrader returns a zero-value AutoTrader. It is safe to store in the manager map for map-semantics tests: GetStatus works on a zero value and Sto

textReply builds a mock LLM response with a plain-text final answer.

ClampLimits enforces product-level limits on strategy config to prevent token overflow.

IsXYZAsset checks if a symbol is on the xyz dex (stocks, forex, commodities). Detection is suffix-driven first, hardcoded-list second: 1. `xyz:` pref

NewFuturesTrader creates futures trader

NewGateTrader creates a new Gate trader instance

NewStrategyEngine creates strategy execution engine. claw402WalletKey is optional — if provided, nofxos data requests are routed through claw402.

RegisterProvider registers a provider factory function. Called by provider/payment sub-packages in their init() functions.

SetLeverage Set leverage

StartOrderSync starts background order sync task for OKX

============================================================ Combined Options (Convenience Methods) ==================================================

============================================================ Timeout and Retry Options ============================================================ Wi

allow reports whether a request from key is permitted at time now, consuming one token when it is.

calculateRSI calculates RSI

cancelAllGridOrders cancels all grid orders

convertSymbol converts standard symbol to Indodax format e.g. BTCIDR -> btc_idr, ETHIDR -> eth_idr

doPrivateRequest makes a signed private API POST request

getPrecision Get symbol precision information

insertTrader places a trader directly into the manager's internal map, bypassing store loading (same-package access).

revertSymbol converts symbol back to standard format (e.g., BTC_USDT -> BTCUSDT)

roundPriceToSigfigs rounds price to 5 significant figures Hyperliquid requires prices to use 5 significant figures

── Shared request plumbing ─────────────────────────────────────────────

============================================================ Builder Pattern API (Advanced Features) =================================================

CancelOrder cancels a specific order by ID

EstimateTokens estimates the total token count for a strategy configuration. This is a pure computation based on config fields — no network calls.

GetOpenOrders Get open/pending orders from exchange Returns stop-loss, take-profit, and limit orders that haven't been filled

GetPosition Get position for specified symbol

GetRequests gets all requests

GetStore gets data store (for external access to decision records, etc.)

LoadUserTradersFromStore loads traders from store for a specific user to memory

MaskSensitiveString Mask sensitive strings, showing only first 4 and last 4 characters Used to mask API Key, Secret Key, Private Key and other sensiti

NewClient creates a new Hyperliquid client for mainnet

NewPositionStore creates position storage instance

RemoveTrader removes a trader from memory (does not affect database) Used to force reload when updating trader configuration If the trader is running,

Update updates trader configuration