外部 agent skill

CMC_PRO_API_KEY

CoinMarketCap Pro API key。

• 作用: cmc-api-crypto / cmc-api-dex / cmc-api-exchange / cmc-api-market 外部 skill。
• 消費方: src/skills/external/ 下的四個 cmc-* SKILL.md 腳本。
• 何時設置: 你想用 CoinMarketCap 的行情、市值和上市數據來替代（或補充）CoinGecko 時。
• 未設置時: cmc-* skill 拒絕激活。
• 格式: 來自 https://pro.coinmarketcap.com 的 CMC Pro key。以請求頭 X-CMC_PRO_API_KEY 發送。
• 設置歸屬: 非用戶設置項

CMC_API_KEY

原生優先鏈 provider 使用的 CoinMarketCap key（區別於門控 legacy 內置外部 skill 的 CMC_PRO_API_KEY）。

• 作用: 在價格 / trending 優先鏈中激活 cmc provider（PROVIDER_CATALOG.cmc，優先級 30）。
• 消費方: src/tools/providers/cmc.ts，經由 src/tools/_shared/market-data-priority-chain.ts。
• 何時設置: 你想把 CMC 作為付費檔回退，排在 Minara、binance-public、hyperliquid、okx-public 和 coingecko 各檔之後時。對存在於 CMC 但不在免費 provider 上的代幣有用。
• 未設置時: cmc provider 從價格/trending 鏈中略去。免費 provider 無論如何都覆蓋了絕大多數標的。
• 格式: 來自 https://pro.coinmarketcap.com 的 CMC Pro key。以 X-CMC_PRO_API_KEY 請求頭髮送。key 形態與 CMC_PRO_API_KEY 相同（存在這兩個變量，是為了讓運維能把 legacy 外部路徑與原生優先鏈分開限定作用域）。
• 設置歸屬: 設置 → API 密鑰

COINGECKO_API_KEY

CoinGecko Pro API key。

• 作用: coingecko_* typed passthrough 工具（按 REST 族各一個：simple、coins、platforms、exchanges、derivatives、treasury、nfts、search、global、news、onchain），覆蓋 CoinGecko Pro 約 85 個只讀 GET 端點。也驅動原生價格 / K 線 / on-chain 優先鏈（coingecko-pro）以及 Data Studio 的 CoinGecko 代理源。
• 消費方: src/generated/coingecko/client.ts（REST）、src/tools/providers/coingecko-public.ts（優先鏈）、src/data-studio/sources.ts（Data Studio），以及 vendored 的 src/skills/external/coingecko/ skill。
• 何時設置: 希望本地走 Pro（更高速率、僅 Pro 端點）而不經過 Minara 時。有本地 key 則直連 pro-api.coingecko.com；沒有時，在已登錄 Minara 的情況下，強類型工具經由 Minara 後端（平臺 Pro key）轉發。
• 未設置時: coingecko_* 工具仍會註冊。有 Minara 登錄時經由後端轉發；既無 key 也無登錄時，調用會返回一個點名此變量的錯誤。免費檔價格 / K 線 / on-chain provider（coingecko-free）仍留在優先鏈。Data Studio 仍走公開 Demo 主機。
• 格式: 來自 https://www.coingecko.com/en/api/pricing 的 CoinGecko Pro API key。以請求頭 x-cg-pro-api-key 發送。強類型透傳不使用 Demo key（x-cg-demo-api-key）。
• 設置歸屬: 設置 → API 密鑰

COINGLASS_API_KEY

CoinGlass v4 加密衍生品 + 市場數據。

• 作用: 為 coinglass skill 提供動力，它是 CoinGlass v4 REST API 的 typed passthrough（約 160 個只讀端點，覆蓋期貨、現貨、期權、ETF 資金流、on-chain 指數、交易所餘額和清算熱力圖）。該 skill 為每個族暴露一個分類工具（coinglass_futures、coinglass_spot、coinglass_etf、coinglass_option、coinglass_index……）；模型每次調用挑選一個 endpoint id。也為 btc_cycle 的 btc_rainbow_band 工具（彩虹圖）供數。
• 消費方: src/generated/coinglass/client.ts（REST）以及 src/tools/btc-cycle-rainbow.ts。
• 何時設置: 你想要一流的 CoinGlass 衍生品 / 市場數據，包括僅 Pro/Enterprise 的端點（清算熱力圖、部分指數）時。本地 key 直接調用 CoinGlass；沒有時，skill 對後端 allow-list 的子集經由 Minara 後端（平臺 key）轉發。
• 未設置時: 存在 Minara 登錄時，coinglass 工具仍會註冊並經由 Minara 後端轉發；後端未 allow-list 的端點會返回一個點名此變量的錯誤。
• 格式: 來自 https://coinglass.com 的 key，以請求頭 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（PROVIDER_CATALOG.binance-web3-dex，優先級 72），在 Ethereum / BSC / Base / Solana 上是 dex_token_meta / _holders / _pools 的首選 on-chain 數據源，當查詢停留在這四條鏈上（或 OKX quad 未設置）時也用於 wallet_aggregate_balance / _history。在這些鏈上排名高於 coingecko on-chain 各檔和 okx-dex。與零配置的 binance-web3 audit/meme 端點不同，後者從不需要 key。還為 Data Studio 的 binance-web3 代理源（用於生成儀表盤的只讀 on-chain 市場數據）提供動力。
• 消費方: src/tools/providers/binance-web3-dex.ts，經由 src/tools/_shared/onchain-token-priority-chain.ts；binance-web3 外部 skill；以及 Data Studio 數據代理（src/gateway/api.ts，經由 src/data-studio/sources.ts + src/data-studio/request-signer.ts）。
• 何時設置: 你想要 Binance Web3 的 DEX 原生代幣數據（一次調用拿到價格 / 市值 / 成交量 / 持有人，持有人 + 流動性排名）以及四條上線鏈上的錢包聚合時。
• 未設置時: 略去 binance-web3-dex provider；on-chain meta / pools 下沉到 coingecko on-chain，持有人到 coingecko-pro，錢包聚合到 okx-dex；binance-web3 外部 skill 保持隱藏；Data Studio 源返回憑據提示。
• 格式: 來自在 https://web3.binance.com/en/dev-portal/project 創建的項目的 API Key + Secret Key 對。二者必須一起設置 —— 任一缺失，registry 就隱藏 binance-web3-dex。請求經 HMAC-SHA256 簽名（X-OC-* 請求頭）。
• 設置歸屬: 設置 → API 密鑰

OKX_API_KEY / OKX_SECRET_KEY / OKX_PASSPHRASE / OKX_PROJECT_ID

OKX 四變量組 — OKX_API_KEY / OKX_SECRET_KEY / OKX_PASSPHRASE / OKX_PROJECT_ID。

• 作用: 原生 okx-dex provider（PROVIDER_CATALOG.okx-dex，優先級 40），它為 discovery.dex skill（dex_token_meta / _holders / _pools 回退）、wallet_aggregate_balance / _history（唯一覆蓋 Binance Web3 四鏈之外鏈的 provider）、binance-web3 未覆蓋鏈上的 meme.* 工具（BSC + Solana 之外的一切）以及非 Binance-Web3 鏈上的 security.token skill（Ethereum / BSC / Base / Solana 之外的一切）提供動力。
• 消費方: src/tools/providers/okx-dex.ts。
• 何時設置: 你想要僅 OKX 的能力（Arbitrum / Polygon / Tron 等上的錢包聚合，Arbitrum / Polygon 等上的安全審計，非 Binance-Web3 鏈上的 meme 發現），或在四條 Binance Web3 鏈上作為 binance-web3-dex 之後的回退時。
• 未設置時: okx-dex provider 保持未激活；on-chain meta / pools 下沉到 binance-web3-dex（配置時）和 coingecko on-chain；設置了該密鑰對時錢包聚合在 Binance Web3 鏈上盡力運行，否則它、非 GeckoTerminal 鏈審計以及 binance-web3 支持鏈之外的 meme 發現都以 provider_unavailable 呈現，並帶缺失 env 的提示。
• 格式: 標準 OKX HMAC 四元組。四個必須一起設置 —— 任一缺失，registry 就隱藏 okx-dex。交易 API 在 https://www.okx.com/docs-v5/en/#authentication 簽發；Web3 產品線共享同一鑑權，並額外增加一個你創建 Web3 app 時設置的 project id。
• 設置歸屬: 設置 → API 密鑰

Polymarket 憑據——只讀的 prediction.markets skill 無需 env。 該原生 skill 使用 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_* 經 認證的 builder 端點下單。該寫入路徑尚未 移植到原生面。若你需要下單，目前請把 自己的 key 保管在此 agent 之外。