外部 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 之外。