coingecko

CoinGecko スキル

使用するタイミング

ユーザーのリクエストが次のいずれかに該当する場合に、このスキルを起動します。

暗号資産市場データに関する問い合わせ

• コイン／トークンの価格、時価総額、取引量、価格変動
• 過去の価格データ、OHLC チャート、期間指定の問い合わせ
• 流通供給量または総供給量のデータ
• 暗号資産市場全体の統計（時価総額、BTC ドミナンス、DeFi TVL）
• トレンドのコイン、値上がり率／値下がり率の上位、上場したばかりのコイン

トークンとコントラクトの検索

• コントラクトアドレス（例：0x...）によるトークンの検索
• トークンのメタデータ、カテゴリ、プラットフォーム情報
• 複数のコインまたはトークンの比較

取引所と取引データ

• 取引所の上場情報、取引量、ティッカー、信頼度スコア
• DEX 固有のデータ（Uniswap、PancakeSwap など）
• デリバティブ取引所とティッカー（先物、無期限先物）

オンチェーン／DeFi データ（GeckoTerminal）

• 流動性プールのデータ、トレンド／新規プール、プール検索
• オンチェーンのトークン価格、保有者データ、上位トレーダー
• 特定のプールまたはトークンの OHLCV ローソク足や取引履歴
• DEX とネットワークの検索（対応チェーン、DEX）
• オンチェーンプールのカテゴリとフィルタリング

NFT データ

• NFT コレクションの価格、フロア価格、市場データ
• NFT コレクションのチャートとティッカー

その他のトリガー

• 暗号資産データを使ったダッシュボード、可視化、アプリの構築
• CoinGecko または GeckoTerminal API の機能、エンドポイント、レート制限に関する質問
• API キーの設定、認証、プランの種類、料金に関する質問
• 「どのような暗号資産データが利用できますか？」などの探索的な質問
• ユーザーが CoinGecko、GeckoTerminal に言及する、または CoinGecko の URL を共有する
• 暗号資産を含む投資計算ツール、ポートフォリオトラッカー、ROI 計算
• 上場企業／機関の暗号資産の財務保有（例：「MicroStrategy は BTC をどれくらい保有していますか？」）

---

CoinGecko API（集約データ）と GeckoTerminal API（オンチェーン DEX データ）を利用できます。これらを合わせることで、暗号資産市場データのほぼすべてのニーズに対応できます。 両 API は同じ API キーとプランを共有します。GeckoTerminal のエンドポイントでは、CoinGecko と同じベース URL に /onchain パスプレフィックスを付けます（詳細は references/core.md を参照してください）。

厳守事項 — 市場データはすべてライブ API 呼び出しから取得すること

暗号資産の価格、時価総額、取引量、供給量、TVL、為替レート、または時間とともに変化する市場データに関する質問に、学習時の知識を使って回答してはいけません。 これらの数値は刻々と変化します。学習データは数か月、または数年前のもので、誤った情報になります。

API 呼び出しが失敗した場合、またはまだ試していない場合は、必ず次の手順に従ってください。

1. 停止します。 データに関する質問に回答してはいけません。
2. ユーザーに伝えます。 データを取得できなかった（または、まだ取得していない）ことを伝えます。
3. 失敗の原因を診断します。 許可リストへの登録漏れ、キーの誤りなどを確認し、修正方法を案内します。

「私の知識に基づくと」「おおよそ」などと言ったり、記憶に基づく価格や市場数値を提示したりしてはいけません。市場データの情報源として認められるのは、成功したライブ API のレスポンスのみです。

悪い例：「ドメインがブロックされています……ただし、信頼できるデータがあります。今日の Bitcoin：およそ 87,000 ドル」 （実際の価格はおよそ 69,000 ドルでした。Claude は自信たっぷりに誤った回答を捏造しました）

良い例：「ドメインがブロックされているため、API 呼び出しに失敗しました。ライブデータを取得できるよう、許可リストに追加する方法をご案内します。」

ワークフロー

次の手順を順番どおり厳守してください。先に進んではいけません。ブロックしている問題が完全に解決するまでは、コードを書いたり、アーキテクチャを計画したり、API を呼び出したりしてはいけません。

ステップ 0a — Claude 環境の確認（必須 — Claude のみ）

Claude（claude.ai）内で実行している場合は、最初に references/claude-env.md を読んでください。 CoinGecko API 呼び出しをすべて失敗させる、2 つのプラットフォーム上の制約について記載されています。

1. ドメインの許可リスト — ユーザーは claude.ai/settings/capabilities で api.coingecko.com と pro-api.coingecko.com を追加する必要があります。 ユーザーが初めて利用する場合、またはいずれかの呼び出しがネットワークエラーで失敗した場合は、他の問題のデバッグに進む前にいったん止め、 設定方法を案内してください。
2. Artifact のサンドボックス — Artifact 内の fetch() は常に、エラーを表示せず失敗します。 すべての CoinGecko API 呼び出しでは、curl を使う bash_tool をデフォルトで使用し、その後、結果を静的データとして Artifact や可視化に埋め込んでください。これは代替手段ではなく、標準的な方法です。

Claude 内で実行していない場合は、このステップをスキップしてください。

ステップ 0b — 認証情報の確認（必須）

停止してください。他の作業に進む前に、ユーザーの API プランを確認する必要があります。これは厳格な前提条件です。提案ではなく、後で確認すればよいものでも、「このリクエストならキーなしで動くはず」という理由で省略してよいものでもありません。

この確認が必要な理由： キーなしプランと Demo プランには制限があり、複数ステップのタスクが予告なく失敗することがあります。失敗例：

ユーザー：「5 年前に Bitcoin に投資していたら、今日いくらの価値になっていましたか？」 よくない対応：Claude がキーなしで動くと思い込んでダッシュボードの作成を始め、キーなし／Demo では 365 日を超える過去データを取得できないため、エラー 10012 が発生する。 ユーザーは、そもそも実現できない作業に時間とレート制限のある API 呼び出しを費やすことになります。

正しい対応は、最初に認証情報を尋ね、「5 年前」はキーなし／Demo の制限を超えていると確認し、コードを 1 行も書く前にユーザーへ伝えることです。

手順：

1. メモリを確認し、以前保存されたプランと API キーがないか調べます。
2. 見つかった場合は、現在も有効か確認します。見つからない場合は、ユーザーに尋ねます：
   • プラン — 有料（Pro）ですか、無料（Demo）ですか？
   • API キー — CG-… で始まるキーをお持ちですか？
3. キーがありませんか？ ユーザーがキーを持っていないと明確に伝えた場合に限り、キーなしでの利用に切り替えます。 ユーザーがキーについて触れていないだけなら、必ず尋ねてください。沈黙を「キーなし」と見なしてはいけません。 キーなしで進める場合は、呼び出しは毎分 5 回までで、不安定であり、データにも制限があると警告してください。無料の Demo キー（https://www.coingecko.com/en/api/pricing）の取得を提案してください。
4. 確認済みのプランに照らして実行可能か評価します。 リクエストに、プランの制限を超えるデータやエンドポイントが含まれていないか確認します。たとえば、365 日を超える過去データ（キーなし／Demo）、Enterprise 限定の間隔（5m）、有料プラン限定のエンドポイントなどです。含まれる場合は、呼び出しを試す前にユーザーへ伝えてください。呼び出しを行って失敗させてはいけません。
5. 認証設定の全容について references/core.md を読み、確認済みのプランをメモリに保存します。

このステップが完全に解決するまで、ステップ 1 に進んではいけません。

ステップ 1 — 分野を特定する

以下のリファレンス一覧を使って、読み込むファイルを決定します。

ステップ 2 — リファレンスを読み込み、リクエストを作成する

該当するリファレンスファイルを読み込み、API 呼び出しを作成します。

ステップ 3 — 実行してエラーに対処する

認証エラーとレート制限エラーのコードは references/core.md に記載されています。API がエラー 10005 を返した場合、そのエンドポイントには上位プランが必要です。ユーザーに伝え、https://www.coingecko.com/en/api/pricing を案内してください。エラー 10010 または 10011 が発生した場合は、キーの種類に対して誤ったベース URL を使用しています。core.md のエラー表に従って URL を切り替え、自動的に再試行してください。

「Failed to fetch」またはネットワークエラーの場合： HTTP ステータスが返らずにリクエストが失敗した場合（例：「Failed to fetch」、「TypeError」）、Claude 内で実行している場合は references/claude-env.md の診断手順に従ってください。通常は Artifact の CSP サンドボックスが原因です（bash_tool に切り替えてください）。または、ドメインの許可リストへの登録が不足している可能性があります。Claude の外で発生した場合は、ベース URL の誤りが考えられます。core.md の「ネットワークレベルの失敗」セクションを参照してください。いずれの場合も、CORS が原因だと決めつけてはいけません。

リファレンスインデックス

ユーザーの質問に応じて、該当するリファレンスファイルを読み込んでください。現在のリクエストに合致するファイルだけを読み込めば十分です。

アイデアとユースケース

ユーザーが何を作れるか尋ねている場合、プロジェクトのアイデアを求めている場合、または「どのようなデータを利用できますか？」のような探索的な質問をしている場合は、以下のドメイン別ファイルではなく、references/common-use-cases.md を読み込んでから、その案内に従って詳しく調べてください。

環境

ファイル	読み込むタイミング
references/claude-env.md	ステップ 0a で必ず読む — Claude 固有の制約（ドメインの許可リスト、Artifact の CSP サンドボックス、bash_tool の方針、MCP のアップグレード経路）。Claude 内で実行する場合にのみ適用されます。

CoinGecko（集約データ）

ファイル	読み込むタイミング
references/core.md	必ず読む — 認証、方法論、レート制限
references/coins.md	コイン価格、市場データ、メタデータ、ティッカー、値上がり銘柄／値下がり銘柄
references/coin-history.md	コイン ID による過去のチャート、OHLC、期間指定の問い合わせ
references/coin-supply.md	流通供給量／総供給量のチャート
references/contract.md	トークンのコントラクトアドレスから取得するコインデータやチャート
references/asset-platforms.md	ブロックチェーンのプラットフォーム ID、トークン一覧
references/categories.md	コインのカテゴリおよびセクターの市場データ
references/exchanges.md	現物取引所と DEX のデータ、ティッカー、出来高チャート
references/derivatives.md	デリバティブ取引所とティッカー
references/treasury.md	公開企業／機関の暗号資産保有状況
references/nfts.md	NFT コレクションデータ、市場データ、チャート、ティッカー
references/global.md	世界の市場統計と DeFi データ
references/utils.md	API ステータス、API キーの使用方法、対応通貨、検索、トレンドのコイン／NFT／カテゴリ、為替レート

GeckoTerminal（オンチェーン）

ファイル	読み込むタイミング
references/onchain-networks.md	対応ネットワークと DEX（ID の解決）
references/onchain-pools.md	プールの検索、トレンド／新規プール、メガフィルター
references/onchain-tokens.md	トークンデータ、コントラクトアドレスによる価格、保有者とトレーダー
references/onchain-ohlcv-trades.md	プール／トークンの OHLCV ローソク足と取引履歴
references/onchain-categories.md	オンチェーンプールのカテゴリ（GeckoTerminal 固有）

一般的なガイダンス

• リクエストが複数のドメインにまたがる場合（例：コイン価格と取引所データ）は、複数のリファレンスファイルを読み込んでください。
• 読み込むファイルがわからない場合は、回答する前に上のインデックスを確認してください。
• CoinGecko と GeckoTerminal のどちらを優先するかについては、references/core.md の「方法論」セクションを参照してください。