OPEN-SOURCE SCRIPT
ATR SL

### 📘 **스크립트 설명 — ATR 기반 스탑로스 표시기 (ATR SL)**
이 스크립트는 **캔들 저가(low)와 ATR(평균 진폭 지표)** 를 활용해
트레이딩 시 **동적인 스탑로스 라인과 라벨**을 자동으로 표시해주는 인디케이터입니다.
---
#### 🔧 **기본 로직**
* **각 봉별 ATR(10)** 을 이용하여 변동성 기반 스탑로스 계산
→ `ATR SL = 저가 - ATR(10) × Multiplier`
* **오늘 봉(실시간)** 은 변동성이 작게 잡히는 것을 방지하기 위해
`오늘 ATR`과 `전일 ATR` 중 **더 큰 값**을 사용
* 과거 봉들은 해당 시점의 **그날 ATR**로 계산되어 고정됨
---
#### 🎯 **표시 요소**
| 항목 | 설명 |
| --------------------- | ----------------------------------- |
| **핑크 라인** | 각 봉별 스탑로스 라인 (`저가 - ATR × m`) |
| **오늘 스탑 라벨** | 현재 캔들 위에 표시되는 오늘 기준 스탑 가격 |
| **최근 5일 중 맥시멈 스탑 라벨** | 최근 5일간 가장 높은 스탑로스 값이 발생한 봉 위에 1개 표시 |
---
#### ⚙️ **주요 설정값**
| 이름 | 설명 | 기본값 |
| ------------ | -------------------------------- | ---- |
| `Length` | ATR 계산 기간 | 10 |
| `Smoothing` | ATR 계산 방식 (RMA/SMA/EMA/WMA 중 선택) | RMA |
| `Multiplier` | ATR 배수 (리스크 여유 조절) | 1.01 |
| `Long Base` | 기준가 (보통 저가 low 사용) | low |
| `Lookback` | 최근 N봉 중 최고 스탑 탐색 구간 | 5 |
---
#### 🎨 **색상**
* 라인: 연핑크 (`rgba(255,105,180,0.3)`)
* 라벨: 진한 핑크 (`rgba(255,105,180,0.1)`)
* 텍스트: 흰색
---
#### 📈 **활용 예시**
* **스탑로스 설정:**
ATR 기반의 변동성 대응형 스탑라인을 즉시 시각화
* **리스크 관리:**
변동성이 줄어들 때도 지나치게 좁은 스탑을 방지 (오늘 봉은 `max(오늘ATR, 전일ATR)` 적용)
* **트레일링 스탑 용도:**
상승 추세에서 최근 5일 중 최고 스탑 라벨 참고 가능
---
#### 🧠 **주의사항**
* 라벨은 항상 **2개만 표시됨**
→ 오늘 스탑 1개 + 최근 5일 맥시멈 스탑 1개
* 하단 보조창이 아니라 **메인 차트 위(`overlay=true`)** 에 표시
* 멀티라인 문법 오류 방지를 위해 모든 `label.new()`는 **한 줄로 작성됨**
---
#### 💬 **요약**
> ATR SL = 변동성을 반영한 실전용 스탑로스 표시기
> → 실시간 ATR 보정(`max(오늘, 어제)`)으로 장 초반 왜곡 방지
> → 최근 5일 최고 스탑과 오늘 스탑을 함께 시각화해 추세 파악 용이
---
필요하면 제목 아래에 이런 문구를 추가해도 좋아👇
> “By turtlekim 🐢 — 변동성 기반 리스크 매니지먼트용 Pine Script”
──────────────────────────────────────────────────────────────
// 📘 ATR SL — 변동성 기반 스탑로스 표시기 (by turtlekim)
//
// This script visualizes a **volatility-based stop loss** line
// using each candle's **Low** and **ATR(10)** value.
// Designed for traders who want adaptive, risk-adjusted stop levels.
//
//──────────────────────────────────────────────────────────────
// 🔧 기본 로직 / Core Logic
// - ATR SL = Low - ATR(10) × Multiplier
// - For historical candles → uses that day's ATR(10)
// - For the current (realtime) candle → uses max(Today’s ATR, Previous ATR)
// to prevent unrealistically small stops when volatility is low early in the session.
//
//──────────────────────────────────────────────────────────────
// 🎯 표시 요소 / Display Elements
// • Pink line → ATR-based stop line per candle
// • Pink label → Today’s stop (current candle)
// • Pink label → Highest stop over the past 5 bars (1 label only)
//
//──────────────────────────────────────────────────────────────
// ⚙️ 주요 설정값 / Key Parameters
// Length : ATR period (default = 10)
// Smoothing : Type of ATR averaging (RMA/SMA/EMA/WMA)
// Multiplier : Adjusts distance from Low (default = 1.01)
// Long Base : Reference price (usually Low)
// Lookback : Number of bars for max stop check (default = 5)
//
//──────────────────────────────────────────────────────────────
// 🎨 색상 / Color Scheme
// • Line : Light pink (rgba(255,105,180,0.3))
// • Labels : Solid pink (rgba(255,105,180,0.1))
// • Text : White
//
//──────────────────────────────────────────────────────────────
// 📈 활용 예시 / How to Use
// - Set your stop-loss visually at the pink line (ATR-based distance).
// - For position sizing, use this stop level to calculate volatility risk.
// - Track both today’s stop and the 5-bar max stop to monitor trailing support.
//
//──────────────────────────────────────────────────────────────
// 🧠 주의사항 / Notes
// • Only two labels are shown: Today’s stop + 5-bar max stop.
// • Works only on main chart (overlay=true).
// • All label.new() statements are written in a single line
// to avoid syntax errors in Pine Script.
//
//──────────────────────────────────────────────────────────────
// 💬 요약 / Summary
// ATR SL = Dynamic, volatility-adjusted stop loss visualizer
// → Prevents premature stopouts in early low-volatility periods
// → Highlights both current and recent 5-bar maximum stops
//
//──────────────────────────────────────────────────────────────
Open-source Skript
Ganz im Sinne von TradingView hat dieser Autor sein/ihr Script als Open-Source veröffentlicht. Auf diese Weise können nun auch andere Trader das Script rezensieren und die Funktionalität überprüfen. Vielen Dank an den Autor! Sie können das Script kostenlos verwenden, aber eine Wiederveröffentlichung des Codes unterliegt unseren Hausregeln.
Haftungsausschluss
Die Informationen und Veröffentlichungen sind nicht als Finanz-, Anlage-, Handels- oder andere Arten von Ratschlägen oder Empfehlungen gedacht, die von TradingView bereitgestellt oder gebilligt werden, und stellen diese nicht dar. Lesen Sie mehr in den Nutzungsbedingungen.
Open-source Skript
Ganz im Sinne von TradingView hat dieser Autor sein/ihr Script als Open-Source veröffentlicht. Auf diese Weise können nun auch andere Trader das Script rezensieren und die Funktionalität überprüfen. Vielen Dank an den Autor! Sie können das Script kostenlos verwenden, aber eine Wiederveröffentlichung des Codes unterliegt unseren Hausregeln.
Haftungsausschluss
Die Informationen und Veröffentlichungen sind nicht als Finanz-, Anlage-, Handels- oder andere Arten von Ratschlägen oder Empfehlungen gedacht, die von TradingView bereitgestellt oder gebilligt werden, und stellen diese nicht dar. Lesen Sie mehr in den Nutzungsbedingungen.