腳本使用方式

此為腳本模式技能 — 請閱讀本檔案，然後從 bash 區塊中呼叫：

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/coingecko")
from exports import coin_price, cg_trending, cg_global

print(coin_price(coin_ids="bitcoin,ethereum"))
print(cg_trending())
EOF

請閱讀 exports.py 以取得完整的可用函式列表。常用函式：
coin_price, coin_ohlc, coin_chart, cg_trending,
cg_top_gainers_losers, cg_new_coins, cg_global, cg_global_defi,
cg_categories, cg_derivatives, cg_coins_markets, cg_coin_data,
cg_coin_tickers, cg_search, cg_token_price, cg_coin_by_contract。

CoinGecko 技能

函式參考（簽章）

所有公開函式都在 exports.py 中。coin_id 是 CoinGecko 的 ID
（例如 bitcoin, ethereum）— 如果不確定，請先使用 cg_search(query)。
vs_currency 預設為 usd。

價格與圖表

函式	說明
`coin_price(coin_ids, timestamps=None, vs_currency='usd')`	當前或歷史價格。`coin_ids` 為逗號分隔字串，如 `"bitcoin,ethereum"`。`timestamps` 為歷史時間戳列表（預設為現在）。
`coin_ohlc(coin_id, days=30, vs_currency='usd')`	最近 N 天的 OHLC 柱狀圖。回傳 `[ts, o, h, l, c]` 列表。粒度自動選擇：1d=30min, 7-30d=4h, 30d+=4h。
`coin_chart(coin_id, days=30, vs_currency='usd')`	價格 + 市值 + 總交易量的時間序列。回傳 `{prices, market_caps, total_volumes}`（每個都是 `[ts, val]` 列表）。

探索

函式	說明
`cg_trending()`	熱門幣種、NFT、板塊（最近 24 小時）。
`cg_top_gainers_losers(vs_currency='usd', duration='24h')`	漲跌幅排行。`duration` 可為 `1h`/`24h`/`7d`/`14d`/`30d`/`60d`/`1y`。
`cg_new_coins()`	近期上架的幣種。
`cg_search(query)`	依名稱搜尋幣種/交易所/板塊。

市場資料

函式	說明
`cg_global()`	全球加密貨幣市場：總市值、交易量、市佔率。
`cg_global_defi()`	全球 DeFi：TVL、市佔率、頂級協議。
`cg_coins_markets(vs_currency='usd', order='market_cap_desc', per_page=100, page=1, sparkline=False, price_change_percentage='24h', category=None, ids=None)`	頂級幣種的完整市場資料。
`cg_coin_data(coin_id, localization=False, tickers=False, market_data=True, community_data=False, developer_data=False, sparkline=False)`	單一幣種的詳細資料。
`cg_coin_tickers(coin_id, exchange_ids=None, include_exchange_logo=False, page=1, order='volume_desc', depth=False)`	幣種的交易場所與交易量。
`cg_coins_list(include_platform=False)`	所有幣種 ID/代號（用於解析）。

板塊 / 衍生品 / NFT

函式	說明
`cg_categories(order='market_cap_desc')`	頂級板塊及其市值與交易量。
`cg_categories_list()`	僅板塊 ID/名稱。
`cg_derivatives(include_tickers='unexpired')`	各交易所的衍生品報價。
`cg_derivatives_exchanges(order='open_interest_btc_desc', per_page=50)`	衍生品交易所排名。
`cg_nfts_list(order='market_cap_usd_desc', per_page=100, page=1)`	頂級 NFT 收藏。
`cg_nft(nft_id)`	NFT 收藏詳細資料。
`cg_nft_by_contract(asset_platform, contract_address)`	依合約地址查詢 NFT。

交易所

函式	說明
`cg_exchanges(per_page=100, page=1)`	交易所排名。
`cg_exchange(exchange_id)`	單一交易所詳細資料。
`cg_exchange_tickers(exchange_id, ...)`	交易所上的交易對。
`cg_exchange_volume_chart(exchange_id, days=30)`	交易所交易量歷史。

合約 / 代幣（依平台）

函式	說明
`cg_token_price(platform, contract_addresses, vs_currencies='usd', include_market_cap=False, include_24hr_vol=False, include_24hr_change=False, include_last_updated_at=False)`	依合約地址查詢平台上的代幣價格。
`cg_coin_by_contract(platform, contract_address)`	依合約地址查詢幣種元資料。
`cg_asset_platforms(filter=None)`	支援的區塊鏈。
`cg_vs_currencies()`	支援的報價貨幣。
`cg_exchange_rates()`	以 BTC 計價的法幣/主流幣匯率。

🚫 重要：停止 — 在呼叫任何工具前請先閱讀

最常見的錯誤是呼叫 Coinglass 工具而非 CoinGecko 工具。 它們名稱相似但系統完全不同。

錯誤 → 正確工具對照表

❌ 絕對不要呼叫	✅ 請改呼叫	如何區分
`cg_coins_market_data`	`cg_coins_markets`	market_data=Coinglass 衍生品。markets=CoinGecko 現貨。
`cg_ohlc_history`	`coin_ohlc`	ohlc_history=Coinglass 期貨 K 線。coin_ohlc=CoinGecko 現貨 K 線。
`cg_pair_market_data`	`cg_coin_tickers`	pair_market_data=Coinglass 期貨交易對。coin_tickers=CoinGecko 現貨交易對。
`cg_supported_exchanges`	`cg_exchanges`	supported_exchanges=Coinglass 期貨。exchanges=CoinGecko 現貨。
`cg_taker_exchanges`	`cg_exchange`	taker=Coinglass 交易量。exchange=CoinGecko 交易所資訊。
`cg_aggregated_taker_volume`	`cg_coin_tickers`	taker_volume=Coinglass。coin_tickers=CoinGecko 各交易所交易量。
`defillama_chains`	`cg_global_defi`	如需 CoinGecko 的 DeFi 統計，請使用 cg_global_defi()。

同樣禁止：

❌ web_search / web_fetch — 所有資料均可透過上述原生 CoinGecko 工具取得。絕對不要使用 web_search 查詢加密貨幣市場資料。
❌ 使用 bash 處理資料 — CoinGecko 工具回傳的資料已整理好，無需 bash。
❌ 絕對不要使用訓練資料回答 — 所有價格、排名、OHLC 都已過時。請呼叫工具。

⚠️ 強制工具呼叫 — 回答以下問題前必須呼叫工具

問題類型	你必須呼叫	原因
K 線 / OHLC / 蠟燭圖 / 開高低收	`coin_ohlc(coin_id, days)`	價格資料是即時的；訓練資料已過時
走勢圖 / 價格圖表 / 價格趨勢	`coin_chart(coin_id, days)`	同上
當前價格 / 現在價格	`coin_price(coin_ids)`	訓練資料沒有即時價格

在未呼叫工具前，不得回傳任何數值市場資料（價格、OHLC 數值、百分比）。

⚡ 問題 → 工具對應（比對第一個關鍵字，立即呼叫）

問題關鍵字	要呼叫的工具	範例
價格 / price / 多少錢（單一幣種）	`coin_price(coin_id)`	`coin_price(coin_ids="bitcoin")`
K 線 / OHLC / 蠟燭圖 / 蠟燭圖	`coin_ohlc(coin_id, days)`	`coin_ohlc(coin_id="ethereum", days=7)`
走勢 / trend / 價格圖表 / 價格歷史	`coin_chart(coin_id, days)`	`coin_chart(coin_id="solana", days=30)`
熱門 / trending / 趨勢幣	`cg_trending()`	`cg_trending()`
漲幅最大 / 跌幅最大 / gainers / losers	`cg_top_gainers_losers()`	`cg_top_gainers_losers()`
新幣 / 新上線 / new coins / recently added	`cg_new_coins()`	`cg_new_coins()`
總市值 / BTC 市佔率 / global / 晨報 / 市場概況	`cg_global()`	`cg_global()`
DeFi 總市值 / DeFi TVL / DeFi 市佔率	`cg_global_defi()`	`cg_global_defi()`
板塊 / sector / category / L1 / L2 / Meme / AI 幣	`cg_categories()`	`cg_categories()`
板塊內個幣 / Meme 前 10 / AI 幣排名 / DeFi 幣排名	`cg_coins_markets(category=X)`	`cg_coins_markets(category="meme-token", per_page=10)`
市值排名 / top 10 / ranking / 前 10 幣	`cg_coins_markets(per_page=N)`	`cg_coins_markets(per_page=10)`
ATH / 歷史最高 / 社群 / dev / 研究 / fundamentals	`cg_coin_data(coin_id)`	`cg_coin_data(coin_id="solana", community_data=True)`
對比兩個幣 / compare / XX vs YY	`cg_coin_data()` × 2	每個幣各呼叫一次
NFT 排名 / NFT 市場 / 地板價 / top NFTs	`cg_nfts_list()`	`cg_nfts_list()`
某個 NFT (BAYC/Punks/Azuki)	`cg_nft(nft_id)`	`cg_nft(nft_id="bored-ape-yacht-club")`
交易所詳情 / Binance 詳情 / exchange data	`cg_exchange(exchange_id)`	`cg_exchange(exchange_id="binance")`
交易所列表 / exchange ranking	`cg_exchanges()`	`cg_exchanges()`
交易對 / trading pairs / 流動性分佈	`cg_coin_tickers(coin_id)`	`cg_coin_tickers(coin_id="bitcoin")`
交易所交易量趨勢 / volume chart	`cg_exchange_volume_chart(exchange_id)`	`cg_exchange_volume_chart(exchange_id="binance", days=30)`
合約地址價格 / token price on-chain	`cg_token_price(platform, contract)`	`cg_token_price(platform="ethereum", contract_addresses="0xa0b...")`
搜尋幣 / 找幣 / coin lookup / search	`cg_search(query)`	`cg_search(query="pepe")`
永續合約交易所 / derivatives exchange / OI 排名	`cg_derivatives_exchanges()`	`cg_derivatives_exchanges()`
合約 ticker / perpetual / funding / basis	`cg_derivatives()`	`cg_derivatives()`
交易所對比 + 永續交易所	`cg_exchanges()` + `cg_derivatives_exchanges()`	兩個都呼叫

🌳 決策樹

幾個幣種？
├─ 一個幣
│   ├─ 只要價格？→ coin_price()
│   ├─ ATH/社群/dev/深入？→ cg_coin_data()
│   ├─ OHLC K 線？→ coin_ohlc()
│   ├─ 價格趨勢？→ coin_chart()
│   └─ 不知道 ID？→ 先 cg_search()
├─ 多個幣 / 排名
│   ├─ 板塊總和（板塊總市值）？→ cg_categories()
│   ├─ 板塊內個別（Meme 前 10）？→ cg_coins_markets(category=X)
│   └─ 一般排名？→ cg_coins_markets(per_page=N)
├─ NFT → cg_nfts_list() 或 cg_nft(nft_id)
├─ 交易所 → cg_exchange(id) 或 cg_exchanges()
├─ 全球 → cg_global() 或 cg_global_defi()
└─ 依合約查代幣 → cg_token_price()

常用板塊 ID

meme-token, artificial-intelligence, layer-1, layer-2, decentralized-finance-defi, gaming, real-world-assets-rwa

輸出格式

價格：一律使用 $ 符號 → $66,697
百分比：一律使用 % → +4.2%
NFT 地板價以 ETH 顯示時，同時顯示美元 → 5.17 ETH ($10,534)

重要注意事項

CoinGecko 使用 slug ID："bitcoin", "ethereum", "solana"。代號（BTC, ETH, SOL）會自動解析。
如果不確定幣種 ID → 先使用 cg_search(query="coin name")。
大多數問題只需 1-2 次工具呼叫。不要連續呼叫 3 次以上。

常見問題

coin_price 因無效 ID 失敗

解決方法： 先使用 cg_search(query="coin name") 找到正確的 CoinGecko ID，或直接使用代號（例如 'COMP'）。

coingecko

相關技能