Statistics

Activity by hour

GET/v1/guilds/:guildId/stats/hourly

NeedsOwner's keynyx+stats:read

When the server is busy: messages and member joins over the range, by weekday and hour of the day in the time zone you ask for. Shaped for a heatmap.

messages and joins are 7 rows of 24 numbers, read as messages[weekday][hour]. Weekday 0 is Sunday; hour 0 is midnight in timezone.

from and to still pick UTC days; tz only decides which weekday and hour each message or join lands in. Daylight-saving changes inside the range are applied day by day.

Query parameters

fromdate: First day, inclusive, in UTC. Defaults to 29 days before to, so the default range is 30 days.
todate: Last day, inclusive, in UTC. Defaults to today. The range may span at most 365 days.
tzstring · default UTC: IANA time zone for the weekday and hour buckets, such as Europe/Vilnius or America/New_York. Fixed offsets like +02:00 are not accepted, since they ignore daylight saving.

Errors

400 BAD_REQUEST when:

from or to is not a real date in YYYY-MM-DD form.
from is after to.
The range spans more than 365 days, counting both ends.
tz is not an IANA time zone name.

Plus the failures every endpoint shares, listed under errors & limits.

Request

$ curl "https://api.nyx.cool/v1/guilds/1467281625954914369/stats/hourly?tz=Europe/Vilnius" \
    -H "Authorization: Bearer nyx_live_..."

Response200

{
  "guildId": "1467281625954914369",
  "from": "2026-09-05",
  "to": "2026-10-04",
  "timezone": "Europe/Vilnius",
  "messages": [
    [31, 16, 10, 5, 5, 5, 10, 21, 36, 52, 62, 73, 83, 78, 73, 78, 94, 114, 140, 161, 172, 151, 104, 57],
    [19, 10, 6, 3, 3, 3, 6, 13, 22, 32, 38, 45, 51, 48, 45, 48, 58, 70, 86, 99, 106, 93, 64, 35],
    [20, 10, 7, 3, 3, 3, 7, 14, 24, 34, 41, 48, 54, 51, 48, 51, 61, 75, 92, 105, 112, 99, 68, 37],
    [22, 11, 7, 4, 4, 4, 7, 14, 25, 36, 43, 50, 58, 54, 50, 54, 65, 79, 97, 112, 119, 104, 72, 40],
    [23, 11, 8, 4, 4, 4, 8, 15, 27, 38, 46, 53, 61, 57, 53, 57, 68, 84, 103, 118, 125, 110, 76, 42],
    [26, 13, 9, 4, 4, 4, 9, 18, 31, 44, 53, 62, 70, 66, 62, 66, 79, 97, 119, 136, 145, 128, 88, 48],
    [34, 17, 11, 6, 6, 6, 11, 22, 39, 56, 67, 78, 90, 84, 78, 84, 101, 123, 151, 174, 185, 162, 112, 62]
  ],
  "joins": [
    [1, 0, 0, 0, 0, 0, 0, 1, 1, 2, 2, 2, 3, 2, 2, 2, 3, 4, 4, 5, 5, 5, 3, 2],
    [1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 1, 2, 2, 2, 3, 3, 3, 3, 2, 1],
    [1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 1, 2, 2, 2, 3, 3, 4, 3, 2, 1],
    [1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 3, 3, 4, 3, 2, 1],
    [1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 2, 2, 2, 2, 2, 2, 3, 3, 4, 4, 3, 2, 1],
    [1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 3, 4, 4, 5, 4, 3, 2],
    [1, 1, 0, 0, 0, 0, 0, 1, 1, 2, 2, 2, 3, 3, 2, 3, 3, 4, 5, 5, 6, 5, 4, 2]
  ]
}

Response400

{
  "code": "BAD_REQUEST",
  "message": "tz must be an IANA time zone name, such as Europe/Vilnius or America/New_York"
}