가상 자산 투자 이해하기
빗썸 API에서 사용하는 주요 거래, 시세, 입출금 관련 용어를 안내합니다
거래 기본 용어
거래 대상 페어(Trading Pair)
두 개의 화폐를 조합한 거래 단위입니다. KRW-BTC는 원화(KRW)로 비트코인(BTC)을 거래하는 페어를 의미합니다.
- 앞의 화폐: 결제 화폐 (Quote Currency)
- 뒤의 화폐: 거래 대상 화폐 (Base Currency)
API에서는 market 파라미터로 사용됩니다.
거래 대상 목록 조회 API에서 거래 가능한 전체 페어 목록을 확인할 수 있습니다.
매수/매도(Bid / Ask)
- 매수(Bid): 자산을 사는 행위. API에서
side: "bid"로 표현됩니다. - 매도(Ask): 자산을 파는 행위. API에서
side: "ask"로 표현됩니다.
주문 방식(Order Type)
| 주문 방식 | API 값 | 설명 |
|---|---|---|
| 지정가 | limit | 사용자가 원하는 가격을 직접 지정하여 주문 |
| 시장가 매수 | price | 현재 시장 가격으로 즉시 매수. 주문 총액을 지정 |
| 시장가 매도 | market | 현재 시장 가격으로 즉시 매도. 주문 수량을 지정 |
| 최유리 | best | 원화 마켓 전용. 매수는 매도 1호가, 매도는 매수 1호가로 자동 설정되어 즉시 체결 |
주문 처리 조건(Time in Force)
지정가(limit) 또는 최유리(best) 주문에서 체결 방식을 세밀하게 제어하기 위해 사용하는 조건입니다. time_in_force 파라미터로 지정합니다.
| 조건 | API 값 | 설명 |
|---|---|---|
| 즉시 체결/취소 | ioc | 즉시 체결 가능한 수량만 체결하고 잔량은 즉시 취소. 부분 체결 허용 |
| 전량 체결/취소 | fok | 전량 즉시 체결 가능할 때만 체결. 그렇지 않으면 전체 취소(부분 체결 없음) |
| 메이커 전용 | post_only | Maker 주문으로만 호가창에 등록. Taker 가격이면 즉시 취소 (limit 전용) |
limit주문:ioc/fok/post_only중 하나(미설정 가능)best주문:ioc또는fokprice/market주문: 사용하지 않음
주문 요청 페이지에서 조건별 상세 동작과 시나리오를 확인할 수 있습니다.
주문 상태(Order State)
| 상태 | API 값 | 설명 |
|---|---|---|
| 체결 대기 | wait | 주문이 접수되어 체결을 기다리는 상태 |
| 주문 대기 | watch | 자동주문(예: 예약 주문)이 조건 충족을 기다리는 상태 |
| 체결 완료 | done | 주문 수량이 모두 체결된 상태 |
| 주문 취소 | cancel | 사용자 또는 시스템에 의해 주문이 취소된 상태 |
취소 유형(Cancel Type)
주문이 취소되거나(cancel) 특정 조건으로 완료된(done) 경우, cancel_type 필드로 사유를 확인할 수 있습니다.
| 유형 | API 값 | 설명 |
|---|---|---|
| 사용자 취소 | user_cancel | 사용자가 직접 취소 요청한 경우 |
| 관리자 취소 | admin_cancel | 관리자에 의해 취소된 경우 |
| 자전거래 방지 | stp_cancel | 자전거래 방지(STP)에 의해 자동 취소된 경우 |
| 주문 조건 취소 | tif_cancel | ioc / fok / post_only 조건에 의해 자동 취소된 경우 |
체결(Trade Execution)
매수 주문과 매도 주문의 가격이 일치하여 거래가 성사되는 것을 말합니다. 하나의 주문이 여러 건의 체결로 나뉘어 처리될 수 있으며, trades_count 필드로 체결 건수를 확인할 수 있습니다.
자전거래(Cross Trading)와 자전거래 방지(STP)
자신이 등록한 매수 주문과 매도 주문이 서로 체결되는 것을 말합니다. 빗썸은 자전거래 방지(STP, Self-Trade Prevention) 시스템을 운영하여, 주문이 체결되는 단계에서 자신의 기존 주문과 충돌하는 신규 주문 수량을 자동으로 취소합니다.
- 취소된 주문의
cancel_type은stp_cancel로 설정됩니다. - 충돌을 일으킨 상대 주문의 ID는
canceling_order_id필드에 담겨 전달됩니다. - 주문 요청 시
stp_type필드로 자전거래 방지 방식을 지정할 수 있습니다.
기존에는 자전거래 가능성이 있으면 주문 자체가 접수되지 않고
cross_trading에러가 반환되었지만, 2026년 5월 7일 배포 이후에는 주문이 접수된 뒤 체결 단계에서 충돌 수량만 취소되는 방식으로 변경되었습니다. 자세한 내용은 주문 요청 페이지를 참고하세요.
시세 정보
캔들(Candle)
일정 기간 동안의 가격 변동을 요약한 데이터입니다. 빗썸 API에서는 분(1/3/5/10/15/30/60/240분), 일, 주, 월 단위 캔들을 제공합니다.
각 캔들에는 다음 정보가 포함됩니다:
| 필드 | 설명 |
|---|---|
opening_price | 시가 — 해당 기간의 시작 가격 |
high_price | 고가 — 해당 기간의 최고 가격 |
low_price | 저가 — 해당 기간의 최저 가격 |
trade_price | 종가 — 해당 기간의 마지막 거래 가격 |
현재가/Ticker
요청 시점의 종목 스냅샷입니다. 시가, 고가, 저가, 종가뿐 아니라 다음 정보도 함께 제공됩니다:
- 전일 종가 (
prev_closing_price): KST 0시 기준 전일 마지막 거래 가격 - 변화율 (
change_rate): 전일 종가 대비 가격 변화 비율 - 52주 신고가/신저가: 최근 52주간의 최고·최저 가격과 달성일
- 누적 거래대금 (
acc_trade_price_24h): 최근 24시간 동안의 총 거래 금액
호가 정보
호가(Orderbook)
현재 시장에 등록되어 있는 매수·매도 주문의 가격과 수량 목록입니다.
- 매도호가 (
ask_price): 매도 주문이 걸려 있는 가격 - 매수호가 (
bid_price): 매수 주문이 걸려 있는 가격 - 총 매도 잔량 (
total_ask_size): 호가에 등록된 전체 매도 수량 - 총 매수 잔량 (
total_bid_size): 호가에 등록된 전체 매수 수량
단일 거래 대상 페어 조회 시 최대 30호가, 복수 거래 대상 페어 조회 시 15호가까지 제공됩니다.
수수료
거래 수수료
주문 체결 시 부과되는 수수료입니다. 주문 가능 정보 API에서 마켓별 수수료율을 확인할 수 있습니다.
bid_fee/ask_fee: 매수·매도 수수료 비율maker_bid_fee/maker_ask_fee: 메이커 매수·매도 수수료 비율
Maker와 Taker:
- Maker — 호가에 주문을 등록하여 유동성을 제공하는 주체. 지정가 주문이 즉시 체결되지 않고 호가에 남을 때 Maker가 됩니다.
- Taker — 호가에 있는 기존 주문과 즉시 체결되는 주체. 시장가 주문이나 즉시 체결되는 지정가 주문이 Taker에 해당합니다.
일반적으로 Maker 수수료가 Taker 수수료보다 낮습니다.
입출금 수수료
가상 자산을 입금하거나 출금할 때 발생하는 수수료입니다. 네트워크별로 수수료가 다를 수 있으며, 입출금 수수료 조회 API에서 확인할 수 있습니다.
입출금
입금 상태
| 구분 | 상태 | 설명 |
|---|---|---|
| 입금 | DEPOSIT_PROCESSING | 입금 대기 중 |
| 입금 | DEPOSIT_ACCEPTED | 입금 완료 |
| 입금 | DEPOSIT_CANCELLED | 입금 취소 |
| 반환 | REFUNDING_PROCESSING | 반환 심사 중 |
| 반환 | REFUNDING_ACCEPTED | 반환 완료 |
출금 상태
| 상태 | API 값 | 설명 |
|---|---|---|
| 진행중 | PROCESSING | 출금이 처리 중인 상태 |
| 완료 | DONE | 출금이 완료된 상태 |
| 취소됨 | CANCELED | 출금이 취소된 상태 |
입출금 현황
각 가상 자산의 입출금 가능 여부와 블록체인 네트워크 상태를 나타냅니다.
| 지갑 상태 | 설명 |
|---|---|
working | 입출금 모두 가능 |
withdraw_only | 출금만 가능 |
deposit_only | 입금만 가능 |
paused | 입출금 중단 |
경보제
유의 종목 / 주의 종목
투자자 보호를 위해 특정 종목에 지정되는 경보 상태입니다.
- 유의 종목 (
market_warning: "CAUTION"): 거래 대상 목록 조회 API에서isDetails=true로 요청 시 확인 가능 - 주의 종목: 경보제 API에서 확인 가능
경보 유형(warning_type):
| 유형 | 설명 |
|---|---|
PRICE_SUDDEN_FLUCTUATION | 가격 급등락 |
PRICE_DIFFERENCE_HIGH | 글로벌 시세차이 |
SPECIFIC_ACCOUNT_HIGH_TRANSACTION | 소수계정 거래 집중 |
TRADING_VOLUME_SUDDEN_FLUCTUATION | 거래량 급등 |
DEPOSIT_AMOUNT_SUDDEN_FLUCTUATION | 입금량 급등 |
고급 주문
TWAP(Time-Weighted Average Price)
대량 주문을 일정 시간 동안 균등하게 분할하여 체결하는 주문 방식입니다. 시장 충격을 최소화하면서 시간 가중 평균 가격에 가깝게 체결할 수 있습니다.
주요 파라미터:
frequency: 분할 주문 간격 (초)
다건 주문(Batch Orders)
한 번의 API 요청으로 최대 20건의 주문을 동시에 생성할 수 있는 기능입니다. 다건 주문 취소는 최대 30건까지 가능합니다.
사용자 지정 주문 ID(client_order_id)
client_order_id)주문 생성 시 사용자가 직접 지정할 수 있는 식별자입니다. 서버가 발급하는 order_id와 별개로, 클라이언트 측에서 각 주문을 추적·매핑할 때 사용합니다. 미지정 시 응답에 포함되지 않으며, MyOrder 스트림에서도 동일하게 전달됩니다.
실시간 데이터(WebSocket)
WebSocket 스트림에서 사용하는 공통 개념입니다.
스트림 타입(stream_type)
stream_type)| 타입 | API 값 | 설명 |
|---|---|---|
| 스냅샷 | SNAPSHOT | 요청 시점의 상태를 1회 응답으로 수신 |
| 실시간 | REALTIME | 이후 발생하는 이벤트를 스트림 형태로 지속 수신 |
요청 시 is_only_snapshot 또는 is_only_realtime 필드로 수신 방식을 제한할 수 있으며, 두 필드를 모두 생략하면 스냅샷과 실시간 데이터를 모두 수신합니다.
응답 포맷(format)
format)| 포맷 | API 값 | 설명 |
|---|---|---|
| 기본형 | DEFAULT | 필드명이 전체 표기됨 (예: trade_price, order_id) |
| 축약형 | SIMPLE | 필드명이 간소화됨 (예: tp, oid). 트래픽 부담이 큰 경우 사용 |
요청 방법 및 포맷 페이지에서 WebSocket 요청 필드 상세를 확인할 수 있습니다.
Updated 13 days ago