빠른 시작 가이드

API Key 발급

1. 빗썸 계정을 생성하고 본인 인증을 완료합니다.
2. 빗썸 웹사이트에서 API Key와 Secret Key를 발급받습니다.
   • 로그인 후 마이페이지 > API 관리에서 발급할 수 있습니다.
3. API 활성 항목(자산조회, 주문조회, 주문하기, 출금하기 등)을 필요에 맞게 선택합니다.
4. 접근을 허용할 IP 주소를 등록합니다.
5. 약관에 동의 후, API Key 생성 버튼을 클릭하여 Key 생성을 완료합니다.

🔑

Secret Key는 발급 시 한 번만 표시됩니다. 발급 즉시 안전한 곳에 보관하세요.

API 기본 정보

Step 1: 개발 환경 설정

빗썸 API를 호출하려면 언어별로 필요한 패키지를 설치합니다.

📖

프로젝트 구조와 .env 파일로 API 키를 관리하는 방법은 개발 환경 설정하기에서 다룹니다.

Step 2: Public API 호출하기

Public API는 인증 없이 호출할 수 있습니다. 거래 대상 목록 조회 API로 거래 가능한 거래 대상 페어 목록을 가져오는 것부터 시작합니다.

📖

시세, 캔들, 호가 등 다양한 Public API 활용법은 API 호출해 보기에서 다룹니다.

const options = {method: 'GET', headers: {accept: 'application/json'}};

fetch('https://api.bithumb.com/v1/market/all?isDetails=false', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

응답 예시:

[
  {
    "market": "KRW-BTC",
    "korean_name": "비트코인",
    "english_name": "Bitcoin"
  },
  {
    "market": "KRW-ETH",
    "korean_name": "이더리움",
    "english_name": "Ethereum"
  }
]

💡

거래 대상 페어 심볼(예: KRW-BTC)은 현재가 조회, 호가 정보 조회, 주문하기 등 대부분의 API에서 필수 파라미터로 사용됩니다. 이 API를 가장 먼저 호출하여 유효한 거래 대상 페어 목록을 확인하세요.

Step 3: 인증 토큰 생성하기

Private API(자산 조회, 주문, 출금 등)를 호출하려면 JWT(JSON Web Token) 인증 토큰을 생성하여 Authorization 헤더에 포함해야 합니다. 인증 흐름은 다음과 같습니다.

1. API Key와 Secret Key 준비
2. JWT Payload 구성(access_key, nonce, timestamp)
3. Secret Key로 서명(HS256)
4. Authorization 헤더에 Bearer 토큰 포함
5. API 요청 전송

GET /v1/accounts HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json; charset=utf-8

📖

JWT 구조, query_hash 생성 규칙, 배열 파라미터 해싱은 인증 토큰 생성하기에서 상세히 다룹니다. 실제 Private API 호출 예제는 API 호출해 보기에서 확인하세요.

다음 단계

각 단계를 더 깊이 알아보려면 상세 가이드를 참고하세요.