post
https://api.coinone.co.kr/v2.1/order
시장가, 지정가, 예약가 주문 유형으로 매수/매도 주문 등록
Permission: 주문관리 (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 | 예약가 주문이 실행되는 가격 (감시가) * 예약가에서 필수 | 예약가 |
- 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" |