TP/SL 주문
POST
/orders/tpsl
인증 헤더
| 헤더 | 설명 |
|---|---|
Authorization | Bearer {JWT} 형식의 인증 토큰 |
X-Signature | HMAC-SHA512 서명값 (Hex) |
X-Timestamp | 요청 시점의 Unix Timestamp (초 단위, 60초 이내) |
매매구분코드 (sideCd)
| 값 | 설명 |
|---|---|
BUY | 매수 — 롱 포지션 진입 |
SELL | 매도 — 숏 포지션 진입 |
SELL_TO_CLOSE | 전매 — 롱 포지션 청산 |
BUY_TO_COVER | 환매 — 숏 포지션 청산 |
TP/SL (이익실현 / 손실제한)
| 필드 | "Y" | "N" |
|---|---|---|
profitRealizationYn | profitRealizationBarrierPrice에 목표 가격 입력 | 가격 필드 생략 가능 |
lossReturnYn | lossReturnBarrierPrice에 손절 가격 입력 | 가격 필드 생략 가능 |
lossTrackingYn | 손실추적(Trailing Stop) 활성화 | 비활성화 |
참고: 이 API의 손실제한 필드명은 lossReturnYn/lossReturnBarrierPrice입니다 (신규주문의lossCutYn과 다름).
포지션 식별
purchaseDateTime — 대상 포지션의 매입일시balanceNo — 대상 포지션의 잔고번호요청
본문 파라미터application/json필수
응답
요청요청 예시
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev.your-api-server.com/orders/tpsl' \
--header 'Content-Type: application/json' \
--data-raw '{
"stockCd": "BTCUSD",
"sideCd": "BUY",
"orderQuantity": 1,
"profitRealizationYn": "Y",
"profitRealizationBarrierPrice": 0,
"lossReturnYn": "Y",
"lossReturnBarrierPrice": 0,
"lossTrackingYn": "Y",
"purchaseDateTime": "2025-08-15T00:00:00Z",
"balanceNo": "0000000001"
}'응답응답 예시
200 - 예시 1
{
"status": "success",
"code": 200,
"data": {
"orderDateTime": "2025-08-15T10:30:00Z",
"orderNo": "string"
}
}수정일 2026-03-26 08:43:48