1#!/usr/bin/env python3
2"""
3Coinglass Long/Short Advanced Module
4 
5Provides advanced long/short data: global account ratio,
6top trader ratios, taker buy/sell by exchange, net positions.
7"""
8 
9import sys
10import json
11import argparse
12from typing import Dict, Any, List, Optional
13 
14from ._api import cg_request
15 
16 
17def _to_pair(symbol: str) -> str:
18    """Convert symbol to trading pair (BTC → BTCUSDT)."""
19    s = symbol.upper()
20    return s if s.endswith("USDT") else f"{s}USDT"
21 
22 
23# Exchange name normalization for consistent API calls
24_EXCHANGE_ALIASES = {
25    "binance": "Binance", "okx": "OKX", "bybit": "Bybit",
26    "bitget": "Bitget", "gate": "Gate", "bitmex": "Bitmex",
27    "dydx": "dYdX", "kraken": "Kraken", "coinex": "CoinEx",
28}
29 
30 
31def _normalize_exchange(name: str) -> str:
32    """Normalize exchange name to Coinglass format."""
33    return _EXCHANGE_ALIASES.get(name.lower(), name)
34 
35 
36def get_global_account_ratio(
37    symbol: str = "BTC",
38    exchange: str = "Binance",
39    interval: str = "1h"
40) -> Optional[List[Dict[str, Any]]]:
41    """
42    Get global long/short account ratio history.
43 
44    Args:
45        symbol: Coin symbol.
46        interval: Time interval (h1, h4, h12, h24).
47        exchange: Optional exchange filter.
48    """
49    params = {
50        "symbol": _to_pair(symbol),
51        "exchange": _normalize_exchange(exchange),
52        "interval": interval,
53    }
54    return cg_request(
55        "api/futures/global-long-short-account-ratio/history",
56        params=params
57    )
58 
59 
60def get_top_account_ratio(
61    symbol: str = "BTC",
62    exchange: str = "Binance",
63    interval: str = "1h"
64) -> Optional[List[Dict[str, Any]]]:
65    """
66    Get top trader long/short account ratio history.
67 
68    Args:
69        symbol: Coin symbol.
70        interval: Time interval.
71        exchange: Optional exchange filter.
72    """
73    params = {
74        "symbol": _to_pair(symbol),
75        "exchange": _normalize_exchange(exchange),
76        "interval": interval,
77    }
78    return cg_request(
79        "api/futures/top-long-short-account-ratio/history",
80        params=params
81    )
82 
83 
84def get_top_position_ratio(
85    symbol: str = "BTC",
86    exchange: str = "Binance",
87    interval: str = "1h"
88) -> Optional[List[Dict[str, Any]]]:
89    """
90    Get top trader long/short position ratio history.
91 
92    Args:
93        symbol: Coin symbol.
94        interval: Time interval.
95        exchange: Optional exchange filter.
96    """
97    params = {
98        "symbol": _to_pair(symbol),
99        "exchange": _normalize_exchange(exchange),
100        "interval": interval,
101    }
102    return cg_request(
103        "api/futures/top-long-short-position-ratio/history",
104        params=params
105    )
106 
107 
108def get_taker_buysell_exchanges(
109    symbol: str = "BTC",
110    range_type: str = "4h"
111) -> Optional[List[Dict[str, Any]]]:
112    """
113    Get taker buy/sell volume by exchange.
114 
115    Args:
116        symbol: Coin symbol.
117    """
118    return cg_request(
119        "api/futures/taker-buy-sell-volume/exchange-list",
120        params={"symbol": symbol, "range": range_type}
121    )
122 
123 
124def get_net_position(
125    symbol: str = "BTC",
126    exchange: str = "Binance",
127    interval: str = "1h"
128) -> Optional[List[Dict[str, Any]]]:
129    """
130    Get net position history (v1).
131 
132    Args:
133        symbol: Coin symbol.
134        interval: Time interval.
135        exchange: Optional exchange filter.
136    """
137    params = {
138        "symbol": _to_pair(symbol),
139        "exchange": _normalize_exchange(exchange),
140        "interval": interval,
141    }
142    return cg_request(
143        "api/futures/net-position/history", params=params
144    )
145 
146 
147def get_net_position_v2(
148    symbol: str = "BTC",
149    exchange: str = "Binance",
150    interval: str = "1h"
151) -> Optional[List[Dict[str, Any]]]:
152    """
153    Get net position history (v2 — more exchanges).
154 
155    Args:
156        symbol: Coin symbol.
157        interval: Time interval.
158        exchange: Optional exchange filter.
159    """
160    params = {
161        "symbol": _to_pair(symbol),
162        "exchange": _normalize_exchange(exchange),
163        "interval": interval,
164    }
165    return cg_request(
166        "api/futures/v2/net-position/history", params=params
167    )
168 
169 
170def main():
171    """CLI entry point."""
172    parser = argparse.ArgumentParser(
173        description="Coinglass Long/Short Advanced Tools"
174    )
175    parser.add_argument("action", choices=[
176        "global", "top-account", "top-position",
177        "taker", "net", "net-v2"
178    ])
179    parser.add_argument("--symbol", "-s", default="BTC")
180    parser.add_argument("--exchange", "-e", default=None)
181    parser.add_argument("--interval", "-i", default="h4")
182    args = parser.parse_args()
183 
184    actions = {
185        "global": lambda: get_global_account_ratio(
186            args.symbol, args.exchange or "Binance", args.interval
187        ),
188        "top-account": lambda: get_top_account_ratio(
189            args.symbol, args.exchange or "Binance", args.interval
190        ),
191        "top-position": lambda: get_top_position_ratio(
192            args.symbol, args.exchange or "Binance", args.interval
193        ),
194        "taker": lambda: get_taker_buysell_exchanges(args.symbol),
195        "net": lambda: get_net_position(
196            args.symbol, args.exchange or "Binance", args.interval
197        ),
198        "net-v2": lambda: get_net_position_v2(
199            args.symbol, args.exchange or "Binance", args.interval
200        ),
201    }
202 
203    try:
204        result = actions[args.action]()
205        print(json.dumps(result, indent=2))
206    except Exception as e:
207        print(f"Error: {e}", file=sys.stderr)
208        sys.exit(1)
209 
210 
211if __name__ == "__main__":
212    main()
213