개요

전체 구조 한눈에 보기

모든 도구는 Upbit API를 기반으로 합니다. API에 접근하는 방식(코드 / 명령어 / 자연어)에 따라 사용하는 도구가 달라집니다.

                        Upbit API  (시세 · 주문 · 자산)
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
   코드로 연동            명령어로 실행           자연어로 실행
        │                    │              (AI 에이전트)
     Upbit SDK           Upbit CLI ───────────┐  │
   (Python·TS·Go)       (터미널 명령어)        │  │
                                        Upbit Agent Skills
                                        Upbit Strategy Toolkit

• Upbit CLI는 명령어로 직접 실행하는 도구이며, Upbit Agent Skills와 Upbit Strategy Toolkit은 그 위에서 AI 에이전트가 자연어 요청을 실제 작업으로 변환하도록 돕습니다.
• Upbit SDK는 애플리케이션 코드에 직접 연동하는 별도 경로입니다.

구성 요소

시작하기 전에: 공개 vs 인증

Upbit API는 두 종류의 엔드포인트로 나뉩니다. 어떤 작업을 하느냐에 따라 API 키 필요 여부가 달라집니다.

자세한 준비 과정은 Upbit API 이용 준비를 참고합니다.

목적별 시작 가이드

무엇을 하려는지에 따라 아래 문서부터 시작하세요.

실전 매매와 백테스트의 차이

전략을 다루는 두 도구는 목적이 다릅니다. 혼동하지 않도록 구분해 사용하세요.

Upbit Strategy Toolkit은 백테스트 전용 도구입니다. 실시간 주문·계좌 변경·자동 매매는 지원하지 않으며, 백테스트 결과는 과거 데이터 기반 참고 수치로 미래 수익을 보장하지 않습니다. 실시간 주문·계좌 변경·자동 매매가 필요한 경우 별도의 방법(Upbit Skills 등)을 이용하길 권장드립니다.

AI 도구에서 참조하기

Upbit 개발자 문서는 AI 도구가 구조를 파악하고 참조할 수 있도록 llms.txt 형식을 제공합니다.

• 전체 문서 구조: https://docs.upbit.com/llms.txt
• 개별 문서: URL 뒤에 .md를 붙이면 마크다운 형식으로 확인할 수 있습니다.

https://docs.upbit.com/kr/docs/getting-started
→ https://docs.upbit.com/kr/docs/getting-started.md