1"""
2Coinglass Extension - Crypto Derivatives Data Tools
3 
4Provides crypto derivatives market data including:
5- Funding rates (V2 API)
6- Open interest (V2 API)
7- Long/Short ratios (V2 API)
8- Liquidations (V2/V4 API)
9- Futures market data (V4 API)
10  - Supported coins and exchanges
11  - Comprehensive market data for all coins
12  - Pair-specific market metrics
13  - OHLC price history
14 
15Environment Variables Required:
16- COINGLASS_API_KEY: Coinglass API key
17 
18Usage:
19    This extension is auto-loaded by the ExtensionLoader.
20    Tools are available to agents configured with these tools in agents.yaml.
21"""
22import os
23import sys
24import logging
25from typing import List
26 
27try:
28    from core.tool import ToolRegistry
29except Exception:
30    ToolRegistry = None  # Standalone script usage
31 
32logger = logging.getLogger(__name__)
33 
34# Add local tools directory to path for imports
35TOOLS_DIR = os.path.join(os.path.dirname(__file__), 'tools')
36if TOOLS_DIR not in sys.path:
37    sys.path.insert(0, TOOLS_DIR)
38 
39 
40def register(api) -> List[str]:
41    """
42    Extension entry point - register all Coinglass tools.
43 
44    Args:
45        api: ExtensionApi instance with registry and config
46 
47    Returns:
48        List of registered tool names
49    """
50    registered = []
51 
52    try:
53        from .coinglass import (
54            FundingRateTool,
55            LongShortRatioTool,
56            GlobalAccountRatioTool,
57            TopAccountRatioTool,
58            TopPositionRatioTool,
59            TakerBuySellExchangesTool,
60            NetPositionTool,
61            OpenInterestTool,
62            LiquidationsTool,
63            LiquidationAnalysisTool,
64            CoinLiquidationHistoryTool,
65            PairLiquidationHistoryTool,
66            LiquidationCoinListTool,
67            LiquidationOrdersTool,
68            HyperliquidWhaleAlertsTool,
69            HyperliquidWhalePositionsTool,
70            HyperliquidPositionsByCoinTool,
71            HyperliquidPositionDistributionTool,
72            SupportedCoinsTool,
73            SupportedExchangesTool,
74            CoinsMarketDataTool,
75            PairMarketDataTool,
76            OHLCHistoryTool,
77            TakerVolumeHistoryTool,
78            AggregatedTakerVolumeTool,
79            CumulativeVolumeDeltaTool,
80            CoinNetflowTool,
81            WhaleTransferTool,
82            BTCETFFlowsTool,
83            BTCETFPremiumDiscountTool,
84            BTCETFHistoryTool,
85            BTCETFListTool,
86            HKBTCETFFlowsTool,
87            ETHETFFlowsTool,
88            ETHETFListTool,
89            SOLETFFlowsTool,
90            XRPETFFlowsTool,
91        )
92        # Register existing V2 tools
93        api.register_tool(FundingRateTool())
94        api.register_tool(LongShortRatioTool())
95 
96        # Register advanced long/short ratio tools
97        api.register_tool(GlobalAccountRatioTool())
98        api.register_tool(TopAccountRatioTool())
99        api.register_tool(TopPositionRatioTool())
100        api.register_tool(TakerBuySellExchangesTool())
101        api.register_tool(NetPositionTool())
102 
103        api.register_tool(OpenInterestTool())
104        api.register_tool(LiquidationsTool())
105        api.register_tool(LiquidationAnalysisTool())
106 
107        # Register advanced liquidation tools
108        api.register_tool(CoinLiquidationHistoryTool())
109        api.register_tool(PairLiquidationHistoryTool())
110        api.register_tool(LiquidationCoinListTool())
111        api.register_tool(LiquidationOrdersTool())
112 
113        # Register Hyperliquid tools
114        api.register_tool(HyperliquidWhaleAlertsTool())
115        api.register_tool(HyperliquidWhalePositionsTool())
116        api.register_tool(HyperliquidPositionsByCoinTool())
117        api.register_tool(HyperliquidPositionDistributionTool())
118 
119        # Register new V4 futures market tools
120        api.register_tool(SupportedCoinsTool())
121        api.register_tool(SupportedExchangesTool())
122        api.register_tool(CoinsMarketDataTool())
123        api.register_tool(PairMarketDataTool())
124        api.register_tool(OHLCHistoryTool())
125 
126        # Register Volume & Flow tools
127        api.register_tool(TakerVolumeHistoryTool())
128        api.register_tool(AggregatedTakerVolumeTool())
129        api.register_tool(CumulativeVolumeDeltaTool())
130        api.register_tool(CoinNetflowTool())
131 
132        # Register Whale Transfer tool
133        api.register_tool(WhaleTransferTool())
134 
135        # Register Bitcoin ETF tools
136        api.register_tool(BTCETFFlowsTool())
137        api.register_tool(BTCETFPremiumDiscountTool())
138        api.register_tool(BTCETFHistoryTool())
139        api.register_tool(BTCETFListTool())
140        api.register_tool(HKBTCETFFlowsTool())
141 
142        # Register Ethereum & Other ETF tools
143        api.register_tool(ETHETFFlowsTool())
144        api.register_tool(ETHETFListTool())
145        api.register_tool(SOLETFFlowsTool())
146        api.register_tool(XRPETFFlowsTool())
147 
148        registered.extend([
149            "funding_rate",
150            "long_short_ratio",
151            "cg_global_account_ratio",
152            "cg_top_account_ratio",
153            "cg_top_position_ratio",
154            "cg_taker_exchanges",
155            "cg_net_position",
156            "cg_open_interest",
157            "cg_liquidations",
158            "cg_liquidation_analysis",
159            "cg_coin_liquidation_history",
160            "cg_pair_liquidation_history",
161            "cg_liquidation_coin_list",
162            "cg_liquidation_orders",
163            "cg_hyperliquid_whale_alerts",
164            "cg_hyperliquid_whale_positions",
165            "cg_hyperliquid_positions_by_coin",
166            "cg_hyperliquid_position_distribution",
167            "cg_supported_coins",
168            "cg_supported_exchanges",
169            "cg_coins_market_data",
170            "cg_pair_market_data",
171            "cg_ohlc_history",
172            "cg_taker_volume_history",
173            "cg_aggregated_taker_volume",
174            "cg_cumulative_volume_delta",
175            "cg_coin_netflow",
176            "cg_whale_transfers",
177            "cg_btc_etf_flows",
178            "cg_btc_etf_premium_discount",
179            "cg_btc_etf_history",
180            "cg_btc_etf_list",
181            "cg_hk_btc_etf_flows",
182            "cg_eth_etf_flows",
183            "cg_eth_etf_list",
184            "cg_sol_etf_flows",
185            "cg_xrp_etf_flows",
186        ])
187        logger.info("Registered Coinglass tools (37 tools)")
188    except Exception as e:
189        logger.warning(f"Failed to load Coinglass tools: {e}")
190 
191    return registered
192 
193 
194# Extension metadata
195EXTENSION_INFO = {
196    "name": "coinglass",
197    "version": "3.0.5",
198    "description": "Coinglass crypto derivatives data tools - V4 API with advanced long/short ratios, liquidations, Hyperliquid whale tracking, volume & flow analysis, on-chain whale transfers, comprehensive ETF data (Bitcoin, Ethereum, Solana, XRP, Hong Kong), and futures market data (37 tools)",
199    "tools": [
200        "funding_rate",
201        "long_short_ratio",
202        "cg_global_account_ratio",
203        "cg_top_account_ratio",
204        "cg_top_position_ratio",
205        "cg_taker_exchanges",
206        "cg_net_position",
207        "cg_open_interest",
208        "cg_liquidations",
209        "cg_liquidation_analysis",
210        "cg_coin_liquidation_history",
211        "cg_pair_liquidation_history",
212        "cg_liquidation_coin_list",
213        "cg_liquidation_orders",
214        "cg_hyperliquid_whale_alerts",
215        "cg_hyperliquid_whale_positions",
216        "cg_hyperliquid_positions_by_coin",
217        "cg_hyperliquid_position_distribution",
218        "cg_supported_coins",
219        "cg_supported_exchanges",
220        "cg_coins_market_data",
221        "cg_pair_market_data",
222        "cg_ohlc_history",
223        "cg_taker_volume_history",
224        "cg_aggregated_taker_volume",
225        "cg_cumulative_volume_delta",
226        "cg_coin_netflow",
227        "cg_whale_transfers",
228        "cg_btc_etf_flows",
229        "cg_btc_etf_premium_discount",
230        "cg_btc_etf_history",
231        "cg_btc_etf_list",
232        "cg_hk_btc_etf_flows",
233        "cg_eth_etf_flows",
234        "cg_eth_etf_list",
235        "cg_sol_etf_flows",
236        "cg_xrp_etf_flows",
237    ],
238    "env_vars": [
239        "COINGLASS_API_KEY",
240    ],
241}
242