Skip to main content

​
GET /stats

Returns real-time statistics about the bot. Results are cached in Redis for 5 minutes. No authentication is required. Authentication: None. Rate-limited to 30 requests per minute per IP.

​
Response fields

​
servers
integer
Number of Discord servers the bot is currently in.
​
members
integer
Total member count across all servers.
​
commandsServed
integer
Total number of slash commands executed (sourced from the database).
​
activeConversations
integer
Number of active AI conversation channels in memory.
​
uptime
number
Bot process uptime in seconds.
​
messagesProcessed
integer
Total messages processed by the AI system (sourced from the database).
​
cachedAt
string
ISO 8601 timestamp indicating when the cached stats were last computed.

​
Example

curl https://volvox.bot/api/v1/stats

{
  "servers": 12,
  "members": 6241,
  "commandsServed": 48302,
  "activeConversations": 7,
  "uptime": 432000,
  "messagesProcessed": 183400,
  "cachedAt": "2026-03-21T09:55:00.000Z"
}
If the stats cache cannot be refreshed due to a Redis or database failure, the endpoint returns a 503 response with zeroed counters and the current uptime.

Build docs developers (and LLMs) love

Get started for freeTalk to us