2026/04/20

1-11. NK-Fixed ATR

這是一款具備「可自由調整在 K 棒收盤前 0 秒至 5 分鐘內,何時開始實時(Real-time)繪圖」功能的 ATR。此外也整合了其他多項實用的輔助功能。


[ATR]

ATR(真實波動幅度均值)是一種指標,它會計算包含前一日收盤價所產生的「跳空缺口(Gap)」在內,當日的真實最大波幅(True Range),並將其在一定期間內的平均值(波動率的絕對值)視覺化。價格的方向是向上還是向下與它完全無關。當 ATR 數值較大時,表示市場正處於「劇烈震盪(能量龐大)」的狀態;而數值較小時,則表示市場「沉寂平靜(能量正在壓縮)」。


TradingView 上的 ATR 顯示範例
來源: TradingView


[NOTICE & LICENSE]
・僅供學習與提供資訊之用,不構成投資建議。對於因使用本工具而產生之任何經濟損失,概不負責。
・已於 Pine Script v6 測試運作。以「現狀 (As-is)」提供,不保證因未來 TradingView 系統規格變更而進行更新,亦不接受個別的安裝支援或修改請求。
・適用 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/tw-tradingview.html
//
// 免責聲明:本腳本僅供學習與資訊參考之用,不構成任何投資建議。
//
// 1. 本程式碼截至 2026 年,已在 Pine Script v6 環境下完成運作測試。
//    日後若因規格變動而導致任何異常,恕不提供個別的技術支援或修改服務。
// 2. 本腳本係基於一般的計算邏輯,並透過 LLM 獨立編寫而成。
//    本程式碼採用 MIT 授權條款 (MIT License) 進行發布。
// ------------------------------------------------------------------------------
// 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     = "即時繪圖開始 (K棒收盤前X秒)"
const string TT_SEC      = "可在0秒至300秒(5分鐘)之間調整。在達到指定時間(例如:收盤前10秒)之前,將隱藏當前K棒的繪圖。\n若輸入0秒,則停用隱藏功能,並始終即時繪圖。"

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)")

* 設定好喜歡的顏色配置後,請在設定分頁中點擊「儲存為預設值」。
* 若未按照「新增 → 指標 → 貼上」的順序操作,可能無法正確顯示。