外部エージェントスキル

CMC_PRO_API_KEY

CoinMarketCap Pro API キー。

• 制御対象: cmc-api-crypto / cmc-api-dex / cmc-api-exchange / cmc-api-market の外部スキル。
• 使用箇所: src/skills/external/ 配下の 4 つの cmc-* SKILL.md スクリプト。
• 設定するタイミング: CoinGecko の代わりに（または加えて）CoinMarketCap のティッカー、時価総額、上場データが欲しい場合。
• 未設定時: cmc-* スキルはアクティベーションを拒否します。
• 形式: https://pro.coinmarketcap.com から取得する CMC Pro キー。ヘッダー X-CMC_PRO_API_KEY として送信されます。
• 設定の所在: ユーザー向け設定ではありません

CMC_API_KEY

ネイティブの priority-chain プロバイダー向けの CoinMarketCap キー（legacy のベンダー提供外部スキルをゲートする CMC_PRO_API_KEY とは別物）。

• 制御対象: price / trending の priority chain で cmc プロバイダーをアクティブにします（PROVIDER_CATALOG.cmc、priority 30）。
• 使用箇所: src/tools/providers/cmc.ts（src/tools/_shared/market-data-priority-chain.ts 経由）。
• 設定するタイミング: Minara、binance-public、hyperliquid、okx-public、および coingecko の各ティアの後段の有料ティアフォールバックとして CMC が欲しい場合。CMC には存在するが無料プロバイダーには存在しないトークンに便利です。
• 未設定時: cmc プロバイダーは price/trending チェーンから除外されます。いずれにせよ無料プロバイダーが大半のシンボルをカバーします。
• 形式: https://pro.coinmarketcap.com から取得する CMC Pro キー。X-CMC_PRO_API_KEY ヘッダーで送信されます。CMC_PRO_API_KEY と同じキー形状です（運用者が legacy の外部パスをネイティブの priority chain とは独立してスコープできるよう、2 つの変数が存在します）。
• 設定の所在: 設定 → API キー

COINGECKO_API_KEY

CoinGecko Pro API キー。

• 制御対象: coingecko_* の typed passthrough ツール（REST ファミリーごとに 1 つ: simple、coins、platforms、exchanges、derivatives、treasury、nfts、search、global、news、onchain）で、CoinGecko Pro の約 85 の読み取り専用 GET エンドポイントを扱います。ネイティブの price / kline / on-chain プロバイダーチェーン（coingecko-pro）と Data Studio の CoinGecko プロキシソースも動かします。
• 使用箇所: src/generated/coingecko/client.ts（REST）、src/tools/providers/coingecko-public.ts（priority chain）、src/data-studio/sources.ts（Data Studio）、およびベンダー提供の src/skills/external/coingecko/ スキル。
• 設定するタイミング: Minara を経由せずにローカルで Pro カバレッジ（より高いレート制限、Pro 専用エンドポイント）が欲しい場合です。ローカルキーがあれば pro-api.coingecko.com を直接呼び出します。ない場合、型付きツールは Minara ログインがあるときに Minara バックエンド（プラットフォーム Pro キー）経由で転送します。
• 未設定時: coingecko_* ツールは引き続き登録されます。Minara ログインがあればバックエンド経由で転送し、キーもログインもない呼び出しはこの変数を挙げたエラーを返します。無料ティアの price/kline/on-chain プロバイダー（coingecko-free）は priority chain に残ります。Data Studio は引き続き公開 Demo ホストを使います。
• 形式: https://www.coingecko.com/en/api/pricing から取得する CoinGecko Pro API キー。ヘッダー x-cg-pro-api-key として送信されます。Demo キー（x-cg-demo-api-key）は typed passthrough では使いません。
• 設定の所在: 設定 → API キー

COINGLASS_API_KEY

CoinGlass v4 の暗号デリバティブ + 市場データ。

• 制御対象: CoinGlass v4 REST API 上の typed passthrough である coinglass スキルを動かします（先物、現物、オプション、ETF フロー、オンチェーン指標、取引所残高、清算ヒートマップにわたる約 160 の読み取り専用エンドポイント）。スキルはファミリーごとに 1 つのカテゴリーツールを公開し（coinglass_futures、coinglass_spot、coinglass_etf、coinglass_option、coinglass_index、…）、モデルは呼び出しごとにエンドポイント id を選びます。また btc_cycle の btc_rainbow_band ツール（レインボーチャート）にも供給します。
• 使用箇所: src/generated/coinglass/client.ts（REST）と src/tools/btc-cycle-rainbow.ts。
• 設定するタイミング: Pro/Enterprise 専用エンドポイント（清算ヒートマップ、一部の指標）を含む、第一級の CoinGlass デリバティブ / 市場データが欲しい場合。ローカルキーがあれば CoinGlass を直接呼び出します。ない場合、スキルはバックエンドが許可リストに載せているサブセットについて Minara バックエンド（プラットフォームキー）経由で転送します。
• 未設定時: coinglass ツールは引き続き登録され、Minara ログインがある場合は Minara バックエンド経由で転送します。バックエンドが許可リストに載せていないエンドポイントは、この変数を挙げたエラーを返します。
• 形式: https://coinglass.com から取得するキー。ヘッダー CG-API-KEY として送信されます。
• 設定の所在: 設定 → API キー

BINANCE_WEB3_API_KEY / BINANCE_WEB3_SECRET_KEY

Binance Web3 ペア — BINANCE_WEB3_API_KEY / BINANCE_WEB3_SECRET_KEY。

• 制御対象: ネイティブの binance-web3-dex プロバイダー（PROVIDER_CATALOG.binance-web3-dex、priority 72）。dex_token_meta / _holders / _pools について Ethereum / BSC / Base / Solana で優先されるオンチェーンデータソースであり、さらにクエリがこれら 4 チェーンに収まる場合（または OKX の quad が未設定の場合）は wallet_aggregate_balance / _history も担います。これらのチェーンでは coingecko のオンチェーンティアや okx-dex を上回ります。キーを一切必要としないゼロ構成の binance-web3 audit/meme エンドポイントとは別物です。また Data Studio の binance-web3 プロキシソース（生成ダッシュボード向けの読み取り専用オンチェーン市場データ）も動かします。
• 使用箇所: src/tools/providers/binance-web3-dex.ts（src/tools/_shared/onchain-token-priority-chain.ts 経由）、binance-web3 外部スキル、および Data Studio データプロキシ（src/data-studio/sources.ts + src/data-studio/request-signer.ts を通じた src/gateway/api.ts）。
• 設定するタイミング: Binance Web3 の DEX ネイティブなトークンデータ（1 回の呼び出しで price / mcap / volume / holders、保有者 + 流動性のランキング）と、4 つのローンチチェーンでのウォレット集約が欲しい場合。
• 未設定時: binance-web3-dex プロバイダーは除外されます。オンチェーンの meta / pools は coingecko オンチェーンに、holders は coingecko-pro に、ウォレット集約は okx-dex にフォールバックします。binance-web3 外部スキルは隠されたままとなり、Data Studio ソースは認証情報の入力プロンプトを返します。
• 形式: https://web3.binance.com/en/dev-portal/project で作成したプロジェクトの API Key + Secret Key のペア。両方を一緒に設定する必要があります。いずれかが欠けるとレジストリは binance-web3-dex を隠します。リクエストは HMAC-SHA256 で署名されます（X-OC-* ヘッダー）。
• 設定の所在: 設定 → API キー

OKX_API_KEY / OKX_SECRET_KEY / OKX_PASSPHRASE / OKX_PROJECT_ID

OKX 4 変数 quad — OKX_API_KEY / OKX_SECRET_KEY / OKX_PASSPHRASE / OKX_PROJECT_ID。

• 制御対象: ネイティブの okx-dex プロバイダー（PROVIDER_CATALOG.okx-dex、priority 40）。discovery.dex スキル（dex_token_meta / _holders / _pools のフォールバック）、wallet_aggregate_balance / _history（Binance Web3 の 4 チェーン以外をカバーする唯一のプロバイダー）、binance-web3 がカバーしないチェーン（BSC + Solana 以外すべて）での meme.* ツール、および Binance Web3 以外のチェーン（Ethereum / BSC / Base / Solana 以外すべて）での security.token スキルを動かします。
• 使用箇所: src/tools/providers/okx-dex.ts。
• 設定するタイミング: OKX 専用の機能（Arbitrum / Polygon / Tron などでのウォレット集約、Arbitrum / Polygon などでのセキュリティ監査、Binance Web3 以外のチェーンでの meme ディスカバリー）が欲しい場合、または 4 つの Binance Web3 チェーンで binance-web3-dex の後段のフォールバックが欲しい場合。
• 未設定時: okx-dex プロバイダーは非アクティブのままです。オンチェーンの meta / pools は binance-web3-dex（構成されている場合）と coingecko オンチェーンにフォールバックします。ウォレット集約は、そのペアが設定されている場合は Binance Web3 チェーンでベストエフォートで動作します。そうでない場合は、それと非 GeckoTerminal チェーンの監査、および binance-web3 のサポートチェーン外の meme ディスカバリーは、missing-env のヒント付きで provider_unavailable として表面化します。
• 形式: 標準の OKX HMAC quad。4 つすべてを一緒に設定する必要があります。いずれか 1 つでも欠けるとレジストリは okx-dex を隠します。取引 API については https://www.okx.com/docs-v5/en/#authentication で発行します。Web3 プロダクトラインは同じ認証を共有し、Web3 アプリ作成時に設定する project id を追加します。
• 設定の所在: 設定 → API キー

Polymarket の認証情報 — 読み取り専用の prediction.markets スキルには env は不要です。 ネイティブスキルは Polymarket の公開 Gamma API (https://gamma-api.polymarket.com) と CLOB 読み取りエンドポイント (https://clob.polymarket.com) を使用します。どちらも読み取り専用の表面 (prediction_search_events, prediction_get_event, prediction_market_orderbook, prediction_market_history, prediction_trending_markets) には認証を必要としません。 廃止された external-polymarket SKILL.md (PR-G で削除) は、認証済みの ビルダーエンドポイント経由で注文を出すために PRIVATE_KEY / RPC_URL / POLY_BUILDER_* を使用していました。その書き込み 経路はまだネイティブ表面に移植されていません。注文の発注が必要な場合は、 当面はこのエージェントの外部でご自身のキーを保持してください。