1#!/usr/bin/env python3
2"""
3Coinglass Hyperliquid Module
4 
5Provides Hyperliquid-specific data: whale alerts, whale positions,
6positions by coin, user positions, and position distribution.
7"""
8 
9import sys
10import json
11import argparse
12from typing import Dict, Any, List, Optional
13 
14from ._api import cg_request
15 
16 
17def get_whale_alerts() -> Optional[List[Dict[str, Any]]]:
18    """Get Hyperliquid whale position alerts (large position changes)."""
19    return cg_request("api/hyperliquid/whale-alert")
20 
21 
22def get_whale_positions() -> Optional[List[Dict[str, Any]]]:
23    """Get current Hyperliquid whale positions."""
24    return cg_request("api/hyperliquid/whale-position")
25 
26 
27def get_positions_by_coin(
28    symbol: str = "BTC"
29) -> Optional[List[Dict[str, Any]]]:
30    """
31    Get Hyperliquid positions aggregated by coin.
32 
33    Args:
34        symbol: Coin symbol (BTC, ETH, SOL, etc.)
35    """
36    return cg_request(
37        "api/hyperliquid/position",
38        params={"symbol": symbol}
39    )
40 
41 
42def get_user_positions(
43    address: str = ""
44) -> Optional[List[Dict[str, Any]]]:
45    """
46    Get positions for a specific Hyperliquid wallet.
47 
48    Args:
49        address: Wallet address to query.
50    """
51    params = {}
52    if address:
53        params["address"] = address
54    return cg_request(
55        "api/hyperliquid/user-position",
56        params=params or None
57    )
58 
59 
60def get_position_distribution(
61    symbol: str = "BTC"
62) -> Optional[Dict[str, Any]]:
63    """
64    Get wallet position distribution for a coin on Hyperliquid.
65 
66    Args:
67        symbol: Coin symbol (BTC, ETH, SOL, etc.)
68    """
69    return cg_request(
70        "api/hyperliquid/wallet/position-distribution",
71        params={"symbol": symbol}
72    )
73 
74 
75def main():
76    """CLI entry point."""
77    parser = argparse.ArgumentParser(
78        description="Coinglass Hyperliquid Tools"
79    )
80    parser.add_argument("action", choices=[
81        "alerts", "whales", "coin", "user", "distribution"
82    ])
83    parser.add_argument("--symbol", "-s", default="BTC")
84    parser.add_argument("--address", "-a", default="")
85    args = parser.parse_args()
86 
87    actions = {
88        "alerts": get_whale_alerts,
89        "whales": get_whale_positions,
90        "coin": lambda: get_positions_by_coin(args.symbol),
91        "user": lambda: get_user_positions(args.address),
92        "distribution": lambda: get_position_distribution(args.symbol),
93    }
94 
95    try:
96        result = actions[args.action]()
97        print(json.dumps(result, indent=2))
98    except Exception as e:
99        print(f"Error: {e}", file=sys.stderr)
100        sys.exit(1)
101 
102 
103if __name__ == "__main__":
104    main()
105