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
//
//──────────────────────────────────────────────────────────────
Script de código abierto
Siguiendo fielmente el espíritu de TradingView, el creador de este script lo ha publicado en código abierto, permitiendo que otros traders puedan revisar y verificar su funcionalidad. ¡Enhorabuena al autor! Puede utilizarlo de forma gratuita, pero tenga en cuenta que la publicación de este código está sujeta a nuestras Normas internas.
Exención de responsabilidad
La información y las publicaciones que ofrecemos, no implican ni constituyen un asesoramiento financiero, ni de inversión, trading o cualquier otro tipo de consejo o recomendación emitida o respaldada por TradingView. Puede obtener información adicional en las Condiciones de uso.
Script de código abierto
Siguiendo fielmente el espíritu de TradingView, el creador de este script lo ha publicado en código abierto, permitiendo que otros traders puedan revisar y verificar su funcionalidad. ¡Enhorabuena al autor! Puede utilizarlo de forma gratuita, pero tenga en cuenta que la publicación de este código está sujeta a nuestras Normas internas.
Exención de responsabilidad
La información y las publicaciones que ofrecemos, no implican ni constituyen un asesoramiento financiero, ni de inversión, trading o cualquier otro tipo de consejo o recomendación emitida o respaldada por TradingView. Puede obtener información adicional en las Condiciones de uso.