AI 트레이드 킷 시작하기

개요

AI 트레이드 킷은 AI 에이전트와 빗썸 v2.1.5 API를 연결해 자연어로 시세 조회, 계좌 조회, 주문, 입출금을 수행할 수 있는 도구 모음입니다.

구성

AI 트레이드 킷은 CLI, MCP, Skills 세 가지 방식으로 사용할 수 있습니다.

CLI

CLI는 빗썸 API 기능을 터미널 명령어로 제공하는 인터페이스입니다. 터미널에서 bithumb 명령으로 직접 실행할 수도 있고, Claude Code나 Codex 같은 AI 에이전트가 명령어를 호출하도록 사용할 수도 있습니다.

셸 스크립트, cron, CI 같은 자동화 환경에서 사용하기 쉽고, 시세 조회, 주문, 입출금 작업을 스크립트 기반으로 처리할 수 있습니다.

bithumb market ticker KRW-BTC
bithumb account assets
bithumb trade place ...

MCP

Claude Desktop, Cursor 같은 MCP 클라이언트에 빗썸 도구를 연결하는 방식입니다. AI 클라이언트가 자연어 요청을 도구 호출로 바꿔 실행하므로, 시세 조회, 잔고 확인, 주문 같은 작업을 대화하듯이 처리할 수 있습니다.

예:

• "KRW-BTC 현재가 알려줘"
• "내 계좌 잔고 확인해줘"
• "최근 7일간 거래 내역 보여줘"
• "ETH 출금 가능 여부 확인해줘"

Skills

Skills는 여러 단계가 필요한 작업을 정해진 흐름대로 처리하도록 돕는 작업 가이드입니다. Claude Code, Codex 같은 AI 에이전트에 등록하면, 에이전트가 CLI나 MCP를 조합해 필요한 단계를 순서대로 실행합니다.

예를 들어 "BTC 10만원어치 시장가로 사줘"라고 요청하면 다음 흐름을 자동으로 처리하여 요청을 수행합니다:

1. 주문 가능 금액 확인
2. 현재가 확인
3. 사용자 승인 요청
4. 주문 실행
5. 결과 확인

안전하게 사용하기

AI 트레이드 킷은 사용자의 컴퓨터에서 직접 동작하며, API Key는 빗썸 외부로 전송되지 않습니다. MCP·Skills 사용 시 자연어 요청과 빗썸 API 응답 내용은 사용하시는 AI 서비스(Claude, Codex 등)를 거쳐 처리될 수 있으니, 민감한 정보는 신중히 다뤄주세요. 안전한 사용을 위해 다음 사항을 유의하세요.

• API Key와 Secret Key를 AI 채팅창에 입력하거나 다른 사람과 공유하지 마세요.
• API Key는 필요한 권한만 선택해 발급하는 것이 안전합니다. 시세 조회만 사용한다면 조회 권한만, 매매 용도라면 거래 권한만 부여하세요.
• 공용 PC나 보안이 취약한 환경에서는 사용하지 마세요.
• API Key와 Secret Key는 사용자의 로컬 환경에만 보관하는 것을 권장하며, 노출된 것으로 의심되면 즉시 폐기하고 새로 발급하세요.
• MCP 또는 AI 에이전트를 사용할 경우 주문, 출금 등의 작업은 사용자 확인을 거치도록 설정하는 것을 권장합니다.

🔗

AI 트레이드 킷은 빗썸 API 사용을 돕는 보조 도구입니다. 투자 자문이나 투자 권유 목적의 서비스가 아니며, 이를 통해 실행된 거래의 책임은 사용자 본인에게 있습니다.

자주 묻는 질문과 서비스 약관, 유의사항 전문은 빗썸 AI 트레이드 킷 공식 안내 페이지에서 확인할 수 있습니다.

시작하기

AI 트레이드 킷을 사용하려면 Node.js 18 이상이 필요합니다. 시세 조회 기능은 API Key 없이 사용할 수 있지만, 잔고 조회, 주문, 입출금 기능은 API 인증이 필요합니다.

링크

• GitHub: bithumb-official/bithumb-ai-trade-kit