매수/매도 주문

시장가, 지정가, 예약가 주문 유형으로 매수/매도 주문 등록

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

요청 제한: 주문 API 합산 초당 40회 · 포트폴리오 기준 · 자세히 보기

Request Header

헤더필수설명
X-COINONE-PAYLOAD필수Request body object -> JSON string -> base64
X-COINONE-SIGNATURE필수HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Request Body

필드타입필수설명주문 유형
access_tokenString필수사용자의 액세스 토큰모든 유형
nonceString필수UUID nonce
* 예: "022f53b2-8b2f-40c6-8e51-b594f562ee83"
모든 유형
sideString필수

매수/매도 분류

- BUY: 매수
- SELL : 매도

모든 유형
quote_currencyString필수마켓 기준 통화
* 예: KRW
모든 유형
target_currencyString필수주문하려는 종목의 심볼
* 예: BTC
모든 유형
typeString필수

주문 유형

- LIMIT: 지정가
- MARKET : 시장가
- STOP_LIMIT : 예약가

모든 유형
priceString조건부주문 가격
* 지정가, 예약가에서 필수
지정가, 예약가
qtyString조건부주문 수량
지정가, 예약가, 시장가 매도에서 필수
최소수량단위 미만은 절사됩니다.
지정가, 예약가, 시장가 매도
amountString조건부주문 총액
시장가 매수에서 필수
원화최소단위(0.0001) 미만은 절사됩니다.
시장가 매수
post_onlyBoolean조건부Post Only 주문 여부
* 지정가에서 필수
지정가
limit_priceString선택체결 가격의 최대/최소 한도 (상한가,하한가)
* 미입력 시 가격 제한 없이 체결
시장가
trigger_priceString조건부예약가 주문이 실행되는 가격 (감시가)
* 예약가에서 필수
예약가
user_order_idString선택- 150자까지 지원
- 알파벳 소문자 / 숫자 / 특수문자 - _ . 지원
- 거래쌍 상관 없이 기존에 입력한 user_order_id 는 재사용 불가
모든 유형
smp_typeString선택자전거래 체결 방지(SMP) 모드
  • CANCEL_TAKER: 같은 계정 주문과 체결되기 직전에 새 주문의 미체결 잔량 취소
미입력 시 적용하지 않으며, 대소문자 구분 없음
모든 유형
  • limit_price 사용예시)
    • Case1: 시장가 매수, limit_price: 350 KRW 설정 시,
      • 350원 호가까지 체결, 한틱위인 350.1원의 경우, 추가적으로 체결할 수 있는 총액이 남아 있더라도 체결되지 않음.
      • 체결되지 않은 주문 총액은 자동으로 취소.
    • Case2: 시장가 매도, limit_price: 350 KRW 설정 시,
      • 350원 호가까지 체결, 한틱 아래인 349.9원의 경우, 추가적으로 체결할 수 있는 수량이 남아 있더라도 체결되지 않음.
      • 체결되지 않은 매도 총량은 자동으로 취소.

or

  • 시장가 주문 중, 1BTC 현재가 = 30,000,000KRW, 상한가 = 35,000,000KRW인 경우 상한가의 수량까지만 체결

Response Body

필드타입설명
resultString정상 처리 시 "success", 에러 발생 시 "error" 반환
error_codeNumberString정상 처리 시 "0", 에러 발생 시 에러코드 "0" 이 아닌 값 반환
order_idString주문 식별 가능한 ID
* 예: "d85cc6af-b131-4398-b269-ddbafa760a39"
Body Params
string
required

사용자의 액세스 토큰 (access token)

string
required

UUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83")

string
required

매수/매도 여부 (Enum: "BUY", "SELL")

string
required

마켓 기준 통화

string
required

주문하려는 종목의 심볼

string
required

주문 방식, LIMIT 지정가, STOP_LIMIT 예약 지정가, MARKET 시장가

string

지정가, 예약지정가 일때 , 주문 가격

string

지정가, 예약지정가, 시장가 매도일 때, 주문 수량

string

시장가 매수 일 때, 주문 총액

boolean

지정가 주문일때만, only maker로 주문할 것인지 여부

string

시장가 매수 일때 상한가, 매도 일때 하한가. 입력하지 않으면 가격 제한 없이 주문 체결

string

예약지정가 주문인 일때, 주문이 발동되는 금액

string

150자까지 지원 (알파벳 소문자 / 숫자 / 특수문자 - _ . 지원)

string

자전거래 체결 방지(SMP) 모드 (Enum: "CANCEL_TAKER", 대소문자 구분 없음). CANCEL_TAKER는 같은 계정 주문과 체결되기 직전에 새 주문의 미체결 잔량을 취소. 미입력 시 적용하지 않음

Headers
string
required

Request body object -> JSON string -> base64

string
required

HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Response

Language
LoadingLoading…
Response
Choose an example:
application/json