Close closes database connection

Order gets order storage

Add appends a message and triggers compaction if threshold exceeded

Run runs the automatic trading main loop

Run processes one user message through the native function-calling agent loop. Architecture: - LLM receives the api_request tool definition alongside

SafeInternalError logs internal error and returns a generic message

NewClient creates client (supports options pattern) Usage examples: // Basic usage (backward compatible) client := mcp.NewClient() // Custom log

routeWithSchema registers an HTTP route with full parameter schema documentation. schema is injected verbatim into the API docs seen by the LLM.

Normalize normalizes symbol For crypto: ensures it's a USDT trading pair For xyz dex assets (stocks, forex, commodities): uses xyz: prefix without USD

Cleanup Clean up resources

Scan implements sql.Scanner - called when reading from database Automatically decrypts the value

Trader gets trader storage

GetPositions Get all positions

ProcessTrade processes a single trade and updates position accordingly tradeTimeMs is Unix milliseconds UTC

SafeBadRequest returns a safe bad request error For validation errors, we can be more specific since they're about user input

doRequest executes HTTP request

GetTrader retrieves a trader by ID

============================================================ Dependency Injection Options ============================================================

doRequest executes HTTP request

doRequest executes HTTP request

route registers an HTTP route with a one-line description.

Position gets position storage

============================================================ Provider Configuration Options ==========================================================

formatValue formats a numeric value with sign and appropriate suffix

Get coinank openapi get request

Count returns the total number of users

parseFloat parses float value

request Send HTTP request (with retry mechanism)

CreateOrder Create order (market or limit) - uses official SDK for signing

GetName gets trader name

List gets user's trader list

GetBalance Get account balance

MustBuild builds request object, panics if failed Suitable for scenarios where build is guaranteed not to fail

NewRequestBuilder creates request builder Usage example: request := NewRequestBuilder(). WithSystemPrompt("You are helpful"). WithUserPrompt("Hello")

convertSymbol converts generic symbol to Bitget format e.g., BTCUSDT -> BTCUSDT

convertSymbol converts generic symbol to OKX format e.g. BTCUSDT -> BTC-USDT-SWAP

DefaultConfig returns default configuration

GetID gets trader ID

GetMarketPrice Get market price

WithUserPrompt adds user prompt (convenience method)

convertSymbol converts symbol format (e.g., BTCUSDT -> BTC_USDT)

skipIfJurisdictionRestricted checks if error is due to geographic restriction and skips the test if so (this is expected when running from restricted

AIModel gets AI model storage

Create creates user

NewPositionBuilder creates a new PositionBuilder

Strategy gets strategy storage

WithHTTPClient sets custom HTTP client. WARNING: The default client uses security.SafeHTTPClient() with SSRF protection (blocks private IPs, cloud me

WithModel sets model name

convertSymbolToHyperliquid converts standard symbol to Hyperliquid format Example: "BTCUSDT" -> "BTC", "TSLA" -> "xyz:TSLA", "silver" -> "xyz:SILVER"

formatFloatSlice formats float64 slice to string (using dynamic precision)

toolCall builds a mock LLM response that contains a single tool invocation.

CallWithMessages template method - fixed retry flow (cannot be overridden)

Close websocket

TelegramConfig gets Telegram bot configuration storage

WithBaseURL sets base URL

WithProvider sets provider

formatFloatWithPrecision Format float to string with specified precision (remove trailing zeros)

CreateFill creates fill record

Helper functions

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

Delete deletes trader and associated data

New creates an Agent for one chat session.

SafeNotFound returns a generic not found error

ToHTTPClient converts to http.Client

filterExcludedCoins removes excluded coins from the candidates list

* GET request

getSzDecimals gets quantity precision for coin

getTraderFromQuery Get trader from query parameter