行情與市場數據

查詢行情與批量快照，選擇 K 線週期和復權方式，按日期獲取歷史數據。

命令速覽

命令	説明
`futu quote <symbol...>`	查詢一個或多個標的的行情
`futu snapshot <symbol...>`	批量查詢行情快照
`futu basicinfo <symbol...>`	查詢證券基本信息
`futu kline <symbol>`	查詢最近的 K 線
`futu history-kline <symbol>`	按日期範圍查詢歷史 K 線
`futu ticker <symbol>`	查詢逐筆成交
`futu rt-data <symbol>`	查詢分時數據
`futu order-book <symbol>`	查詢買賣盤；`depth` 為別名
`futu rank [type]`	查詢市場排行榜
`futu option chain <symbol>`	查詢期權鏈
`futu market-state <symbol...>`	查詢市場狀態
`futu trading-days`	查詢指定市場的交易日

標的代碼格式

證券代碼採用 市場.代碼 格式：

示例	市場
`US.AAPL`	美股
`US.NVDA`	美股
`HK.00700`	港股
`SH.600519`	A 股（上交所）
`SZ.000858`	A 股（深交所）
`SG.D05`	新加坡
`KR.000660`	韓國

港股純數字代碼會自動補齊至五位，例如 HK.700 會被轉換為 HK.00700。代碼格式可被 CLI 識別，不代表所有接口或賬户都支持該市場。

search 接受公司名或關鍵詞，例如 futu search AAPL。加密貨幣交易命令使用交易對格式，例如 BTCUSD。

quote 與 snapshot

查看當前價格、漲跌、成交量或美股不同時段行情時，使用 quote；需要批量快照中的綜合字段時，使用 snapshot。兩者的 JSON 結構不同，應分別解析。

bash

futu quote HK.00700 US.AAPL --format json
futu snapshot HK.00700 US.AAPL --format json

quote 常用字段：

字段	含義
`code`	證券代碼，例如 US.AAPL
`last_price` / `prev_close_price`	價格 / 昨收；漲跌幅可按 `(last_price / prev_close_price - 1) × 100%` 計算
`open_price` / `high_price` / `low_price`	開盤價 / 最高價 / 最低價
`volume` / `turnover`	成交量 / 成交額，單位按具體品種解釋
`data_date` / `data_time`	接口返回的原始日期 / 時間字段，轉換時核對接口規定的格式、單位和時區
`pre_market` / `after_market` / `overnight`	有數據時返回的盤前 / 盤後 / 夜盤行情

價格應結合標的的計價幣種解釋；quote 不直接提供幣種字段。對象中的零值和空值可能被省略，詳見 JSON 輸出約定。

Last 為該時段價格，Change% 為漲跌幅。美股在有數據時還會顯示 PREMARKET、AFTERHOURS 或 OVERNIGHT 行；比較價格時應使用相同交易時段。表格未展示的原始字段可通過 JSON 查看。

K 線常用參數

獲取最近 100 根日 K 線：

bash

futu kline US.AAPL --ktype 2 --num 100 --autype 1 --format json

參數	默認值	常用取值與説明
`--ktype`	2	1 = 1 分鐘，2 = 日，3 = 周，4 = 月，6 = 5 分鐘，9 = 60 分鐘
`--num` / `-n`	100	返回根數，最多 370
`--autype`	1	0 = 不復權，1 = 前復權，2 = 後復權；`kline` 還支持 3 / 4（含分紅前 / 後復權），`history-kline` 支持 0 / 1 / 2
`--extended-time`	0	0 = 正常時段，1 = 含美股盤前盤後分鍾線，2 = 含美股夜盤；以接口與品種支持為準

比較同一標的的不同時段時，保持週期與復權方式一致。兩個 K 線命令的價格字段名也有差別：kline 使用 open_price、close_price 等；history-kline 使用 open、close 等。

歷史 K 線與分頁

先按日期讀取一頁，並保存結果。以下 Bash 示例使用 jq 提取下一頁遊標：

bash

futu history-kline US.AAPL --ktype 2 --autype 1 --num 100 \
  --start 2026-01-01 --end 2026-09-30 --format json > aapl-page-1.json

查詢成功後，讀取返回的 next_time。它可能位於 pagination、數據對象或頂層，取決於該響應是否包含分頁封裝：

bash

next_time=$(jq -r '.pagination.next_time // .data.next_time // .next_time // empty' aapl-page-1.json) || exit 1

if [ -n "$next_time" ] && [ "$next_time" != "0" ]; then
  futu history-kline US.AAPL --ktype 2 --autype 1 --num 100 \
    --start 2026-01-01 --next-time "$next_time" --format json > aapl-page-2.json
else
  printf '%s\n' '沒有有效的下一頁遊標；請結合已返回的日期範圍檢查是否取完。'
fi

--start、--end 使用 YYYY-MM-DD，含起止日期；省略 --end 時默認使用運行環境的當前日期。--next-time 使用毫秒時間戳，向更早的數據翻頁，並優先於 --end。繼續翻頁時，保持標的、週期、復權和起始日期一致；遊標為空或為 0 時不繼續，遊標重複時停止並檢查結果。

date 若以整數 YYYYMMDD 返回，應按日期解析；遊標的毫秒單位不能套用到所有時間字段。處理 time、time_key 等原始字段時，應核對對應接口的單位和時區。

行情與市場數據 ​

命令速覽 ​

標的代碼格式 ​

quote 與 snapshot ​

K 線常用參數 ​

歷史 K 線與分頁 ​

更多查詢示例 ​

行情與市場數據

命令速覽

標的代碼格式

quote 與 snapshot

K 線常用參數

歷史 K 線與分頁

更多查詢示例