업비트의 주문 API 알아보기

먼저 업비트의 주문 API의 사용법은 주문하기 문서에서 확인하실 수 있어요.

API 사용법 자체에 대한 가이드는 매우 친절한 편이나 금융지식이 없으면 모를 수 있는 용어들도 일부 있을 것 같습니다.

 

공식 문서를 통해 API 확인하기

먼저 API를 통해 전달할 파라미터에 대해 공식 문서에 나온 내용을 바탕으로 조금 더 알아보도록 하겠습니다. 공식 문서 내용이 충분한 경우는 따로 부가 설명을 추가하지 않았습니다.

필드	공식 문서 설명	타입	부가 설명
market *	마켓 ID (필수)	String	업비트 API에서 마켓 ID는 각 거래쌍(예: 비트코인/원화, 이더리움/비트코인 등)을 구분하는 고유한 문자열입니다. 종목 코드 조회 API를 통해서 모든 마켓 ID를 확인하실 수 있습니다. 예: KRW-BTC → 원화 마켓의 비트코인 BTC-ETH → 비트코인 마켓의 이더리움
side *	주문 종류 (필수) - bid : 매수 - ask : 매도	String	-
volume *	주문량 (지정가, 시장가 매도 시 필수)	NumberString	-
price *	주문 가격. (지정가, 시장가 매수 시 필수) ex) KRW-BTC 마켓에서 1BTC당 1,000 KRW로 거래할 경우, 값은 1000 이 된다. ex) KRW-BTC 마켓에서 1BTC당 매도 1호가가 500 KRW 인 경우, 시장가 매수 시 값을 1000으로 세팅하면 2BTC가 매수된다. (수수료가 존재하거나 매도 1호가의 수량에 따라 상이할 수 있음)	NumberString	-
ord_type *	주문 타입 (필수) - limit : 지정가 주문 - price : 시장가 주문(매수) - market : 시장가 주문(매도) - best : 최유리 주문 (time_in_force 설정 필수)	String	* 시장가 거래시 side/order_type/price or volume이 잘 맞아야 합니다. 매수: bid - price - price 매도: ask - market - volume * best인 경우 시장가 중에 가장 유리한 매도 호가를 지정가로 매수가 이루어집니다.
identifier	조회용 사용자 지정값 (선택)	String (Uniq 값 사용)	-
time_in_force	IOC, FOK 주문 설정* - ioc : Immediate or Cancel - fok : Fill or Kill *ord_type이 best 혹은 limit 일때만 지원됩니다.	String	* ioc: 즉시 체결 가능한 부분만 매수/매도 하고 나머지 주문은 취소. 즉 부분 체결을 하고 나머지는 취소시킵니다. * fok: 주문량이 best 혹은 limit 가격에 전량 체결이 가능할 때만 주문을 처리하고 아니면 주문을 전체 취소합니다.

 

원화로 주문할 경우 원화 마켓 주문 가격 단위(https://docs.upbit.com/kr/docs/krw-market-info)를, 비트코인으로 거래할 경우 비트 코인 거래 단위(https://docs.upbit.com/kr/docs/btc-market-info)를 먼저 확인해 주세요.

 

API Key 발급받기

API Key를 발급받는 방법은 이전 글을 참조하실 수 있습니다 :)

2025.02.03 - [암호화폐] - 업비트 API Key, 출금허용주소 등록

업비트 API Key, 출금허용주소 등록