2026/04/20

1-11. NK-Fixed ATR

이것은 「캔들 마감 몇 초 전에 실시간 드로잉(그리기)을 시작할지 0초에서 5분 사이에서 조절할 수 있는」 기능이 탑재된 ATR입니다. 그 외에도 있으면 유용한 보조 기능들을 함께 추가했습니다.


[ATR]

ATR은 전일 종가로부터 발생하는 '갭(Gap)'을 포함하여 해당 일의 실제 최대 변동폭(True Range)을 산출하고, 그 일정 기간의 평균값(변동성의 절대값)을 시각화하는 지표입니다. 방향성이 위쪽인지 아래쪽인지는 전혀 관계가 없습니다. ATR의 수치가 클 때는 "시장의 변동이 심하다(에너지가 크다)", 작을 때는 "시장이 고요하다(에너지가 압축되어 있다)"는 것을 나타냅니다.


TradingView에서의 ATR 표시 예시
출처: TradingView


[NOTICE & LICENSE]
・학습 및 정보 제공만을 목적으로 하며, 투자 조언이 아닙니다. 툴 사용으로 인해 발생한 경제적 손실에 대해 일절 책임을 지지 않습니다.
・Pine Script v6에서 동작을 확인했습니다. 향후 TradingView의 사양 변경에 따른 업데이트를 보장하지 않으며, 개별적인 설치 지원이나 수정 요청은 일절 받지 않습니다 (있는 그대로(As-is) 제공).
MIT 라이선스가 적용됩니다.
// SPDX-FileCopyrightText: 2026 NK-report https://www.nk-report.com/
// SPDX-License-Identifier: MIT
//
// Disclaimer: This script is for educational purposes only and does not constitute investment advice.

//@version=6
indicator("NK-Fixed ATR", shorttitle="NK-Fixed ATR", overlay=false)

// ==============================================================================
// 【01】 免責・ライセンス
// ==============================================================================
//
// 지표를 무료로 공개하고 있습니다: https://www.nk-report.com/p/kr-tradingview.html
//
// 면책 조항: 본 스크립트는 학습 및 정보 제공만을 목적으로 하며, 투자 조언이 아닙니다.
//
// 1. 본 코드는 2026년 기준 Pine Script v6에서 동작 확인을 마쳤습니다.
//    향후 사양 변경으로 인한 오류 등에 대해 개별적인 지원이나 수정은 제공하지 않습니다.
// 2. 본 스크립트는 일반적인 계산 로직을 바탕으로 LLM을 활용하여 독자적으로 작성된 것입니다.
//    MIT 라이선스를 따릅니다.
// ------------------------------------------------------------------------------
// MIT License 
//
// Copyright 2026 NK-report https://www.nk-report.com/
//
// Permission is hereby granted, free of charge, to any person obtaining a copy of
// this software and associated documentation files (the "Software"), to deal in
// the Software without restriction, including without limitation the rights to
// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
// of the Software, and to permit persons to whom the Software is furnished to do
// so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.

// ==============================================================================
// 【02】 UI設定と言語
// ==============================================================================
// 1. 言語辞書の定義(テキストの定数化)

const string GRP_FIXED   = "▼ 그리기 제어"
const string LBL_SEC     = "실시간 그리기 시작 (캔들 마감 X초 전)"
const string TT_SEC      = "0초에서 300초(5분) 사이로 조절. 지정 시간(예: 10초 전)이 될 때까지 현재 캔들의 그리기를 숨깁니다.\n0초를 입력하면 숨김 기능을 비활성화하고 항상 실시간으로 그립니다."

const string GRP_ATR     = "▼ ATR 설정"
const string LBL_LEN     = "ATR 기간"
const string LBL_SIG     = "시그널 기간"

// 2. UI(ユーザー入力画面)の構築 & 3. トップダウン処理への適合

i_sec      = input.int(0, title=LBL_SEC, minval=0, maxval=300, group=GRP_FIXED, tooltip=TT_SEC)

i_len      = input.int(14, title=LBL_LEN, minval=1, group=GRP_ATR, inline="ATR1")
i_sig      = input.int(14, title=LBL_SIG, minval=1, group=GRP_ATR, inline="ATR1")


// ==============================================================================
// 【03】 全コード共通仕様(タイムゾーン・時間インフラ処理)
// ==============================================================================
// 1. 基本時間単位のシステム定義(定数化)
const int MS_PER_SEC  = 1000

// ==============================================================================
// 【04】 各カテゴリ共通仕様 (NK-Fixed Core Logic)
// ==============================================================================
// 1. カテゴリ固有のインフラ構築(コア機能の定義)
bool is_draw_ready = true

// リアルタイム足であり、かつユーザーが0秒より大きい数値を設定している場合のみ処理
if barstate.isrealtime and i_sec > 0
    if not na(time_close)
        int time_left_ms = time_close - timenow
        int threshold_ms = i_sec * MS_PER_SEC
        
        if time_left_ms > threshold_ms
            is_draw_ready := false


// ==============================================================================
// 【05】 このコード固有の計算仕様 (Specific Indicator Logic)
// ==============================================================================
// 1. インジケーター固有の純粋な数学的処理
float calc_atr = ta.atr(i_len)
// ATRの移動平均線(シグナル)を算出
float calc_sig = ta.sma(calc_atr, i_sig)

// 2. ロジックの完全な隔離と差し替えの容易性

// 3. 視覚的装飾の排除とデータの引き渡し
float final_atr = is_draw_ready ? calc_atr : na
float final_sig = is_draw_ready ? calc_sig : na


// ==============================================================================
// 【06】 描画と出力 (Rendering & Outputs)
// ==============================================================================
// 1. チャートへの視覚的出力(プロットと装飾)
plot(final_atr, title="ATR Line", color=#E91E63, linewidth=2)
plot(final_sig, title="Signal Line", color=color.new(#9E9E9E, 0), linewidth=1, style=plot.style_line)

// ユーザー追加ライン (Extra Line) - デフォルトは非表示(スタイルタブで設定・数値変更可能)
// ※ ATRは銘柄によって数値スケールが異なるため、初期値はプレースホルダーとして「0」にしています
hline(0, title="레벨 1", color=color.black, linestyle=hline.style_solid, display=display.none)
hline(0, title="레벨 2", color=color.black, linestyle=hline.style_solid, display=display.none)

// 2. ロジックとデザインの完全分離

// 3. アラート(通知)条件の統合
// ※投資助言を回避するため、方向性を指示する言葉(Buy/Sell等)は使わず、純粋な事実・状態のみを通知します
bool cross_over_sig  = ta.crossover(calc_atr, calc_sig) and is_draw_ready
bool cross_under_sig = ta.crossunder(calc_atr, calc_sig) and is_draw_ready

alertcondition(cross_over_sig,  title="ATR Cross Over Signal",  message="ATR crossed over its Signal line (Volatility Expanding)")
alertcondition(cross_under_sig, title="ATR Cross Under Signal", message="ATR crossed under its Signal line (Volatility Contracting)")

* 원하는 색상으로 설정한 후, 설정 탭에서 '기본값으로 저장'을 눌러주세요.
* 새로 만들기 -> 지표 -> 붙여넣기 순서로 진행하지 않으면 정상적으로 표시되지 않을 수 있습니다.