Historical Data

Get Historical Server Metrics

Retrieves historical player count metrics for a specific server with smart time-based aggregation.

Overview

The API automatically determines the optimal time interval for data aggregation based on the requested time range. This ensures efficient data transfer and meaningful visualization.

Smart Time Intervals

Time Range	Interval
≤ 30 minutes	30-second intervals
≤ 1 hour	1-minute intervals
≤ 3 hours	3-minute intervals
≤ 6 hours	5-minute intervals
≤ 12 hours	10-minute intervals
≤ 24 hours	15-minute intervals
≤ 7 days	30-minute intervals
≤ 30 days	1-hour intervals
≤ 90 days	3-hour intervals
≤ 180 days	6-hour intervals

GET

stats

{serverId}

Get Historical Server Metrics

curl --request GET \
  --url https://historical-scp.daon.xyz/stats/{serverId}

[
  {
    "time": "2024-01-01T00:00:00Z",
    "players_current": 15.5,
    "players_max": 25
  },
  {
    "time": "2024-01-01T00:15:00Z",
    "players_current": 16.2,
    "players_max": 25
  }
]

Path Parameters

serverId

integer

required

Unique identifier of the server

Query Parameters

start

string<date-time>

Start time in RFC3339 format (e.g., 2024-01-01T00:00:00Z). If not specified, defaults to 24 hours before end time.

end

string<date-time>

End time in RFC3339 format. If not specified, defaults to current time.

Response

Historical server metrics with automatically determined time intervals

time

string<date-time>

required

Start time of the interval

players_current

number<float>

required

Average number of players during the interval

players_max

integer

required

Maximum player capacity during the interval

Get Data TimestampRetrieves the Unix millisecond timestamp of the last time the server list data was successfully fetched and stored. This can be used to determine data freshness and cache invalidation strategies.

Get Historical Server Metrics

curl --request GET \
  --url https://historical-scp.daon.xyz/stats/{serverId}

[
  {
    "time": "2024-01-01T00:00:00Z",
    "players_current": 15.5,
    "players_max": 25
  },
  {
    "time": "2024-01-01T00:15:00Z",
    "players_current": 16.2,
    "players_max": 25
  }
]