1"""
2CoinGecko skill exports — script-mode skill.
3 
4Usage from a bash block:
5    python3 - <<'EOF'
6    import sys
7    sys.path.insert(0, "/data/workspace/skills/coingecko")
8    from exports import coin_price, cg_trending
9    print(coin_price(coin_ids="bitcoin,ethereum"))
10    EOF
11"""
12import os, sys
13 
14# tools/ contains all sub-modules; make them importable regardless of cwd.
15_TOOLS_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "tools")
16if _TOOLS_DIR not in sys.path:
17    sys.path.insert(0, _TOOLS_DIR)
18 
19from coin_prices import get_coin_prices_at_timestamps
20from coin_ohlc_range_by_id import get_coin_ohlc_range_by_id
21from coin_historical_chart_range_by_id import get_coin_historical_chart_range_by_id
22from coins import (get_coins_list, get_coins_markets, get_coin_data, get_coin_tickers)
23from market_discovery import get_trending, get_top_gainers_losers, get_new_coins
24from global_data import get_global, get_global_defi
25from search import search as _search
26from derivatives import get_derivatives, get_derivatives_exchanges, get_categories
27from exchanges import (get_exchanges, get_exchange, get_exchange_tickers,
28                       get_exchange_volume_chart)
29from infrastructure import (get_asset_platforms, get_exchange_rates,
30                             get_vs_currencies, get_categories_list)
31from nfts import get_nfts_list, get_nft, get_nft_by_contract
32from contracts import get_token_price, get_coin_by_contract
33 
34 
35# ── Price tools ──
36 
37def coin_price(coin_ids, timestamps=None, vs_currency="usd"):
38    """Get coin prices. coin_ids: comma-separated IDs or symbols (bitcoin,BTC,ETH)."""
39    return get_coin_prices_at_timestamps(
40        coin_ids=coin_ids,
41        timestamps=timestamps or ["now"],
42        vs_currency=vs_currency
43    )
44 
45def coin_ohlc(coin_id, days=30, vs_currency="usd"):
46    """Get OHLC candlestick data for the last N days.
47 
48    Wraps get_coin_ohlc_range_by_id which expects unix timestamps.
49    """
50    import time as _time
51    to_ts = int(_time.time())
52    from_ts = to_ts - int(days) * 86400
53    return get_coin_ohlc_range_by_id(
54        coin_id, from_timestamp=from_ts, to_timestamp=to_ts
55    )
56 
57 
58def coin_chart(coin_id, days=30, vs_currency="usd"):
59    """Get historical price chart for the last N days (timestamp + price points).
60 
61    Wraps get_coin_historical_chart_range_by_id which expects unix timestamps.
62    """
63    import time as _time
64    to_ts = int(_time.time())
65    from_ts = to_ts - int(days) * 86400
66    return get_coin_historical_chart_range_by_id(
67        coin_id,
68        vs_currency=vs_currency,
69        from_timestamp=from_ts,
70        to_timestamp=to_ts,
71    )
72 
73 
74# ── Discovery tools ──
75 
76def cg_trending():
77    """Get trending coins, NFTs, categories."""
78    return get_trending()
79 
80def cg_top_gainers_losers(vs_currency="usd", duration="24h"):
81    """Get top gainers and losers."""
82    return get_top_gainers_losers(vs_currency, duration)
83 
84def cg_new_coins():
85    """Get recently added coins."""
86    return get_new_coins()
87 
88def cg_search(query):
89    """Search for coins, exchanges, categories by name."""
90    return _search(query)
91 
92 
93# ── Global data ──
94 
95def cg_global():
96    """Get global crypto market stats."""
97    return get_global()
98 
99def cg_global_defi():
100    """Get global DeFi market stats."""
101    return get_global_defi()
102 
103 
104# ── Coins ──
105 
106def cg_coins_list(include_platform=False):
107    """Get list of all coins (id, symbol, name)."""
108    return get_coins_list(include_platform)
109 
110def cg_coins_markets(vs_currency="usd", order="market_cap_desc", per_page=100,
111                     page=1, sparkline=False, price_change_percentage="24h",
112                     category=None, ids=None):
113    """Get coin market data (price, mcap, volume, change%)."""
114    return get_coins_markets(vs_currency, order, per_page, page, sparkline,
115                             price_change_percentage, category, ids)
116 
117def cg_coin_data(coin_id, localization=False, tickers=False, market_data=True,
118                 community_data=False, developer_data=False, sparkline=False):
119    """Get detailed data for a specific coin."""
120    return get_coin_data(coin_id, localization, tickers, market_data,
121                         community_data, developer_data, sparkline)
122 
123def cg_coin_tickers(coin_id, exchange_ids=None, include_exchange_logo=False,
124                    page=1, order="volume_desc", depth=False):
125    """Get coin trading tickers across exchanges."""
126    return get_coin_tickers(coin_id, exchange_ids, include_exchange_logo,
127                            page, order, depth)
128 
129 
130# ── Categories ──
131 
132def cg_categories(order="market_cap_desc"):
133    """Get coin categories with market data."""
134    return get_categories(order)
135 
136def cg_categories_list():
137    """Get list of all categories (id + name only)."""
138    return get_categories_list()
139 
140 
141# ── Derivatives ──
142 
143def cg_derivatives(include_tickers="unexpired"):
144    """Get derivatives tickers (futures/perpetuals)."""
145    return get_derivatives(include_tickers)
146 
147def cg_derivatives_exchanges(order="open_interest_btc_desc", per_page=50):
148    """Get derivatives exchanges ranked by open interest."""
149    return get_derivatives_exchanges(order, per_page)
150 
151 
152# ── Exchanges ──
153 
154def cg_exchanges(per_page=100, page=1):
155    """Get list of exchanges with volume data."""
156    return get_exchanges(per_page, page)
157 
158def cg_exchange(exchange_id):
159    """Get specific exchange data."""
160    return get_exchange(exchange_id)
161 
162def cg_exchange_tickers(exchange_id, coin_ids=None, include_exchange_logo=False,
163                        page=1, order="volume_desc", depth=False):
164    """Get tickers for a specific exchange."""
165    return get_exchange_tickers(exchange_id, coin_ids, include_exchange_logo,
166                                page, order, depth)
167 
168def cg_exchange_volume_chart(exchange_id, days=30):
169    """Get exchange volume chart data."""
170    return get_exchange_volume_chart(exchange_id, days)
171 
172 
173# ── NFTs ──
174 
175def cg_nfts_list(order="market_cap_usd_desc", per_page=100, page=1):
176    """Get NFT collections list."""
177    return get_nfts_list(order, per_page, page)
178 
179def cg_nft(nft_id):
180    """Get specific NFT collection data."""
181    return get_nft(nft_id)
182 
183def cg_nft_by_contract(asset_platform, contract_address):
184    """Get NFT data by contract address."""
185    return get_nft_by_contract(asset_platform, contract_address)
186 
187 
188# ── Infrastructure ──
189 
190def cg_asset_platforms(filter=None):
191    """Get list of asset platforms (blockchains)."""
192    return get_asset_platforms(filter)
193 
194def cg_exchange_rates():
195    """Get BTC exchange rates to other currencies."""
196    return get_exchange_rates()
197 
198def cg_vs_currencies():
199    """Get list of supported vs currencies."""
200    return get_vs_currencies()
201 
202 
203# ── Contract/Token tools ──
204 
205def cg_token_price(platform, contract_addresses, vs_currencies="usd",
206                   include_market_cap=False, include_24hr_vol=False,
207                   include_24hr_change=False, include_last_updated_at=False):
208    """Get token price by contract address."""
209    return get_token_price(platform, contract_addresses, vs_currencies,
210                           include_market_cap, include_24hr_vol,
211                           include_24hr_change, include_last_updated_at)
212 
213def cg_coin_by_contract(platform, contract_address):
214    """Get coin data by contract address."""
215    return get_coin_by_contract(platform, contract_address)
216