coingecko

スクリプトの使用方法

スクリプトモードのスキル — このファイルを読み、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 = 過去データ用の unix タイムスタンプのリスト (デフォルト: 現在)。
coin_ohlc(coin_id, days=30, vs_currency='usd')	直近 N 日間の OHLC バー。[ts, o, h, l, c] のリストを返します。粒度は自動選択: 1d=30分、7-30d=4時間、30d+=4時間。
coin_chart(coin_id, days=30, vs_currency='usd')	価格 + market_cap + total_volume の時系列。{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()	グローバルな暗号資産市場: 合計 market_cap、出来高、ドミナンス。
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)	1 つのコインの詳細データ。
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')	market_cap と出来高付きの上位カテゴリ。
cg_categories_list()	カテゴリの id/名前のみ。
cg_derivatives(include_tickers='unexpired')	取引所全体のすべてのデリバティブティッカー (約 27k 行)。{tickers, count, filter} を返します。後述の「デリバティブ: フィールドと全市場 OI」を参照してください。
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)	1 つの取引所の詳細。
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 建てレート。

🚫 重要: 停止 — ツールを呼び出す前にこれを読んでください

最多のエラーは、CoinGecko ツールではなく Coinglass ツールを呼び出してしまうことです。 名前は似ていますが、完全に異なるシステムです。

間違い → 正しい ツール置換表

❌ これを呼び出してはいけません	✅ 代わりにこれを呼び出してください	見分け方
cg_coins_market_data	cg_coins_markets	market_data=Coinglass のデリバティブ。markets=CoinGecko のスポット。
cg_ohlc_history	coin_ohlc	ohlc_history=Coinglass の先物ローソク足。coin_ohlc=CoinGecko のスポットローソク足。
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 / ローソク足 / open high low close	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")
ローソク足 / OHLC / candlestick	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)
2つのコインを比較 / compare / XX vs YY	cg_coin_data() × 2	コインごとに1回呼び出します
NFTランキング / NFT市場 / floor price / 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()	両方を呼び出します

デリバティブ: フィールドと全市場合計OI

cg_derivatives() は {"tickers": [...], "count": N, "filter": "unexpired"} を返します。各tickerは以下のとおりです:

フィールド	意味 / 単位
market	取引所。例: "Binance (Futures)"
index_id	基軸コイン。例: "BTC" — コインごとの合計を出すにはこれでグループ化します
contract_type	"perpetual" または "futures" (満期あり)
open_interest	USD 建ての想定元本
volume_24h	USD
funding_rate	資金調達間隔ごとの すでにパーセント値: 0.006162 = 0.0062%。100を掛けないでください
basis, spread	パーセント
price	文字列 — float() でキャストします

全市場合計の未決済建玉 (プラットフォームのプランでCoinGlassの coins-markets が利用できない場合に使用します):

from collections import defaultdict
t = cg_derivatives()["tickers"]
perp = [x for x in t if x["contract_type"] == "perpetual" and x.get("open_interest")]
by_coin = defaultdict(float)
for x in perp:
    by_coin[x["index_id"]] += x["open_interest"]
total = sum(by_coin.values())          # ~$217B as of 2026-09

注意点:

• 現在のスナップショットのみで、履歴はありません。 OIの履歴にはcoinglassスキルを使用してください (コインごとの履歴を合計します)。
• 取引所報告値であり、小規模な取引所も含まれるため、CoinGlassよりもかなり高くなります (同日で約$217B 対 約$117B)。常に情報源として「CoinGecko」を明記し、CoinGlassやその他の第三者機関の数値と同じチャートにプロットしないでください。
• 資金調達率は取引所や証拠金の種類 (USDT vs USDC vs コイン建て) によって異なります。コインごとに1つの数値を報告する場合は、OI加重平均を使用し、その旨を明記してください。

🌳 デシジョンツリー

How many coins?
├─ ONE coin
│   ├─ Just price? → coin_price()
│   ├─ ATH/community/dev/deep? → cg_coin_data()
│   ├─ OHLC candles? → coin_ohlc()
│   ├─ Price trend? → coin_chart()
│   └─ Unknown ID? → cg_search() first
├─ MULTIPLE coins / ranking
│   ├─ Sector aggregate (板块总市值)? → cg_categories()
│   ├─ Sector individual (Meme前10)? → cg_coins_markets(category=X)
│   └─ General ranking? → cg_coins_markets(per_page=N)
├─ NFTs → cg_nfts_list() or cg_nft(nft_id)
├─ Exchange → cg_exchange(id) or cg_exchanges()
├─ Global → cg_global() or cg_global_defi()
└─ Token by contract → cg_token_price()

一般的なカテゴリID

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

出力フォーマット

• 価格: 常に $ 記号を使用 → $66,697
• パーセンテージ: 常に % を使用 → +4.2%
• ETH 建ての NFT フロア価格: USD も表示 → 5.17 ETH ($10,534)

重要な注意事項

• CoinGecko はスラッグ 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」）。

---