신규주문
POST
/orders
인증 헤더
| 헤더 | 설명 |
|---|---|
Authorization | Bearer {JWT} 형식의 인증 토큰 |
X-Signature | HMAC-SHA512 서명값 (Hex) |
X-Timestamp | 요청 시점의 Unix Timestamp (초 단위, 60초 이내) |
주문유형코드 (orderTypeCd)
| 값 | 설명 | barrierPrice | orderPrice |
|---|---|---|---|
MARKET | 시장가 — 현재 시세로 즉시 체결 | 불필요 (0) | 불필요 (0) |
LIMIT | 지정가 — 지정한 가격에 도달하면 체결 | 불필요 (0) | 필수 |
STOP | 조건시장가 — 배리어 도달 시 시장가로 전환 | 필수 | 불필요 (0) |
LIMIT_STOP | 조건지정가 — 배리어 도달 시 지정가로 전환 | 필수 | 필수 |
매매구분코드 (sideCd)
| 값 | 설명 |
|---|---|
BUY | 매수 — 롱 포지션 진입 |
SELL | 매도 — 숏 포지션 진입 |
TP/SL (이익실현 / 손실제한)
| 필드 | "Y" | "N" |
|---|---|---|
profitRealizationYn | profitRealizationBarrierPrice에 목표 가격 입력 | 가격 필드에 0 전송 |
lossCutYn | lossCutBarrierPrice에 손절 가격 입력 | 가격 필드에 0 전송 |
lossTrackingYn | 손실추적(Trailing Stop) 활성화 | 비활성화 |
요청
본문 파라미터application/json필수
응답
요청요청 예시
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev.your-api-server.com/orders' \
--header 'Content-Type: application/json' \
--data-raw '{
"stockCd": "BTCUSD",
"orderTypeCd": "MARKET",
"sideCd": "BUY",
"orderQuantity": 1,
"barrierPrice": 0,
"orderPrice": 50000,
"profitRealizationYn": "Y",
"profitRealizationBarrierPrice": 0,
"lossCutYn": "Y",
"lossCutBarrierPrice": 0,
"lossTrackingYn": "Y"
}'응답응답 예시
200 - 예시 1
{
"status": "success",
"code": 200,
"data": {
"orderDateTime": "2019-08-24T14:15:22.123Z",
"orderNo": "string"
}
}수정일 2026-03-26 08:43:48