歷史K線查詢

用一筆 K 線概括一段價格變化

K 線（也常稱蠟燭圖）把某個時間週期內的價格整理成開盤、最高、最低、收盤四個值，常見資料還會附成交量。開盤與收盤描述週期兩端的價格，最高與最低標示週期內的價格範圍；因此一根 K 線代表一段時間，不是單一時點的報價。臺灣證券交易所公布的歷史指數資料也以日期及開、高、低、收欄位列示，期貨交易所的教學則以相同四項說明 K 線資訊。這些資料可協助理解欄位名稱，不能據此推定本頁查詢資料的提供者或涵蓋市場。

本頁依商品代碼、週期、日期與「含最新」選項送出查詢，呈現服務回傳的價格走勢及明細；若回傳內容可解析成 K 線序列，圖表會以收盤價繪製，表格列出時間、開盤、最高、最低、收盤與成交量，並可複製原始 JSON。若資料欄位結構不同，畫面會以一般欄位方式呈現。可選週期包括 1、3、5、10、15、30 分鐘、1、2、3、4 小時，以及日、週、月 K。

讀懂查詢日期與回溯窗口

日期是查詢區間較新的一端，表單會依週期限制可選日期，並顯示一次查詢大致回溯的起訖日。可選日期的最早範圍與單次回傳長度不同：表單日期上限約為 1 分鐘 30 天、其他分鐘及小時週期 180 天、日週月週期 10 年；單次查詢則依週期約回溯當日、前 2 日、前 9 日、近 3 個月、近 2 年或近 5 年。這些是介面設定的估計窗口，不保證服務一定有該段資料；實際起訖時間與筆數以查詢結果為準。

按代碼和週期查詢

1. 填入商品代碼

   輸入單一代碼，或點選欄位旁的範例代碼帶入。範例包含 XAUUSD、XAGUSD、AAPL、TSLA、BTCUSD、EURUSD；這些只是表單範例，並非完整支援清單。代碼格式依商品與資料服務而異，請先確認手上的代碼格式。

2. 選擇週期和日期

   選擇分鐘、 小時、日、週或月週期，再指定較新端日期。切換週期後，日期可能會自動調整到該週期允許的範圍；查看畫面顯示的預估查詢區間。

3. 設定是否納入最新資料

   「含最新」選「是」或「否」後送出查詢。這個選項控制是否納入最新一筆資料，不足以證明該筆所屬時段已結束；要做歷史整理，請檢查時間欄位並確認時段狀態。

4. 核對明細並複製

   檢視圖表與表格中的時間、開高低收及成交量欄位。需要在其他程式整理時可複製 JSON；使用前先核對代碼、週期、日期和資料欄位，不要只憑圖形判讀。

查詢時常見的幾個疑問

為什麼輸入代碼後沒有 K 線資料？

可能是代碼格式不符、所選日期沒有回傳紀錄，或服務沒有提供該商品與區間的資料。請核對代碼、日期及週期後再試；空結果不能用來證明市場沒有該商品的歷史行情。

日期可以選很久以前，為什麼一次只看到較短區間？

日期選擇器限制可指定的較新端日期，單次查詢另按週期設定較短的預估窗口。請以結果實際列出的時間範圍判斷本次資料，不要把日期可選範圍當作單次下載長度。

「含最新」代表即時行情嗎？

不代表。它只表示查詢是否納入最新一筆資料；本頁沒有可核實的資料更新頻率或延遲資訊，也不能保證最新一筆仍會即時變動。盤中決策請使用能確認即時性與交易所口徑的行情來源。

成交量和價格能直接跨商品比較嗎？

不宜直接比較。不同商品的幣別、報價單位、成交量單位、交易時段及資料調整方式可能不同，而本工具沒有提供足以確認這些口徑的說明。比較前應向相關市場或資料提供者確認定義。

資料口徑與使用界線

此頁連接第三方行情服務，但原始資料蒐集者、商品完整清單、更新時間、時間戳時區、成交量單位及價格是否復權均未核實。查詢時所選日期不代表資料更新日期；頁面範例商品也不構成覆蓋保證。資料可能缺漏或採用不同市場口徑，請依實際回傳值及原始服務說明核對。

歷史價格只呈現過去資料，無法單獨說明價格變動原因或預測未來。圖表、欄位和 K 線型態不構成買賣訊號或投資建議；若用於研究、回測或交易檢核，先確認資料來源、時間、復權、成交量定義及授權，再與交易所或合格資料來源交叉核對。