1#!/usr/bin/env python3
2"""
3Coinglass Bitcoin ETF Module
4 
5Provides Bitcoin ETF data including flows, net assets,
6premium/discount, history, and Hong Kong ETF data.
7"""
8 
9import sys
10import json
11import argparse
12from typing import Dict, Any, Optional, List
13 
14from ._api import cg_request
15 
16 
17def get_btc_etf_flows() -> Optional[List[Dict[str, Any]]]:
18    """Get Bitcoin ETF flow history (inflows/outflows by fund)."""
19    return cg_request("api/etf/bitcoin/flow-history")
20 
21 
22def get_btc_etf_net_assets() -> Optional[List[Dict[str, Any]]]:
23    """Get Bitcoin ETF net assets history."""
24    return cg_request("api/reference/bitcoin-etf-netassets-history")
25 
26 
27def get_btc_etf_premium_discount() -> Optional[List[Dict[str, Any]]]:
28    """Get Bitcoin ETF premium/discount rate history."""
29    return cg_request("api/etf/bitcoin/premium-discount/history")
30 
31 
32def get_btc_etf_history(
33    etf_ticker: Optional[str] = None
34) -> Optional[List[Dict[str, Any]]]:
35    """
36    Get comprehensive Bitcoin ETF history.
37 
38    Args:
39        etf_ticker: Filter by specific ETF ticker (e.g. "GBTC", "IBIT").
40    """
41    params = {}
42    if etf_ticker:
43        params["ticker"] = etf_ticker
44    return cg_request("api/etf/bitcoin/history", params=params or None)
45 
46 
47def get_btc_etf_list() -> Optional[List[Dict[str, Any]]]:
48    """Get list of all Bitcoin ETFs with details."""
49    return cg_request("api/etf/bitcoin/list")
50 
51 
52def get_hk_btc_etf_flows() -> Optional[List[Dict[str, Any]]]:
53    """Get Hong Kong Bitcoin ETF flow history."""
54    return cg_request("api/hk-etf/bitcoin/flow-history")
55 
56 
57def main():
58    """CLI entry point."""
59    parser = argparse.ArgumentParser(description="Coinglass BTC ETF Tools")
60    parser.add_argument("action", choices=[
61        "flows", "assets", "premium", "history", "list", "hk-flows"
62    ])
63    parser.add_argument("--ticker", help="ETF ticker filter")
64    parser.add_argument("--json", "-j", action="store_true")
65    args = parser.parse_args()
66 
67    actions = {
68        "flows": get_btc_etf_flows,
69        "assets": get_btc_etf_net_assets,
70        "premium": get_btc_etf_premium_discount,
71        "history": lambda: get_btc_etf_history(args.ticker),
72        "list": get_btc_etf_list,
73        "hk-flows": get_hk_btc_etf_flows,
74    }
75 
76    try:
77        result = actions[args.action]()
78        print(json.dumps(result, indent=2))
79    except Exception as e:
80        print(f"Error: {e}", file=sys.stderr)
81        sys.exit(1)
82 
83 
84if __name__ == "__main__":
85    main()
86