Upbit API 이용 준비

Upbit API를 사용하기 위해 필요한 사전 준비 절차를 안내합니다.

사용 목적 정의

Upbit API 사용 전, 사용 목적을 먼저 확인하세요.

사용 목적에 따라 API Key 필요 여부와 권한(Scope)이 달라집니다.
필요한 기능에 맞게 최소 권한만 설정하는 것을 권장합니다.
API Key는 Upbit PC Web의 Open API 관리 페이지에서 발급할 수 있습니다.


사용 목적별 권한 안내

사용 목적API Key 필요필요 권한안내
시세 및 마켓 데이터 조회불필요Public API로 조회 가능
과거 마켓 데이터 수집불필요Historical Market Data 문서 참고
자산 조회 및 관리필요자산조회잔고 및 보유 자산 조회
주문필요주문조회, 주문하기주문 API 사용
입금필요입금조회, 입금하기입금 및 조회 가능
출금필요출금조회, 출금하기디지털 자산 출금 시 허용 주소 등록 필요
거래소 / 개인지갑

⚠️

오류 해결

권한 또는 출금허용주소가 사전에 설정되지 않은 경우 API 호출 시 오류가 발생할 수 있습니다.

  • 401 Unauthorized(out_of_scope)
    • API Key에 필요한 권한이 포함되어 있지 않은 경우 발생합니다. 필요한 권한 선택 후 새로 Key를 발급 받길 바랍니다.
  • 400 Bad Request(withdraw_address_not_registered)
    • 출금허용주소가 등록되지 않은 경우 발생합니다. 출금주소를 등록하시길 바랍니다.

다음 단계


※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.