Upbit Agent Skills

Upbit Agent Skills은 AI 에이전트가 upbit CLI를 통해 업비트 Open API를 더 쉽고 정확하게 사용할 수 있도록 돕는 Skills 패키지입니다.

시세 조회, 잔고 확인, 주문, 입출금, 트래블룰 검증(Travel Rule) 관련 작업을 자연어 요청에 맞게 처리할 수 있습니다.

예시:

“KRW-BTC 현재가 알려줘”
“내 잔고 확인해줘”
“BTC 1만 원 시장가 매수 명령 만들어줘”
“USDT 출금 가능한 네트워크 확인해줘”
“Travel Rule 확인이 필요한 입금 내역 조회해줘”

설치

Node.js 18 이상이 필요합니다.

npx skills add upbit-official/upbit-agent-skills
npm install -g @upbit-official/upbit-cli
upbit --version

전역 설치가 필요한 경우:

npx skills add upbit-official/upbit-agent-skills -g

주요 기능

권장 설정 방식:

upbit config set

또는 환경 변수 사용:

export UPBIT_ACCESS_KEY=<your-access-key>
export UPBIT_SECRET_KEY=<your-secret-key>

API 키와 Secret Key는 응답, 로그, 코드 예제에 노출하지 않아야 합니다.

자주 쓰는 명령

# 현재가 조회
upbit tickers list-by-trading-pairs --markets KRW-BTC

# 마켓 목록 조회
upbit trading-pairs list

# 호가 조회
upbit orderbooks list --markets KRW-BTC

# 잔고 조회
upbit accounts list

# 주문 가능 정보 조회
upbit orders retrieve-chance --market KRW-BTC

# 실제 주문 없이 주문 형식 테스트
upbit orders test-create --market KRW-BTC --side bid --ord-type price --price 10000

업비트 마켓 표기 방식

업비트는 {QUOTE}-{BASE} 형식의 마켓 코드를 사용합니다.

예: BTC-KRW, BTC/KRW → KRW-BTC

주문 기본 개념

시장가 매수는 수량이 아니라 사용할 총 금액을 price에 입력합니다.

upbit orders test-create --market KRW-BTC --side bid --ord-type price --price 10000

시장가 매도는 매도할 수량을 volume에 입력합니다.

upbit orders test-create --market KRW-BTC --side ask --ord-type market --volume 0.001

처음 주문하는 마켓에서는 주문 전 가능 정보를 먼저 확인하는 것이 좋습니다.

upbit orders retrieve-chance --market KRW-BTC

안전한 실행 규칙

다음 작업은 실제 자산에 영향을 줄 수 있으므로 바로 실행하면 안 됩니다.

• 주문 생성
• 주문 취소
• 출금 요청
• 출금 취소
• 원화 입금 요청
• 입금 주소 생성
• Travel Rule 입금 검증
• 자동 매매 예제의 실제 실행

AI 에이전트는 먼저 실행 내용을 요약하고, 사용자가 아래 문구를 단독으로 입력한 경우에만 실행해야 합니다.

CONFIRM

orders test-create와 Dry run은 실제 주문을 생성하지 않으므로 CONFIRM 없이 사용할 수 있습니다.

출금 전 확인 사항

출금은 되돌릴 수 없으므로 실행 전 아래 항목을 확인해야 합니다.

• 자산 코드
• 출금 수량
• 출금 주소
• 네트워크 net_type
• 보조 주소 또는 메모 필요 여부
• 출금 주소 등록 여부

멀티체인 자산은 출금 네트워크를 반드시 확인해야 합니다.

upbit withdraws list-coin-addresses --currency USDT

입출금 상태

TRAVEL_RULE_SUSPECTED 상태의 입금은 travel-rule 명령으로 검증할 수 있습니다.

예제 코드

# 인증 불필요 예제
bash examples/quotation_kr.sh

# 거래대금 상위 페어 조회
bash examples/indicators_kr.sh

# 주문 흐름 Dry run
UPBIT_ACCESS_KEY=<key> UPBIT_SECRET_KEY=<secret> bash examples/orders_kr.sh

# 실제 주문 실행
DRY_RUN=false UPBIT_ACCESS_KEY=<key> UPBIT_SECRET_KEY=<secret> bash examples/orders_kr.sh

실제 실행은 반드시 사용자가 CONFIRM한 뒤에만 진행해야 합니다.

예제 목록

AI 에이전트 원칙

1. 사용자 언어에 맞춰 응답합니다.
2. 공개 조회는 인증 없이 수행합니다.
3. 개인 계정 관련 요청은 인증 설정 여부를 먼저 확인합니다.
4. 실제 자산에 영향을 주는 작업은 실행 전 반드시 요약하고 확인을 받습니다.
5. 실제 거래 전에는 orders test-create 또는 Dry run을 우선 사용합니다.
6. API 키와 Secret Key는 절대 출력하지 않습니다.
7. 사용자의 마켓 표기가 업비트 형식과 다르면 올바른 형식으로 변환합니다.
8. 명령 옵션이 불확실하면 upbit <resource> <command> --help를 먼저 확인합니다.

한국어 응답에서는 주요 API 필드를 자연스러운 용어로 설명합니다.

상세 명령 확인

upbit <resource> <command> --help

예시:

upbit orders create --help

참조 문서

문의 및 주의

버그 제보 및 피드백:

[email protected]

Upbit CLI Skill은 업비트 Open API와 upbit CLI 사용을 보조하는 도구입니다.
이 Skill을 통해 실행되는 모든 주문, 출금, 자동 매매 및 기타 계정 관련 작업의 최종 책임은 사용자에게 있습니다.