Cursor

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

npm install -g @upbit-official/upbit-cli

upbit --version

upbit config set

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

---
alwaysApply: true
---

# Upbit CLI 규칙

사용자가 업비트 시세, 잔고, 주문, 입금, 출금, 지갑 상태, Travel Rule 관련 작업을 요청하면 Upbit CLI Skill을 사용합니다.

업비트 REST API 작업은 `upbit` CLI를 사용합니다.

## 공개 API

다음 공개 API는 인증 없이 사용할 수 있습니다.

- `tickers`
- `orderbooks`
- `trades`
- `candles`
- `trading-pairs`
- `wallet-status`

## 인증 필요 API

다음 API는 인증이 필요합니다.

- `accounts`
- `api-keys`
- `orders`
- `withdraws`
- `deposits`
- `travel-rule`

## 보안 규칙

API Key와 Secret Key는 응답, 코드, 로그에 그대로 출력하거나 저장하지 않습니다.

## 실행 확인 규칙

실제 자산에 영향을 줄 수 있는 쓰기 작업을 실행하기 전에는 전체 명령을 보여주고, 사용자가 `CONFIRM`을 입력하도록 요청합니다.

쓰기 작업 예시:

- 주문 생성
- 주문 취소
- 출금 요청
- 출금 취소
- 원화 입금 요청
- 입금 주소 생성
- Travel Rule 입금 검증

`orders test-create`는 실제 주문을 생성하지 않으므로 `CONFIRM`이 필요하지 않습니다.

## 마켓 형식

업비트 마켓 형식은 `{QUOTE}-{BASE}`입니다.

예시:

- `BTC/KRW` → `KRW-BTC`
- `BTC-KRW` → `KRW-BTC`
- `ETH/KRW` → `KRW-ETH`

## 주문 규칙

시장가 매수는 `ord_type=price`를 사용하고, `price`에는 사용할 총 금액을 입력합니다.

시장가 매도는 `ord_type=market`을 사용하고, `volume`에는 매도할 자산 수량을 입력합니다.

명령 옵션이 불확실하면 아래 도움말을 먼저 확인합니다.

```bash
upbit <resource> <command> --help

KRW-BTC 현재가 조회해줘

upbit tickers list-by-trading-pairs --markets KRW-BTC

내 잔고 확인해줘

upbit accounts list

KRW-BTC 주문 가능 정보 확인해줘

upbit orders retrieve-chance --market KRW-BTC

BTC 1만 원 시장가 매수 테스트 명령 만들어줘

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

USDT 출금 가능한 네트워크 확인해줘

upbit withdraws list-coin-addresses --currency USDT

[실행 전 확인]
작업: KRW-BTC 시장가 매수
금액: 10,000 KRW
실행 명령:
upbit orders create --market KRW-BTC --side bid --ord-type price --price 10000

주의 사항: 실제 주문이 생성됩니다.

실행하려면 CONFIRM을 입력하세요.