Close closes database connection

Add appends a message and triggers compaction if threshold exceeded

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

Order gets order storage

Run runs the automatic trading main loop

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

GetTrader retrieves a trader by ID

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

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

testTime returns a deterministic timestamp offset by n minutes.

Trader gets trader storage

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

GetPositions Get all positions

ParseFloatField parses a numeric string field from an exchange API response. An empty string is treated as zero, since exchanges commonly omit fields

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

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

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

Position gets position storage

doRequest executes HTTP request

doRequest executes HTTP request

doRequest executes HTTP request

GetDefaultStrategyConfig returns the default strategy configuration for the given language

formatValue formats a numeric value with sign and appropriate suffix

Count returns the total number of users

Get coinank openapi get request

GetName gets trader name

List gets user's trader list

request Send HTTP request (with retry mechanism)

* GET request

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

Delete deletes trader and associated data

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")

Strategy gets strategy storage

AIModel gets AI model storage

GetBalance Get account balance

WithUserPrompt adds user prompt (convenience method)

Create creates user

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

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

DefaultConfig returns default configuration

GetMarketPrice Get market price

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

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

convertSymbolToHyperliquid converts standard/display symbols to Hyperliquid format. Examples: "BTCUSDT" -> "BTC", "TSLA" -> "xyz:TSLA", "SAMSUNG-USDC"

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

GetID gets trader ID

NewPositionBuilder creates a new PositionBuilder

SafeNotFound returns a generic not found error

ToHTTPClient converts to http.Client

WithModel sets model name

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

NewTraderManager creates a trader manager

TelegramConfig gets Telegram bot configuration storage

WithBaseURL sets base URL

WithProvider sets provider

filterExcludedCoins removes excluded coins from the candidates list

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

parseFloat parses float value