Skip to main content

​
Profile

​
GET /api/hyper-ai/profile

Get the HyperAI assistant profile and configuration. Example request 
curl https://api.hyperoru.com/api/hyper-ai/profile
Example response 
{
  "name": "HyperAI",
  "model": "gpt-4o",
  "provider": "openai",
  "skills_enabled": 5,
  "memories_count": 12
}

​
Update LLM config

​
POST /api/hyper-ai/profile/llm

Update the LLM configuration for HyperAI.
​
model
string
required
Model identifier.
​
provider
string
Provider name (openai, anthropic, custom).
​
base_url
string
Custom API base URL.
​
api_key
string
API key.
Example request 
curl -X POST https://api.hyperoru.com/api/hyper-ai/profile/llm \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-20250514", "provider": "anthropic", "api_key": "sk-ant-..."}'
Example response 
{
  "status": "ok"
}

​
Update preferences

​
POST /api/hyper-ai/profile/preferences

Update HyperAI behavioral preferences.
​
risk_tolerance
string
Risk level: low, medium, high.
​
trading_style
string
Preferred trading style.
Example request 
curl -X POST https://api.hyperoru.com/api/hyper-ai/profile/preferences \
  -H "Content-Type: application/json" \
  -d '{"risk_tolerance": "medium", "trading_style": "swing"}'
Example response 
{
  "status": "ok"
}

​
Providers

​
GET /api/hyper-ai/providers

List available LLM providers and models. Example request 
curl https://api.hyperoru.com/api/hyper-ai/providers
Example response 
[
  { "name": "openai", "models": ["gpt-4o", "gpt-4o-mini"] },
  { "name": "anthropic", "models": ["claude-sonnet-4-20250514", "claude-3-haiku"] }
]

​
Test connection

​
POST /api/hyper-ai/test-connection

Test the LLM provider connection.
​
provider
string
required
Provider to test.
​
model
string
required
Model to test.
​
api_key
string
API key to use.
Example request 
curl -X POST https://api.hyperoru.com/api/hyper-ai/test-connection \
  -H "Content-Type: application/json" \
  -d '{"provider": "openai", "model": "gpt-4o"}'
Example response 
{
  "status": "ok",
  "latency_ms": 250,
  "response": "Connection successful"
}

​
Suggestions

​
GET /api/hyper-ai/suggestions

Get AI-generated suggestions based on current market conditions and portfolio. Example request 
curl https://api.hyperoru.com/api/hyper-ai/suggestions
Example response 
{
  "suggestions": [
    { "type": "trade", "symbol": "SOL", "action": "Consider long position", "confidence": 0.72 }
  ]
}

​
List conversations

​
GET /api/hyper-ai/conversations

List all HyperAI chat conversations. Example request 
curl https://api.hyperoru.com/api/hyper-ai/conversations
Example response 
[
  { "id": "conv-ai-001", "title": "Market analysis", "created_at": "2026-04-09T10:00:00Z" }
]

​
Create conversation

​
POST /api/hyper-ai/conversations

Start a new HyperAI conversation.
​
title
string
Optional conversation title.
Example request 
curl -X POST https://api.hyperoru.com/api/hyper-ai/conversations \
  -H "Content-Type: application/json" \
  -d '{"title": "Portfolio review"}'
Example response 
{
  "id": "conv-ai-002",
  "title": "Portfolio review",
  "created_at": "2026-04-09T12:00:00Z"
}

​
Conversation messages

​
GET /api/hyper-ai/conversations//messages

Get messages in a HyperAI conversation.
​
id
string
required
Conversation ID.
Example request 
curl https://api.hyperoru.com/api/hyper-ai/conversations/conv-ai-001/messages
Example response 
[
  { "role": "user", "content": "Analyze my BTC position" },
  { "role": "assistant", "content": "Your BTC position is currently in profit..." }
]

​
Chat

​
POST /api/hyper-ai/chat

Send a message to HyperAI.
​
message
string
required
User message.
​
conversation_id
string
Existing conversation ID to continue.
Example request 
curl -X POST https://api.hyperoru.com/api/hyper-ai/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "What are the top opportunities right now?", "conversation_id": "conv-ai-001"}'
Example response 
{
  "response": "Based on current market conditions, SOL shows strong momentum...",
  "conversation_id": "conv-ai-001"
}

​
Insight

​
POST /api/hyper-ai/insight

Request a deep AI insight on a specific topic.
​
topic
string
required
Topic for the insight (e.g. portfolio_risk, market_outlook).
Example request 
curl -X POST https://api.hyperoru.com/api/hyper-ai/insight \
  -H "Content-Type: application/json" \
  -d '{"topic": "portfolio_risk"}'
Example response 
{
  "insight": "Your portfolio has a 65% concentration in BTC...",
  "risk_score": 7.2
}

​
List memories

​
GET /api/hyper-ai/memories

List HyperAI’s stored memories about your preferences and trading patterns. Example request 
curl https://api.hyperoru.com/api/hyper-ai/memories
Example response 
[
  { "id": "mem-001", "content": "User prefers swing trading BTC and ETH", "created_at": "2026-04-05T10:00:00Z" }
]

​
Delete memory

​
DELETE /api/hyper-ai/memories/

Delete a specific memory.
​
memory_id
string
required
Memory ID.
Example request 
curl -X DELETE https://api.hyperoru.com/api/hyper-ai/memories/mem-001
Example response 
{
  "status": "ok"
}

​
List skills

​
GET /api/hyper-ai/skills

List available AI skills and their enabled status. Example request 
curl https://api.hyperoru.com/api/hyper-ai/skills
Example response 
[
  { "name": "market_analysis", "enabled": true, "description": "Analyze market conditions" },
  { "name": "risk_assessment", "enabled": true, "description": "Assess portfolio risk" },
  { "name": "news_digest", "enabled": false, "description": "Summarize relevant news" }
]

​
Toggle skill

​
PUT /api/hyper-ai/skills//toggle

Enable or disable a specific AI skill.
​
skill_name
string
required
Skill name.
​
enabled
boolean
required
Whether to enable or disable.
Example request 
curl -X PUT https://api.hyperoru.com/api/hyper-ai/skills/news_digest/toggle \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'
Example response 
{
  "status": "ok"
}

​
List tools

​
GET /api/hyper-ai/tools

List available AI tools and their configurations. Example request 
curl https://api.hyperoru.com/api/hyper-ai/tools
Example response 
[
  { "name": "price_lookup", "configured": true },
  { "name": "place_order", "configured": true },
  { "name": "news_search", "configured": false }
]

​
Update tool config

​
PUT /api/hyper-ai/tools//config

Update configuration for a specific tool.
​
tool_name
string
required
Tool name.
​
config
object
required
Tool-specific configuration.
Example request 
curl -X PUT https://api.hyperoru.com/api/hyper-ai/tools/news_search/config \
  -H "Content-Type: application/json" \
  -d '{"config": {"api_key": "news-api-key", "max_results": 10}}'
Example response 
{
  "status": "ok"
}

​
Delete tool config

​
DELETE /api/hyper-ai/tools//config

Remove configuration for a tool, effectively disabling it.
​
tool_name
string
required
Tool name.
Example request 
curl -X DELETE https://api.hyperoru.com/api/hyper-ai/tools/news_search/config
Example response 
{
  "status": "ok"
}