Skip to main content

​
List accounts

​
GET /api/account/list

Retrieve all trading accounts.
​
include_hidden
boolean
Include accounts hidden from the dashboard. Defaults to false.
Example request 
curl "https://api.hyperoru.com/api/account/list?include_hidden=true"
Example response 
[
  {
    "id": 1,
    "name": "Main Account",
    "model": "gpt-4o",
    "account_type": "prompt",
    "initial_capital": 1000.0,
    "show_on_dashboard": true
  }
]

​
Account overview

​
GET /api/account/overview

Get a summary overview of the default account. Example request 
curl https://api.hyperoru.com/api/account/overview
Example response 
{
  "id": 1,
  "name": "Main Account",
  "model": "gpt-4o",
  "trading_enabled": true,
  "total_trades": 42
}

​
Create account

​
POST /api/account/

Create a new trading account.
​
name
string
required
Display name for the account.
​
model
string
LLM model identifier (e.g. gpt-4o, claude-sonnet-4-20250514).
​
base_url
string
Custom LLM API base URL.
​
api_key
string
LLM API key.
​
initial_capital
number
Starting capital in USD.
​
account_type
string
Account type: prompt or program.
Example request 
curl -X POST https://api.hyperoru.com/api/account/ \
  -H "Content-Type: application/json" \
  -d '{"name": "BTC Scalper", "model": "gpt-4o", "initial_capital": 5000}'
Example response 
{
  "id": 2,
  "name": "BTC Scalper",
  "model": "gpt-4o",
  "initial_capital": 5000.0
}

​
Update account

​
PUT /api/account/

Update an existing account’s configuration.
​
account_id
integer
required
Account ID.
​
name
string
Updated display name.
​
model
string
Updated LLM model.
​
base_url
string
Updated LLM base URL.
​
api_key
string
Updated API key.
Example request 
curl -X PUT https://api.hyperoru.com/api/account/2 \
  -H "Content-Type: application/json" \
  -d '{"name": "BTC Scalper v2", "model": "claude-sonnet-4-20250514"}'
Example response 
{
  "id": 2,
  "name": "BTC Scalper v2",
  "model": "claude-sonnet-4-20250514"
}

​
Delete account

​
DELETE /api/account/

Soft-delete a trading account.
​
account_id
integer
required
Account ID.
Example request 
curl -X DELETE https://api.hyperoru.com/api/account/2
Example response 
{
  "status": "ok"
}

​
Get account overview

​
GET /api/account//overview

Get detailed overview for a specific account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/account/1/overview
Example response 
{
  "id": 1,
  "name": "Main Account",
  "model": "gpt-4o",
  "trading_enabled": true,
  "total_trades": 42
}

​
Get strategy

​
GET /api/account//strategy

Retrieve the trading strategy configuration for an account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/account/1/strategy
Example response 
{
  "account_id": 1,
  "strategy_type": "prompt",
  "config": {
    "symbols": ["BTC", "ETH"],
    "interval_minutes": 30
  }
}

​
Update strategy

​
PUT /api/account//strategy

Update the trading strategy for an account.
​
account_id
integer
required
Account ID.
​
strategy_type
string
Strategy type (prompt or program).
​
config
object
Strategy-specific configuration object.
Example request 
curl -X PUT https://api.hyperoru.com/api/account/1/strategy \
  -H "Content-Type: application/json" \
  -d '{"strategy_type": "prompt", "config": {"symbols": ["BTC"], "interval_minutes": 15}}'
Example response 
{
  "status": "ok"
}

​
Trigger AI trade

​
POST /api/account//trigger-ai-trade

Manually trigger an AI trading decision for the account.
​
account_id
integer
required
Account ID.
​
symbol
string
Specific symbol to trade. If omitted, uses the account’s configured symbols.
Example request 
curl -X POST https://api.hyperoru.com/api/account/1/trigger-ai-trade \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTC"}'
Example response 
{
  "status": "ok",
  "task_id": "ai-task-123"
}

​
Disable trading

​
POST /api/account//disable-trading

Disable automated trading for an account.
​
account_id
integer
required
Account ID.
Example request 
curl -X POST https://api.hyperoru.com/api/account/1/disable-trading
Example response 
{
  "status": "ok"
}

​
Asset curve

​
GET /api/account/asset-curve

Get the portfolio value curve across all accounts. Example request 
curl https://api.hyperoru.com/api/account/asset-curve
Example response 
{
  "data": [
    { "timestamp": "2026-04-01T00:00:00Z", "value": 10000.0 },
    { "timestamp": "2026-04-02T00:00:00Z", "value": 10250.0 }
  ]
}

​
Asset curve by timeframe

​
GET /api/account/asset-curve/timeframe

Get the asset curve filtered by a specific timeframe.
​
timeframe
string
Timeframe filter: 1d, 7d, 30d, 90d, or all.
Example request 
curl "https://api.hyperoru.com/api/account/asset-curve/timeframe?timeframe=7d"
Example response 
{
  "data": [
    { "timestamp": "2026-04-03T00:00:00Z", "value": 10500.0 }
  ]
}

​
Test LLM

​
POST /api/account/test-llm

Test the LLM connection with the provided configuration.
​
model
string
required
Model identifier to test.
​
base_url
string
API base URL.
​
api_key
string
API key.
Example request 
curl -X POST https://api.hyperoru.com/api/account/test-llm \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "api_key": "sk-..."}'
Example response 
{
  "status": "ok",
  "response": "LLM connection successful"
}

​
Update dashboard visibility

​
PATCH /api/account/dashboard-visibility

Bulk update which accounts appear on the dashboard.
​
updates
array
required
Array of { account_id, show_on_dashboard } objects.
Example request 
curl -X PATCH https://api.hyperoru.com/api/account/dashboard-visibility \
  -H "Content-Type: application/json" \
  -d '{"updates": [{"account_id": 1, "show_on_dashboard": true}, {"account_id": 2, "show_on_dashboard": false}]}'
Example response 
{
  "status": "ok"
}

​
Check builder authorization

​
GET /api/account/hyperliquid/check-builder-authorization

Check whether Hyperliquid builder fee authorization is active. Example request 
curl https://api.hyperoru.com/api/account/hyperliquid/check-builder-authorization
Example response 
{
  "authorized": true,
  "builder_address": "0x..."
}

​
Approve builder

​
POST /api/account/hyperliquid/approve-builder

Submit a builder fee approval transaction to Hyperliquid.
​
account_id
integer
required
Account ID for the approval.
Example request 
curl -X POST https://api.hyperoru.com/api/account/hyperliquid/approve-builder \
  -H "Content-Type: application/json" \
  -d '{"account_id": 1}'
Example response 
{
  "status": "ok",
  "tx_hash": "0xabc..."
}

​
Check mainnet accounts

​
GET /api/account/hyperliquid/check-mainnet-accounts

Check which accounts have mainnet Hyperliquid wallets configured. Example request 
curl https://api.hyperoru.com/api/account/hyperliquid/check-mainnet-accounts
Example response 
{
  "accounts": [
    { "account_id": 1, "has_mainnet": true, "environment": "mainnet" }
  ]
}