feat(info): add extra agents info method (#206)

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/cassettes/info_test/test_extra_agents.yaml

@@ -0,0 +1,52 @@
+interactions:
+- request:
+    body: '{"type": "extraAgents", "user": "0xd42f2bB0e06455eDB652e27b7374FC2bDa8448ee"}'
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '77'
+      Content-Type:
+      - application/json
+      User-Agent:
+      - python-requests/2.32.3
+    method: POST
+    uri: https://api.hyperliquid.xyz/info
+  response:
+    body:
+      string: '[{"name":"ok","address":"0x286edfa08c04f6899dab3bfdecf2dd133f9733b9","validUntil":1767776120478},{"name":"new","address":"0xc06e6617005c1888aeb8b3017fe00f82b7b84fc0","validUntil":1771174068515}]'
+    headers:
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '194'
+      Content-Type:
+      - application/json
+      Date:
+      - Thu, 04 Sep 2025 13:52:30 GMT
+      Server:
+      - nginx/1.22.1
+      Via:
+      - 1.1 a5613e7afb4b10039b3efde5527e95c2.cloudfront.net (CloudFront)
+      X-Amz-Cf-Id:
+      - yc2KyjT9MRCS_a0SdoUv_9O1CH3UFOcK0Mik61PTbLkaVvCt4pFmHg==
+      X-Amz-Cf-Pop:
+      - IAD61-P5
+      X-Cache:
+      - Miss from cloudfront
+      access-control-allow-origin:
+      - '*'
+      access-control-expose-headers:
+      - '*'
+      vary:
+      - origin
+      - access-control-request-method
+      - access-control-request-headers
+    status:
+      code: 200
+      message: OK
+version: 1

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
+    assert len(response) > 0, "The response should contain at least one agent"
+    for agent in response:
+        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"