API 레퍼런스

매수/매도 주문

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

Request Header

필드필수설명
X-COINONE-PAYLOADtrueRequest body object -> JSON string -> base64
X-COINONE-SIGNATUREtrueHMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Request Body

필드타입필수설명주문 유형
access_tokenStringtrue사용자의 액세스 토큰모든 유형
nonceStringtrueUUID nonce
* 예: "022f53b2-8b2f-40c6-8e51-b594f562ee83"
모든 유형
sideStringtrue매수/매도 분류

- BUY: 매수
- SELL : 매도
모든 유형
quote_currencyStringtrue마켓 기준 통화
* 예: KRW
모든 유형
target_currencyStringtrue주문하려는 종목의 심볼
* 예: BTC
모든 유형
typeStringtrue주문 유형

- LIMIT: 지정가
- MARKET : 시장가
- STOP_LIMIT : 예약가
모든 유형
priceStringfalse주문 가격
* 지정가, 예약가에서 필수
지정가, 예약가
qtyStringfalse주문 수량
* 지정가, 예약가, 시장가 매도에서 필수
* 최소수량단위 미만은 절사됩니다.
지정가, 예약가, 시장가 매도
amountStringfalse주문 총액
* 시장가 매수에서 필수
* 원화최소단위(0.0001) 미만은 절사됩니다.
시장가 매수
post_onlyBooleanfalsePost Only 주문 여부
* 지정가에서 필수
지정가
limit_priceStringfalse체결 가격의 최대/최소 한도 (상한가,하한가)시장가
trigger_priceStringfalse예약가 주문이 실행되는 가격 (감시가)
* 예약가에서 필수
예약가
user_order_idStringfalse- 150자까지 지원
- 알파벳 소문자 / 숫자 / 특수문자 - _ . 지원
- 거래쌍 상관 없이 기존에 입력한 user_order_id 는 재사용 불가
모든 유형
  • 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"
Language