Skip to main content

​
List configs

​
GET /api/bot/configs

List all bot platform configurations. Example request 
curl https://api.hyperoru.com/api/bot/configs
Example response 
[
  { "platform": "telegram", "connected": true, "chat_id": "123456" },
  { "platform": "discord", "connected": false }
]

​
Get config

​
GET /api/bot/config/

Get configuration for a specific bot platform.
​
platform
string
required
Platform name: telegram or discord.
Example request 
curl https://api.hyperoru.com/api/bot/config/telegram
Example response 
{
  "platform": "telegram",
  "connected": true,
  "chat_id": "123456",
  "bot_token": "***masked***"
}

​
Delete config

​
DELETE /api/bot/config/

Remove bot configuration for a platform.
​
platform
string
required
Platform name.
Example request 
curl -X DELETE https://api.hyperoru.com/api/bot/config/telegram
Example response 
{
  "status": "ok"
}

​
Save config

​
POST /api/bot/config

Create or update a bot platform configuration.
​
platform
string
required
Platform name.
​
bot_token
string
required
Bot authentication token.
​
chat_id
string
Target chat/channel ID.
Example request 
curl -X POST https://api.hyperoru.com/api/bot/config \
  -H "Content-Type: application/json" \
  -d '{"platform": "telegram", "bot_token": "123:ABC...", "chat_id": "123456"}'
Example response 
{
  "status": "ok"
}

​
Update status

​
PUT /api/bot/status

Enable or disable bot notifications globally.
​
enabled
boolean
required
Whether bots are enabled.
Example request 
curl -X PUT https://api.hyperoru.com/api/bot/status \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'
Example response 
{
  "status": "ok"
}

​
Get notification config

​
GET /api/bot/notification-config

Get notification preferences and filters. Example request 
curl https://api.hyperoru.com/api/bot/notification-config
Example response 
{
  "trade_notifications": true,
  "error_notifications": true,
  "signal_notifications": false,
  "min_pnl_threshold": 50.0
}

​
Update notification config

​
PUT /api/bot/notification-config

Update notification preferences.
​
trade_notifications
boolean
Notify on trade execution.
​
error_notifications
boolean
Notify on errors.
​
signal_notifications
boolean
Notify on signal triggers.
Example request 
curl -X PUT https://api.hyperoru.com/api/bot/notification-config \
  -H "Content-Type: application/json" \
  -d '{"signal_notifications": true}'
Example response 
{
  "status": "ok"
}

​
Telegram connect

​
POST /api/bot/telegram/connect

Initiate Telegram bot connection.
​
bot_token
string
required
Telegram bot token.
Example request 
curl -X POST https://api.hyperoru.com/api/bot/telegram/connect \
  -H "Content-Type: application/json" \
  -d '{"bot_token": "123:ABC..."}'
Example response 
{
  "status": "ok",
  "bot_name": "HyperOruBot"
}

​
Telegram disconnect

​
POST /api/bot/telegram/disconnect

Disconnect the Telegram bot. Example request 
curl -X POST https://api.hyperoru.com/api/bot/telegram/disconnect
Example response 
{
  "status": "ok"
}

​
Telegram retry webhook

​
POST /api/bot/telegram/retry-webhook

Retry setting up the Telegram webhook. Example request 
curl -X POST https://api.hyperoru.com/api/bot/telegram/retry-webhook
Example response 
{
  "status": "ok",
  "webhook_url": "https://example.com/api/bot/telegram/webhook"
}

​
Telegram webhook

​
POST /api/bot/telegram/webhook

Webhook endpoint for incoming Telegram messages. Called by Telegram servers. Example request 
curl -X POST https://api.hyperoru.com/api/bot/telegram/webhook \
  -H "Content-Type: application/json" \
  -d '{"update_id": 123, "message": {"text": "/status"}}'
Example response 
{
  "status": "ok"
}

​
Discord connect

​
POST /api/bot/discord/connect

Initiate Discord bot connection.
​
bot_token
string
required
Discord bot token.
​
channel_id
string
Discord channel ID for notifications.
Example request 
curl -X POST https://api.hyperoru.com/api/bot/discord/connect \
  -H "Content-Type: application/json" \
  -d '{"bot_token": "MTIz...", "channel_id": "9876543210"}'
Example response 
{
  "status": "ok"
}

​
Discord disconnect

​
POST /api/bot/discord/disconnect

Disconnect the Discord bot. Example request 
curl -X POST https://api.hyperoru.com/api/bot/discord/disconnect
Example response 
{
  "status": "ok"
}

​
Discord status

​
GET /api/bot/discord/status

Check Discord bot connection status. Example request 
curl https://api.hyperoru.com/api/bot/discord/status
Example response 
{
  "connected": true,
  "guild_name": "Trading Hub",
  "channel_name": "alerts"
}

​
Chat bindings

​
GET /api/bot/chat-bindings

List all bot chat-to-account bindings. Example request 
curl https://api.hyperoru.com/api/bot/chat-bindings
Example response 
[
  { "platform": "telegram", "chat_id": "123456", "account_id": 1 }
]