외부 에이전트 스킬

CMC_PRO_API_KEY

CoinMarketCap Pro API 키.

• 제어 대상: cmc-api-crypto / cmc-api-dex / cmc-api-exchange / cmc-api-market 외부 스킬을 게이트합니다.
• 사용처: src/skills/external/ 아래의 네 개 cmc-* SKILL.md 스크립트.
• 설정 시점: CoinGecko 대신(또는 그에 더해) CoinMarketCap 에서 티커, 시가총액, 리스팅 데이터를 원하는 경우입니다.
• 미설정 시: cmc-* 스킬이 활성화를 거부합니다.
• 형식: https://pro.coinmarketcap.com 에서 발급받는 CMC Pro 키. 헤더 X-CMC_PRO_API_KEY 로 전송됩니다.
• 설정 위치: 사용자 대상 설정 아님

CMC_API_KEY

네이티브 우선순위 체인 제공자용 CoinMarketCap 키(레거시 벤더 외부 스킬을 게이트하는 CMC_PRO_API_KEY 와 구별됨).

• 제어 대상: 가격 / 트렌딩 우선순위 체인에서 cmc 제공자를 활성화합니다(PROVIDER_CATALOG.cmc, priority 30).
• 사용처: src/tools/_shared/market-data-priority-chain.ts 를 통해 src/tools/providers/cmc.ts.
• 설정 시점: Minara, binance-public, hyperliquid, okx-public, coingecko 등급 뒤의 유료 등급 폴백으로 CMC 를 원하는 경우입니다. 무료 제공자에는 없지만 CMC 에 존재하는 토큰에 유용합니다.
• 미설정 시: cmc 제공자가 가격/트렌딩 체인에서 생략됩니다. 어차피 무료 제공자가 대부분의 심볼을 커버합니다.
• 형식: https://pro.coinmarketcap.com 에서 발급받는 CMC Pro 키. X-CMC_PRO_API_KEY 헤더로 전송됩니다. CMC_PRO_API_KEY 와 동일한 키 형태입니다(운영자가 네이티브 우선순위 체인과 독립적으로 레거시 외부 경로를 스코프할 수 있도록 두 변수가 존재).
• 설정 위치: 설정 → API 키

COINGECKO_API_KEY

CoinGecko Pro API 키.

• 제어 대상: coingecko_* 타입 패스스루 도구(REST 패밀리당 하나: simple, coins, platforms, exchanges, derivatives, treasury, nfts, search, global, news, onchain)로 CoinGecko Pro 의 약 85 개 읽기 전용 GET 엔드포인트를 다룹니다. 네이티브 가격 / kline / 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), 그리고 벤더 제공 src/skills/external/coingecko/ 스킬.
• 설정 시점: Minara 를 거치지 않고 로컬 Pro 커버리지(더 높은 속도 제한, Pro 전용 엔드포인트)를 원하는 경우입니다. 로컬 키가 있으면 pro-api.coingecko.com 을 직접 호출합니다. 없으면 타입 지정 도구는 Minara 로그인이 있을 때 Minara 백엔드(플랫폼 Pro 키)를 통해 포워딩합니다.
• 미설정 시: coingecko_* 도구는 여전히 등록됩니다. Minara 로그인이 있으면 백엔드를 통해 포워딩하고, 키도 로그인도 없으면 이 변수를 지목하는 오류를 반환합니다. 무료 등급 가격/kline/on-chain 제공자(coingecko-free)는 우선순위 체인에 남습니다. Data Studio 는 계속 공개 Demo 호스트를 사용합니다.
• 형식: https://www.coingecko.com/en/api/pricing 에서 발급받는 CoinGecko Pro API 키. 헤더 x-cg-pro-api-key 로 전송됩니다. Demo 키(x-cg-demo-api-key)는 타입 패스스루에서 사용하지 않습니다.
• 설정 위치: 설정 → API 키

COINGLASS_API_KEY

CoinGlass v4 크립토 파생상품 + 시장 데이터.

• 제어 대상: CoinGlass v4 REST API(선물, 현물, 옵션, ETF 플로우, 온체인 지수, 거래소 잔액, 청산 히트맵에 걸친 약 160 개의 읽기 전용 엔드포인트)에 대한 타입 패스스루인 coinglass 스킬을 구동합니다. 스킬은 패밀리별로 하나의 카테고리 도구(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 pair — BINANCE_WEB3_API_KEY / BINANCE_WEB3_SECRET_KEY.

• 제어 대상: 네이티브 binance-web3-dex 제공자(PROVIDER_CATALOG.binance-web3-dex, priority 72)를 구동하며, Ethereum / BSC / Base / Solana 에서 dex_token_meta / _holders / _pools, 그리고 쿼리가 해당 네 체인에 머무를 때(또는 OKX quad 가 설정되지 않았을 때)의 wallet_aggregate_balance / _history 에 대한 선호되는 온체인 데이터 소스입니다. 해당 체인에서 coingecko 온체인 등급과 okx-dex 를 능가합니다. 키가 전혀 필요 없는 zero-config binance-web3 audit/meme 엔드포인트와는 구별됩니다. 또한 Data Studio binance-web3 프록시 소스(생성된 대시보드용 읽기 전용 온체인 시장 데이터)를 구동합니다.
• 사용처: src/tools/_shared/onchain-token-priority-chain.ts 를 통해 src/tools/providers/binance-web3-dex.ts; binance-web3 외부 스킬; 그리고 Data Studio 데이터 프록시(src/data-studio/sources.ts + src/data-studio/request-signer.ts 를 통해 src/gateway/api.ts).
• 설정 시점: Binance Web3 의 DEX 네이티브 토큰 데이터(한 번의 호출로 가격 / 시총 / 거래량 / 홀더, 홀더 + 유동성 랭킹)와 네 개 런치 체인에서의 지갑 집계를 원하는 경우입니다.
• 미설정 시: 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-var 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 네 체인 밖의 체인을 커버하는 유일한 제공자), 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 디스커버리)을 원하거나, 네 개 Binance Web3 체인에서 binance-web3-dex 뒤의 폴백을 원하는 경우입니다.
• 미설정 시: okx-dex 제공자가 비활성 상태로 유지됩니다; 온체인 meta / pools 는 binance-web3-dex(구성된 경우) 및 coingecko 온체인으로 넘어갑니다; 지갑 집계는 해당 쌍이 설정된 경우 Binance Web3 체인에서 best-effort 로 실행되며, 그렇지 않으면 지갑 집계와 비-GeckoTerminal 체인 감사 및 binance-web3 지원 체인 밖의 meme 디스커버리가 누락된-env 힌트와 함께 provider_unavailable 로 표면화됩니다.
• 형식: 표준 OKX HMAC quad. 넷 모두 함께 설정해야 합니다 — 하나라도 없으면 레지스트리가 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_* 를 사용했습니다. 그 쓰기 경로는 아직 네이티브 표면으로 포팅되지 않았습니다. 주문 실행이 필요하면 지금은 이 에이전트 외부에서 직접 키를 보관하세요.