---
updatedAt: 2026-09-04T03:08:20.000Z
agentTools:
  projectIndex: https://apidocs.bithumb.com/llms.txt
---

# 개요

빗썸 Open API의 전체 구성과 인증 방식을 안내합니다.

## API 구성

빗썸 API는 **Public API**, **Private API**, **WebSocket** 세 가지로 구분됩니다.

| 구분          | 인증                               | 설명                                            |
| ----------- | -------------------------------- | --------------------------------------------- |
| Public API  | 불필요                              | 시세, 호가, 캔들, 체결 내역 등 시장 데이터를 조회합니다.            |
| Private API | JWT(JSON Web Token) 인증 필요        | 계좌 조회, 주문, 입출금 등 사용자 자산과 관련된 기능을 수행합니다.       |
| WebSocket   | Public: 불필요 / Private: JWT 인증 필요 | 실시간 시세, 호가, 체결, 내 주문, 내 자산 데이터를 스트리밍으로 수신합니다. |

## Base URL

| 구분                | Base URL                                        |
| ----------------- | ----------------------------------------------- |
| REST API          | `https://api.bithumb.com`                       |
| Public WebSocket  | `wss://ws-api.bithumb.com/websocket/v1`         |
| Private WebSocket | `wss://ws-api.bithumb.com/websocket/v2/private` |

REST API의 버전(`/v1` 또는 `/v2`)은 엔드포인트마다 다르며, 각 API 페이지 경로에 표시됩니다. Public WebSocket은 `v1`, Private WebSocket은 `v2` 경로를 사용합니다.

## Public API

인증 없이 호출할 수 있는 시장 데이터 조회 API입니다.

<Cards columns="2">
  <Card title="거래 대상 목록 조회" href="거래-대상-목록-조회" icon="fa-solid fa-list">
    빗썸에서 제공하는 거래 대상 페어(Trading Pairs) 목록을 조회합니다.
  </Card>

  <Card title="캔들 조회" href="분minute-캔들-조회" icon="fa-solid fa-chart-line">
    분/일/주/월 단위 캔들 데이터를 조회합니다.
  </Card>

  <Card title="체결(Trade) 내역 조회" href="체결-내역-조회" icon="fa-solid fa-clock-rotate-left">
    최근 체결된 거래 내역을 조회합니다.
  </Card>

  <Card title="현재가(Ticker) 조회" href="현재가-조회" icon="fa-solid fa-coins">
    요청 시점의 종목 스냅샷(현재가, 거래량 등)을 조회합니다.
  </Card>

  <Card title="호가(Orderbook) 조회" href="호가-조회" icon="fa-solid fa-arrow-down-up-across-line">
    지정한 거래 대상 페어의 호가 정보를 조회합니다.
  </Card>

  <Card title="경보제 조회" href="경보제-조회" icon="fa-solid fa-triangle-exclamation">
    투자 주의가 필요한 거래 대상 페어와 경보 유형 및 단계를 조회합니다.
  </Card>

  <Card title="공지사항 조회" href="공지사항-조회" icon="fa-solid fa-bullhorn">
    빗썸 공지사항을 조회합니다.
  </Card>

  <Card title="입출금 수수료 조회" href="입출금-수수료-조회" icon="fa-solid fa-receipt">
    빗썸에 상장된 가상자산의 입출금 수수료 정보를 조회합니다.
  </Card>
</Cards>

## Private API

Private API를 호출하려면 JWT 인증이 필요합니다. API KEY와 SECRET KEY로 JWT 토큰을 생성하고, `Authorization` 헤더에 토큰을 포함하여 요청하세요.

<Callout icon="fa-circle-info" theme="info">
  API 레퍼런스의 코드 샘플에서는 편의상 `'발급받은 API KEY'`를 직접 입력하는 형태로 제공됩니다. 실제 프로젝트에서는 `.env` 파일 등을 활용하여 키를 안전하게 관리하세요. 자세한 방법은 [개발 환경 설정하기](doc:개발-환경-설정하기)를 참고하세요.
</Callout>

### 계좌

<Cards columns="2">
  <Card title="전체 자산 조회" href="전체-자산-조회" icon="fa-solid fa-wallet">
    보유 중인 자산 정보를 조회합니다.
  </Card>
</Cards>

### 주문

<Cards columns="2">
  <Card title="주문 가능 정보" href="주문-가능-정보" icon="fa-solid fa-circle-info">
    거래 대상 페어별 주문 가능 정보(수수료, 제약사항 등)를 조회합니다.
  </Card>

  <Card title="개별 주문 조회" href="개별-주문-조회" icon="fa-solid fa-magnifying-glass">
    개별 주문 내역을 조회합니다.
  </Card>

  <Card title="주문 리스트 조회" href="주문-리스트-조회" icon="fa-solid fa-rectangle-list">
    주문 목록을 조회합니다.
  </Card>

  <Card title="다건 주문 조회" href="다건-주문-조회" icon="fa-solid fa-list-check">
    주문 ID 목록으로 주문을 조회합니다. (v2, 최대 100건)
  </Card>

  <Card title="대기 주문 목록 조회" href="대기-주문-목록-조회" icon="fa-solid fa-hourglass-half">
    체결 대기(wait) 또는 주문 대기(watch) 상태의 주문 목록을 조회합니다. (v2)
  </Card>

  <Card title="종료 주문 목록 조회" href="종료-주문-목록-조회" icon="fa-solid fa-flag-checkered">
    처리 완료(done) 또는 취소(cancel)된 주문 목록을 조회합니다. (v2, 최대 7일)
  </Card>

  <Card title="주문 요청" href="주문-요청" icon="fa-solid fa-paper-plane">
    지정가/시장가 주문을 요청합니다. (v2)
  </Card>

  <Card title="다건 주문 요청" href="다건-주문-요청" icon="fa-solid fa-layer-group">
    여러 건의 주문을 한 번에 요청합니다. (v2, 최대 30건)
  </Card>

  <Card title="주문 취소 접수" href="주문-취소-접수" icon="fa-solid fa-ban">
    주문 취소를 요청합니다. (v2)
  </Card>

  <Card title="다건 주문 취소 접수" href="다건-주문-취소-접수" icon="fa-solid fa-xmark">
    여러 건의 주문을 일괄 취소 요청합니다. (v2, 최대 30건)
  </Card>
</Cards>

### TWAP(Time-Weighted Average Price) 주문

<Cards columns="2">
  <Card title="TWAP - 주문 요청" href="twap-주문-요청" icon="fa-solid fa-timeline">
    TWAP 주문을 요청합니다.
  </Card>

  <Card title="TWAP - 주문 내역 조회" href="twap-주문내역-조회" icon="fa-solid fa-clock">
    TWAP 주문 목록을 조회합니다.
  </Card>

  <Card title="TWAP - 주문 취소" href="twap-주문-취소" icon="fa-solid fa-circle-xmark">
    TWAP 주문 취소를 요청합니다.
  </Card>
</Cards>

### 출금

<Cards columns="2">
  <Card title="출금 가능 정보" href="출금-가능-정보" icon="fa-solid fa-circle-info">
    해당 통화의 출금 가능 정보를 조회합니다.
  </Card>

  <Card title="개별 출금 조회" href="개별-출금-조회" icon="fa-solid fa-magnifying-glass">
    개별 출금 내역을 조회합니다.
  </Card>

  <Card title="코인 출금 리스트 조회" href="출금-리스트-조회" icon="fa-solid fa-list">
    가상자산 출금 목록을 조회합니다.
  </Card>

  <Card title="원화 출금 리스트 조회" href="원화-출금-리스트-조회" icon="fa-solid fa-won-sign">
    원화 출금 목록을 조회합니다.
  </Card>

  <Card title="가상 자산 출금 요청" href="가상-자산-출금-요청" icon="fa-solid fa-arrow-right-from-bracket">
    가상 자산 출금을 요청합니다.
  </Card>

  <Card title="가상 자산 출금 취소" href="가상-자산-출금-취소" icon="fa-solid fa-rotate-left">
    가상 자산 출금을 취소합니다.
  </Card>

  <Card title="원화 출금 요청" href="원화-출금-요청" icon="fa-solid fa-money-bill-transfer">
    등록된 출금 계좌로 원화 출금을 요청합니다.
  </Card>

  <Card title="출금 허용 주소 리스트 조회" href="출금-허용-주소-리스트-조회" icon="fa-solid fa-address-book">
    등록된 출금 허용 주소 리스트를 조회합니다.
  </Card>
</Cards>

### 입금

<Cards columns="2">
  <Card title="개별 입금 조회" href="개별-입금-조회" icon="fa-solid fa-magnifying-glass">
    개별 입금 내역을 조회합니다.
  </Card>

  <Card title="코인 입금 리스트 조회" href="입금-리스트-조회" icon="fa-solid fa-list">
    가상자산 입금 목록을 조회합니다.
  </Card>

  <Card title="원화 입금 리스트 조회" href="원화-입금-리스트-조회" icon="fa-solid fa-won-sign">
    원화 입금 목록을 조회합니다.
  </Card>

  <Card title="원화 입금" href="원화-입금" icon="fa-solid fa-arrow-right-to-bracket">
    원화 입금을 요청합니다.
  </Card>

  <Card title="입금 주소 생성 요청" href="입금-주소-생성-요청" icon="fa-solid fa-plus">
    입금 주소 생성을 요청합니다.
  </Card>

  <Card title="전체 입금 주소 조회" href="전체-입금-주소-조회" icon="fa-solid fa-address-book">
    전체 입금 주소를 조회합니다.
  </Card>

  <Card title="개별 입금 주소 조회" href="개별-입금-주소-조회" icon="fa-solid fa-location-dot">
    가상자산별 입금 주소를 조회합니다.
  </Card>
</Cards>

### 기타

<Cards columns="2">
  <Card title="입출금 현황" href="입출금-현황" icon="fa-solid fa-tower-broadcast">
    입출금 현황과 블록 상태를 조회합니다.
  </Card>

  <Card title="API 키 리스트 조회" href="api-키-리스트-조회" icon="fa-solid fa-key">
    API 키 리스트와 만료 일자를 조회합니다.
  </Card>
</Cards>

## WebSocket

WebSocket을 사용하면 실시간 데이터를 스트리밍으로 수신할 수 있습니다. REST API는 클라이언트가 반복 요청(폴링)해야 하지만, WebSocket은 한 번 연결하면 서버가 데이터를 지속적으로 푸시합니다. 빈번한 시세 업데이트가 필요한 경우 WebSocket을 사용하세요.

* **접속 제한**: IP당 초당 최대 10회 연결 요청

### Public WebSocket

인증 없이 시장 데이터를 실시간으로 수신합니다.

**엔드포인트**: `wss://ws-api.bithumb.com/websocket/v1`

| 타입                 | 설명                             |
| ------------------ | ------------------------------ |
| **현재가 (Ticker)**   | 종목의 현재가, 변동률, 거래량 등 실시간 시세 스냅샷 |
| **체결 (Trade)**     | 실시간 체결 내역 (체결가, 체결량, 매수/매도 구분) |
| **호가 (Orderbook)** | 실시간 매수/매도 호가 및 잔량              |

<Cards columns="3">
  <Card title="현재가 (Ticker)" href="현재가-ticker" icon="fa-solid fa-coins">
    종목의 현재가, 변동률, 거래량 등 실시간 시세 스냅샷을 수신합니다.
  </Card>

  <Card title="체결 (Trade)" href="체결-trade" icon="fa-solid fa-clock-rotate-left">
    실시간 체결 내역(체결가, 체결량, 매수/매도 구분)을 수신합니다.
  </Card>

  <Card title="호가 (Orderbook)" href="호가-orderbook" icon="fa-solid fa-arrow-down-up-across-line">
    실시간 매수/매도 호가와 잔량을 수신합니다.
  </Card>
</Cards>

### Private WebSocket

JWT 인증을 통해 사용자 개인 데이터를 실시간으로 수신합니다.

**엔드포인트**: `wss://ws-api.bithumb.com/websocket/v2/private`

| 타입                      | 설명                          |
| ----------------------- | --------------------------- |
| **내 주문 및 체결 (MyOrder)** | 내 주문 상태 변경, 체결 내역을 실시간으로 수신 |
| **내 자산 (MyAsset)**      | 보유 자산 잔액 변동을 실시간으로 수신       |

<Cards columns="2">
  <Card title="내 주문 및 체결 (MyOrder)" href="내-주문-및-체결-myorder" icon="fa-solid fa-receipt">
    내 주문의 접수, 체결, 완료, 취소 이벤트를 실시간으로 수신합니다. (Private v2)
  </Card>

  <Card title="내 자산 (MyAsset)" href="내-자산-myasset" icon="fa-solid fa-wallet">
    보유 자산의 변동을 실시간으로 수신합니다. (Private v2)
  </Card>
</Cards>

<Callout icon="fa-thumbtack" theme="warning">
  `MyOrder` v1 스펙은 v2와 동시 운영 후 종료될 예정입니다. 신규 개발 시 v2를 사용하고, 기존 v1 사용자는 [Private v2 마이그레이션 가이드](doc:private-v2-마이그레이션-가이드)를 참고하여 전환하세요. v1 응답 스펙은 [내 주문 및 체결(MyOrder) v1](doc:내-주문-및-체결myorder-v1) 페이지에서 확인할 수 있습니다.
</Callout>

### WebSocket 상세 문서

<Cards columns="2">
  <Card title="기본 정보" href="기본-정보" icon="fa-solid fa-circle-info">
    WebSocket 엔드포인트, 접속 제한 등 기본 정보를 확인합니다.
  </Card>

  <Card title="요청 방법 및 포맷" href="요청-포맷" icon="fa-solid fa-code">
    WebSocket 요청 메시지 구조와 포맷을 확인합니다.
  </Card>

  <Card title="테스트 및 요청 예제" href="테스트-및-요청-예제" icon="fa-solid fa-flask">
    WebSocket 연결 테스트 방법과 요청 예제를 확인합니다.
  </Card>

  <Card title="웹소켓 에러" href="웹소켓-에러" icon="fa-solid fa-circle-exclamation">
    WebSocket 에러 코드와 처리 방법을 확인합니다.
  </Card>

  <Card title="연결 관리" href="연결-관리" icon="fa-solid fa-plug">
    Ping/Pong, 연결 유지, 재접속 전략을 확인합니다.
  </Card>
</Cards>