TokenMix Crypto Intelligence Agent

TokenMix Crypto Intelligence Agent

TokenMix로 구동되는 개인화 암호화폐 시장 인텔리전스 및 의사결정 지원 리포트 도구입니다.

TokenMix Crypto Intelligence Agent는 암호화폐 리서치를 위한 오픈소스 도구입니다. 공개 시장 데이터, 거래소 데이터, DeFi 데이터, 뉴스, 개발자 신호를 읽고, 사용자의 위험 성향, 관심 목록, 투자 기간과 결합해 근거 기반 리포트를 생성합니다.

이 가이드는 TokenMix API Key를 설정해 Agent가 TokenMix를 통해 모델을 호출하도록 만드는 방법을 설명합니다.

중요: 이 도구는 리서치와 의사결정 지원용입니다. 거래 봇이 아니며, 매매를 실행하지 않고, 금융 조언으로 취급해서는 안 됩니다.

준비할 것

필요한 것:

  1. TokenMix 계정.
  2. TokenMix API Key.
  3. Node.js 또는 Docker를 실행할 수 있는 컴퓨터/서버.
  4. 분석할 자산. 예: BTC, ETH, SOL.

API Key가 없다면 TokenMix에 로그인해 대시보드의 API Key 페이지에서 새 Key를 만드세요. Key는 전체를 복사해야 하며 보통 sk-tm-로 시작합니다.

Step 1: 프로젝트 다운로드

터미널에서 실행합니다:

git clone https://github.com/TokenMixAi/tokenmix-crypto-intelligence-agent
cd tokenmix-crypto-intelligence-agent
npm install
cp .env.example .env

.env 파일이 만들어집니다. 여기에 TokenMix API Key를 넣습니다.

Step 2: TokenMix 설정 입력

.env를 열고 다음 항목을 찾습니다:

TOKENMIX_API_KEY=
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=claude-opus-4.7
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

다음처럼 바꿉니다:

TOKENMIX_API_KEY=sk-tm-your-tokenmix-key
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=<model-short-id>
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

주의할 점:

  1. TOKENMIX_BASE_URL은 https://api.tokenmix.ai/v1로 유지하세요.
  2. API Key 앞뒤에 공백이 없어야 합니다.
  3. TOKENMIX_MODEL은 TokenMix가 지원하는 모델 ID여야 합니다.
  4. 복잡한 리포트에는 더 강한 모델을 권장합니다.

Step 3: 프로필 설정

Agent는 사용자의 역할과 위험 성향에 맞춰 리포트를 조정합니다. 단기 트레이더와 장기 리서처가 봐야 할 내용은 다릅니다.

예시:

npm run dev -- profile --role crypto_researcher --risk balanced --horizon weekly --interests "AI agents,Solana,DeFi" --style standard

빠르게 테스트만 하려면 이 단계는 건너뛰고 기본 프로필을 사용해도 됩니다.

Step 4: 자산 분석

먼저 BTC를 분석합니다:

npm run dev -- analyze BTC

SOL도 분석할 수 있습니다:

npm run dev -- analyze SOL

성공하면 시장 상황, 근거, 데이터 품질, 위험 점수, 개인 프로필에 맞춘 관찰 포인트, 확인 및 무효화 신호가 포함된 Markdown 리포트가 출력됩니다.

Action Bias는 매수/매도 지시가 아닙니다. 관찰, 확인 대기, 기회 관찰, 주의, 리스크 오프 같은 리서치 관점의 경향입니다.

Step 5: 관심 목록 설정

npm run dev -- watchlist BTC ETH SOL TAO VIRTUAL

일일 브리프 생성:

npm run dev -- daily

Step 6: Web UI 사용

API 서버와 Web UI를 시작합니다:

npm run dev:api

열기:

http://localhost:3000

운영 환경에서 처음 실행할 때 APP_AUTH_PASSWORD가 비어 있으면 브라우저가 배포 비밀번호 생성을 요청합니다. 앱은 data/auth.json에 비밀번호 해시만 저장합니다.

선택 사항: Docker로 실행

cp .env.example .env

.env를 채운 뒤 실행합니다:

docker compose up --build

열기:

http://localhost:3000

자주 생기는 문제

TokenMix API Key가 없음

.env에 다음 값이 있는지 확인하세요:

TOKENMIX_API_KEY=sk-tm-your-tokenmix-key

REQUIRE_TOKENMIX_KEY=true이면 AI 리포트에 TokenMix Key가 필요합니다.

모델을 사용할 수 없음

TOKENMIX_MODEL이 현재 TokenMix에서 지원하는 모델 ID인지 확인하세요.

리포트 생성이 느림

Agent는 여러 공개 데이터 소스를 가져오고 모델로 긴 리포트를 생성합니다. 테스트는 BTC로 시작하는 것이 좋습니다.

리포트가 투자 조언처럼 보임

리서치 자료로만 사용하세요. Agent는 매수, 매도, 숏, 보장된 상승 같은 지시를 제공하지 않으며 지갑 관리나 자동 거래도 하지 않습니다.

요약

TOKENMIX_API_KEY에 TokenMix sk-tm-... Key를 넣고, TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1을 유지하고, TokenMix 모델을 선택한 뒤 npm run dev -- analyze BTC를 실행하면 TokenMix 모델 기반 암호화폐 인텔리전스 리포트를 생성할 수 있습니다.