청산된 포지션 (History)
Positions 페이지의 두 번째 탭. 청산이 완료된 포지션을 자산군 필터와 함께 조회합니다.
📸 Position History 탭 (추후 자동 캡처 예정)
테이블 컬럼
Open 탭과 거의 동일하지만 Action 컬럼이 사라지고, 대신 다음 정보가 의미를 갖습니다.
| 컬럼 | History 탭에서의 의미 |
|---|---|
| Current Price | 청산가로 freeze (재시세 없음) |
| Unrealized P&L | 사실상 realized P&L (청산 시점 기준) |
| Stop Loss / Take Profit | 청산 사유 추론용 (SL/TP/manual) |
청산 사유 (Strategy 컬럼)
strategy 필드는 다음 값들로 보강됩니다.
| 값 | 의미 |
|---|---|
momentum, mean_reversion 등 | 신호 발생 청산 |
manual | UI Close 버튼 |
stop_loss | SL 트리거 |
take_profit | TP 트리거 |
liquidation | 마진 부족 강제 청산 |
자산군 필터
탭과 자산군 필터는 직교합니다. KR + History 조합 → KIS 청산 종목만 표시.
API 호출
curl -s -H "Authorization: Bearer $TOKEN" \
"http://localhost:8000/api/positions/history?asset_class=us_equity"
응답은 Open 탭과 동일한 스키마이며, closed_at != null인 행만 포함됩니다.
자주 묻는 질문
Q. History와 Trades 페이지의 차이는?
A. Positions/History는 포지션 단위(open→close 한 쌍), Trades는 체결 단위(개별 fill)입니다. 한 포지션이 여러 fill로 청산되면 Trades에서는 여러 줄, Positions/History에서는 한 줄로 보입니다.
Q. SL이 트리거됐는데 strategy가 momentum으로 표시됩니다.
A. 일부 broker는 청산 사유를 별도 필드로 제공하지 않아 strategy를 그대로 보여줍니다. SL 가격과 청산가를 비교해 추론하세요.
Q. P&L 합계가 거래 통계와 다릅니다.
A. Trades 페이지는 fee/slippage 적용 후 net P&L 기준이고, Positions/History는 진입가-청산가 단순 차이입니다. 보통 0.05–0.2% 차이가 정상입니다.