Skip to main content
An AI Trader is the central account entity in Hyperoru. It holds exchange credentials, LLM configuration, and serves as the execution context for all bound strategies.

​
What is an AI Trader?

Each trader operates as an independent trading account with:
  • Exchange wallet — Hyperliquid or Binance credentials for order execution
  • LLM configuration — model, API key, and base URL for prompt-based strategies
  • Strategy bindings — connected prompts and/or programs that generate trading decisions
  • Trading history — complete audit trail of every decision and order
A single Hyperoru instance can run many traders simultaneously, each with different strategies, exchanges, and AI models.

​
Creating a trader

1

Create the trader entity

curl -X POST https://api.hyperoru.com/api/traders \
  -H "Content-Type: application/json" \
  -d '{
    "name": "BTC Momentum",
    "description": "Trend-following strategy for BTC perpetuals",
    "user_id": "your-user-id"
  }'
2

Configure LLM settings

Set the AI model that will power prompt-based decisions:
curl -X PUT https://api.hyperoru.com/api/traders/{trader_id}/llm \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "api_key": "sk-your-api-key",
    "base_url": "https://api.openai.com/v1"
  }'
Hyperoru supports any OpenAI-compatible API. Use Anthropic, Google, DeepSeek, or local models by changing the base_url and model fields.
3

Connect exchange credentials

Link the trader to an exchange account. See Exchange Setup for details.
4

Bind a strategy

Connect a prompt or program to the trader. See Prompt Strategies or Program Strategies.

​
LLM provider support

ProviderBase URLExample models
OpenAIhttps://api.openai.com/v1gpt-4o, gpt-4o-mini
Anthropichttps://api.anthropic.com/v1claude-sonnet-4-20250514, claude-3-5-haiku-20241022
Googlehttps://generativelanguage.googleapis.com/v1betagemini-2.0-flash
DeepSeekhttps://api.deepseek.com/v1deepseek-chat, deepseek-reasoner
Localhttp://localhost:11434/v1Any Ollama model

​
Dashboard visibility

Traders appear on the dashboard with real-time status indicators:
StatusMeaning
ActiveTrader is running and processing signals/schedules
PausedTrader exists but is not executing strategies
ErrorLast execution failed — check logs for details
Toggle a trader’s active state: 
curl -X PUT https://api.hyperoru.com/api/traders/{trader_id}/status \
  -H "Content-Type: application/json" \
  -d '{"active": false}'

​
Soft deletion

Deleting a trader performs a soft delete — the record is marked as deleted but preserved in the database for historical analytics and audit purposes. 
curl -X DELETE https://api.hyperoru.com/api/traders/{trader_id}
Soft-deleted traders no longer execute strategies but their trade history remains accessible through the analytics API.