청산주문
POST
/orders/close-out
인증 헤더
| 헤더 | 설명 |
|---|---|
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)
| 값 | 설명 |
|---|---|
SELL_TO_CLOSE | 전매 — 롱 포지션 청산 |
BUY_TO_COVER | 환매 — 숏 포지션 청산 |
포지션 식별
purchaseDateTime — 청산할 포지션의 매입일시balanceNo — 청산할 포지션의 잔고번호요청
본문 파라미터application/json필수
응답
요청요청 예시
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev.your-api-server.com/orders/close-out' \
--header 'Content-Type: application/json' \
--data-raw '{
"stockCd": "BTCUSD",
"orderTypeCd": "MARKET",
"sideCd": "BUY",
"orderQuantity": 0,
"barrierPrice": 0,
"orderPrice": 50000,
"purchaseDateTime": "2025-08-15T00:00:00Z",
"balanceNo": "0000000001"
}'응답응답 예시
200 - 예시 1
{
"status": "success",
"code": 200,
"data": {
"orderDateTime": "2019-08-24T14:15:22.123Z",
"orderNo": "string"
}
}수정일 2026-03-26 08:43:48