From 7a3c990b9455d5aee9dd9fa4a88e7e31cd5cc439 Mon Sep 17 00:00:00 2001
From: RickiNano <81099017+RickiNano@users.noreply.github.com>
Date: Tue, 9 Apr 2024 22:50:27 +0200
Subject: [PATCH] election_statistics  documentation

---
 docs/commands/rpc-protocol.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/commands/rpc-protocol.md b/docs/commands/rpc-protocol.md
index dad5d260f..31fb17a9d 100644
--- a/docs/commands/rpc-protocol.md
+++ b/docs/commands/rpc-protocol.md
@@ -1689,6 +1689,34 @@ Derive deterministic keypair from **seed** based on **index**
 
 ---
 
+### election_statistics  
+_version 27.0+_ 
+
+Returns the number of each election type, the maximum and average election age from Active Election Container (AEC).
+
+Values in `max_election_age` and `average_election_age` are in seconds.
+
+**Request:**
+```json
+{
+  "action": "election_statistics"
+}
+```  
+**Response sample:**
+```json
+{
+    "normal": "152",
+    "hinted": "0",
+    "optimistic": "19",
+    "total": "171",
+    "aec_utilization_percentage": "3.42",
+    "max_election_age": "5.49",
+    "average_election_age": "0.52"
+}
+```  
+
+---
+
 ### epoch_upgrade  
 _enable_control required, version 20.0+_