行情与市场数据

查询行情与批量快照，选择 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 线与分页

更多查询示例