1#!/usr/bin/env python3
2"""
3Coinglass Whale Transfer Module
4 
5Provides on-chain whale transfer data including:
6- Large transfers (minimum $10M) across major blockchains
7- Bitcoin, Ethereum, Tron, Ripple, Dogecoin, Litecoin, Polygon,
8  Algorand, Bitcoin Cash, Solana
9- Past 6 months of data
10"""
11 
12import sys
13import json
14import argparse
15from typing import Dict, Any, Optional
16 
17from ._api import cg_request
18 
19 
20def get_whale_transfers() -> Optional[Dict[str, Any]]:
21    """
22    Get large on-chain transfers (minimum $10M) across major blockchains.
23 
24    Returns:
25        List of whale transfers with transaction hash, asset, amount,
26        exchange, transfer type (1=inflow, 2=outflow, 3=internal),
27        addresses, and timestamp.
28 
29    Raises:
30        CoinglassError: On API failure with actionable error message.
31    """
32    return cg_request("api/chain/v2/whale-transfer")
33 
34 
35def main():
36    """CLI entry point."""
37    parser = argparse.ArgumentParser(
38        description="Coinglass Whale Transfer Tool"
39    )
40    parser.add_argument("--json", "-j", action="store_true",
41                        help="Output as JSON")
42    parser.parse_args()
43 
44    try:
45        result = get_whale_transfers()
46        print(json.dumps(result, indent=2))
47    except Exception as e:
48        print(f"Error: {e}", file=sys.stderr)
49        sys.exit(1)
50 
51 
52if __name__ == "__main__":
53    main()
54