feat(info): add undocumented agents endpoint

Author: hubertkirch

hyperliquid/info.py

@@ -733,6 +733,27 @@ def user_rate_limit(self, user: str) -> Any:
     def query_spot_deploy_auction_status(self, user: str) -> Any:
         return self.post("/info", {"type": "spotDeployState", "user": user})
 
+    def extra_agents(self, user: str) -> Any:
+        """Retrieve extra agents associated with a user.
+
+        POST /info
+
+        Args:
+            user (str): Onchain address in 42-character hexadecimal format;
+                        e.g. 0x0000000000000000000000000000000000000000.
+
+        Returns:
+            [
+                {
+                    "name": str,
+                    "address": str,
+                    "validUntil": int
+                },
+                ...
+            ]
+        """
+        return self.post("/info", {"type": "extraAgents", "user": user})
+
     def _remap_coin_subscription(self, subscription: Subscription) -> None:
         if (
             subscription["type"] == "l2Book"

tests/info_test.py

@@ -244,3 +244,16 @@ def test_delegator_history():
         assert "delta" in event, "Each event should have a 'delta' field"
         assert "hash" in event, "Each event should have a transaction 'hash'"
         assert "time" in event, "Each event should have a 'time' field"
+
+
+@pytest.mark.vcr()
+def test_extra_agents():
+    info = Info(skip_ws=True, meta=TEST_META, spot_meta=TEST_SPOT_META)
+    response = info.extra_agents(user="0xd42f2bB0e06455eDB652e27b7374FC2bDa8448ee")
+    assert isinstance(response, list), "The response should be a list"
+    # Extra agents should contain agent information
+    if len(response) > 0:
+        agent = response[0]
+        assert "name" in agent, "Each agent should have a 'name' field"
+        assert "address" in agent, "Each agent should have an 'address' field"
+        assert "validUntil" in agent, "Each agent should have a 'validUntil' field"