post https://api.coinone.co.kr/v2.1/order
시장가, 지정가, 예약가 주문 유형으로 매수/매도 주문 등록
Request Header
필드 | 필수 | 설명 |
---|---|---|
X-COINONE-PAYLOAD | true | Request body object -> JSON string -> base64 |
X-COINONE-SIGNATURE | true | HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest() |
Request Body
필드 | 타입 | 필수 | 설명 | 주문 유형 |
---|---|---|---|---|
access_token | String | true | 사용자의 액세스 토큰 | 모든 유형 |
nonce | String | true | UUID nonce * 예: "022f53b2-8b2f-40c6-8e51-b594f562ee83" | 모든 유형 |
side | String | true | 매수/매도 분류 - BUY : 매수- SELL : 매도 | 모든 유형 |
quote_currency | String | true | 마켓 기준 통화 * 예: KRW | 모든 유형 |
target_currency | String | true | 주문하려는 종목의 심볼 * 예: BTC | 모든 유형 |
type | String | true | 주문 유형 - LIMIT : 지정가- MARKET : 시장가- STOP_LIMIT : 예약가 | 모든 유형 |
price | String | false | 주문 가격 * 지정가, 예약가에서 필수 | 지정가, 예약가 |
qty | String | false | 주문 수량 * 지정가, 예약가, 시장가 매도에서 필수 * 최소수량단위 미만은 절사됩니다. | 지정가, 예약가, 시장가 매도 |
amount | String | false | 주문 총액 * 시장가 매수에서 필수 * 원화최소단위(0.0001) 미만은 절사됩니다. | 시장가 매수 |
post_only | Boolean | false | Post Only 주문 여부 * 지정가에서 필수 | 지정가 |
limit_price | String | false | 체결 가격의 최대/최소 한도 (상한가,하한가) | 시장가 |
trigger_price | String | false | 예약가 주문이 실행되는 가격 (감시가) * 예약가에서 필수 | 예약가 |
user_order_id | String | false | - 150자까지 지원 - 알파벳 소문자 / 숫자 / 특수문자 - _ . 지원 - 거래쌍 상관 없이 기존에 입력한 user_order_id 는 재사용 불가 | 모든 유형 |
- limit_price 사용예시)
- Case1: 시장가 매수, limit_price: 350 KRW 설정 시,
- 350원 호가까지 체결, 한틱위인 350.1원의 경우, 추가적으로 체결할 수 있는 총액이 남아 있더라도 체결되지 않음.
- 체결되지 않은 주문 총액은 자동으로 취소.
- Case2: 시장가 매도, limit_price: 350 KRW 설정 시,
- 350원 호가까지 체결, 한틱 아래인 349.9원의 경우, 추가적으로 체결할 수 있는 수량이 남아 있더라도 체결되지 않음.
- 체결되지 않은 매도 총량은 자동으로 취소.
- Case1: 시장가 매수, limit_price: 350 KRW 설정 시,
or
- 시장가 주문 중, 1BTC 현재가 = 30,000,000KRW, 상한가 = 35,000,000KRW인 경우 상한가의 수량까지만 체결
Response Body
필드 | 타입 | 설명 |
---|---|---|
result | String | 정상 처리 시 "success", 에러 발생 시 "error" 반환 |
error_code | NumberString | 정상 처리 시 "0", 에러 발생 시 에러코드 "0" 이 아닌 값 반환 |
order_id | String | 주문 식별 가능한 ID * 예: "d85cc6af-b131-4398-b269-ddbafa760a39" |