API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Stats & logs

Summarise rotations of one slot in a range (success rate, unique IPs, average time)

Use this to judge rotation quality of a slot. Counts success, failed and duplicated rotations, the average rotation time in seconds, and lists each distinct IPv4 with how often it was seen (least seen first).

  • Read only
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: routine call
  • getRotationHistoryAnalysis
GET/v2/rotation_history_analysis

Query parameters

positionintegerrequired
start_dateintegerrequired

Epoch seconds.

end_dateintegerrequired

Epoch seconds.

Responses

Analysis or an error.

statusbooleanoptional
msgstringoptional
dataobjectoptional
data.total_itemsintegeroptional
data.total_successintegeroptional
data.total_failedintegeroptional
data.total_duplicatedintegeroptional
data.avg_rotation_timenumber | nulloptional
data.total_unique_ipintegeroptional
data.unique_itemsobject[]optional
data.unique_items[].posintegeroptional
data.unique_items[].current_ip4string | nulloptional
data.unique_items[].current_ip6string | nulloptional
data.unique_items[].occurrencesintegeroptional

Errors returned in msg

msgMeaningWhat to do
Have an error during request! Contact administrator!A parameter is missing or not a number or the query failed.Send integer position and epoch-second dates.
Verified against XProxy v21.3.2 on Nov 17, 2026