行情快照
POST/api/v1.0/quote/snapshot批量获取标的的行情快照(实时)。一次调用最多 400 个 code,按品类返回相应字段。
聚合实时报价(更轻量)请用 get_stock_quote;分时数据请用 get_rt_data;逐笔成交请用 get_rt_ticker;买卖盘请用 get_order_book。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
code_list | string[] | 请求体 | 是 | 标的代码列表,最少 1 个、最多 400 个。格式 <MARKET>.<CODE>,如 HK.09988、US.AAPL。 |
请求示例
bash
curl -s -X POST "https://webapi.futunn.com/api/v1.0/quote/snapshot" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <AccessToken>" \
-d '{"code_list":["HK.09988","BMD.FCPOmain","HK.TCH260629C390000"]}' | jq响应字段
返回 data.snapshot_list[],每个元素一份标的快照。字段按类别分组(不适用品类的字段会缺省 / 置 0 / 空字符串)。
历史收盘价字段 close_price_* 与 last_price 单位一致,随快照返回,无需新增订阅类型。未取得对应历史数据时,字段可能缺省或为 0;0 不代表实际收盘价。
通用字段(所有品类返回)
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.snapshot_list | object[] | |
data.snapshot_list[].code | string | |
data.snapshot_list[].name | string | |
data.snapshot_list[].sc_name | string | |
data.snapshot_list[].tc_name | string | |
data.snapshot_list[].update_time | int | |
data.snapshot_list[].data_date | string | |
data.snapshot_list[].last_price | number | |
data.snapshot_list[].open_price | number | |
data.snapshot_list[].high_price | number | |
data.snapshot_list[].low_price | number | |
data.snapshot_list[].prev_close_price | number | |
data.snapshot_list[].close_price_5min | number | 5 分钟收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_15min | number | 15 分钟收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_5day | number | 5 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_10day | number | 10 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_20day | number | 20 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_60day | number | 60 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_120day | number | 120 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_250day | number | 250 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_month | number | 1 月收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_year | number | 1 年收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].close_price_3year | number | 3 年收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。 |
data.snapshot_list[].volume | int | |
data.snapshot_list[].turnover | number | |
data.snapshot_list[].turnover_rate | number | |
data.snapshot_list[].amplitude | number | |
data.snapshot_list[].volume_ratio | number | |
data.snapshot_list[].bid_ask_ratio | number | |
data.snapshot_list[].sec_status | string | |
data.snapshot_list[].dark_status | string | |
data.snapshot_list[].listing_date | int | |
data.snapshot_list[].bid_price | number | |
data.snapshot_list[].ask_price | number | |
data.snapshot_list[].bid_vol | int | |
data.snapshot_list[].ask_vol | int | |
data.snapshot_list[].price_spread | number | |
data.snapshot_list[].highest52weeks_price | number | |
data.snapshot_list[].lowest52weeks_price | number | |
data.snapshot_list[].highest_history_price | number | |
data.snapshot_list[].lowest_history_price | number | |
data.snapshot_list[].equity_valid | bool | |
data.snapshot_list[].issued_shares | int | |
data.snapshot_list[].total_market_val | number | |
data.snapshot_list[].outstanding_shares | int | |
data.snapshot_list[].circular_market_val | number | |
data.snapshot_list[].pe_ratio | number | |
data.snapshot_list[].pe_ttm_ratio | number | |
data.snapshot_list[].pb_ratio | number | |
data.snapshot_list[].dividend_ttm | number | |
data.snapshot_list[].dividend_ratio_ttm | number | |
data.snapshot_list[].dividend_lfy | number | |
data.snapshot_list[].dividend_lfy_ratio | number | |
data.snapshot_list[].net_asset | number | |
data.snapshot_list[].net_asset_per_share | number | |
data.snapshot_list[].net_profit | number | |
data.snapshot_list[].ey_ratio | number | |
data.snapshot_list[].earning_per_share | number | |
data.snapshot_list[].index_raise_count | int | |
data.snapshot_list[].index_fall_count | int | |
data.snapshot_list[].index_equal_count | int | |
data.snapshot_list[].suspension | bool | |
data.snapshot_list[].avg_price | number | |
data.snapshot_list[].wrt_valid | bool | |
data.snapshot_list[].wrt_maturity_date | int | |
data.snapshot_list[].wrt_end_trade | string | |
data.snapshot_list[].trust_valid | bool | |
data.snapshot_list[].trust_aum | number | |
data.snapshot_list[].trust_assetClass | string | |
data.snapshot_list[].trust_dividend_yield | number | |
data.snapshot_list[].trust_netAssetValue | number | |
data.snapshot_list[].trust_outstanding_units | string | |
data.snapshot_list[].trust_premium | number | |
data.snapshot_list[].lot_size | int | |
data.snapshot_list[].option_valid | bool | |
data.snapshot_list[].option_strike_price | number | |
data.snapshot_list[].option_contract_size | int | |
data.snapshot_list[].option_open_interest | int | |
data.snapshot_list[].option_implied_volatility | number | |
data.snapshot_list[].delta | number | |
data.snapshot_list[].gamma | number | |
data.snapshot_list[].vega | number | |
data.snapshot_list[].theta | number | |
data.snapshot_list[].rho | number | |
data.snapshot_list[].option_net_open_interest | int | |
data.snapshot_list[].option_contract_nominal_value | number | |
data.snapshot_list[].option_owner_lot_multiplier | number | |
data.snapshot_list[].option_type | string | |
data.snapshot_list[].option_contract_multiplier | string | |
data.snapshot_list[].index_option_type | int | |
data.snapshot_list[].option_expiry_date_distance | int | |
data.snapshot_list[].option_area_type | string | |
data.snapshot_list[].index_valid | bool | |
data.snapshot_list[].plate_valid | bool | |
data.snapshot_list[].future_valid | bool | |
data.snapshot_list[].future_ex_data | object | |
data.snapshot_list[].future_ex_data.last_settle_price | number | |
data.snapshot_list[].future_ex_data.position | int | |
data.snapshot_list[].future_ex_data.position_change | int | |
data.snapshot_list[].event_contract_ex_data | object | |
data.snapshot_list[].event_contract_ex_data.settle_result | int | |
data.snapshot_list[].event_contract_ex_data.settle_value | number | |
data.snapshot_list[].event_contract_ex_data.settle_time | int | |
data.snapshot_list[].event_contract_ex_data.open_interest | string | |
data.snapshot_list[].event_contract_ex_data.liquidity | string | |
data.snapshot_list[].pre_price | number | |
data.snapshot_list[].pre_high_price | number | |
data.snapshot_list[].pre_low_price | number | |
data.snapshot_list[].pre_volume | int | |
data.snapshot_list[].pre_turnover | number | |
data.snapshot_list[].pre_change_val | number | |
data.snapshot_list[].pre_change_rate | number | |
data.snapshot_list[].pre_amplitude | number | |
data.snapshot_list[].after_price | number | |
data.snapshot_list[].after_high_price | number | |
data.snapshot_list[].after_low_price | number | |
data.snapshot_list[].after_volume | int | |
data.snapshot_list[].after_turnover | number | |
data.snapshot_list[].after_change_val | number | |
data.snapshot_list[].after_change_rate | number | |
data.snapshot_list[].after_amplitude | number | |
data.snapshot_list[].overnight_price | number | |
data.snapshot_list[].overnight_high_price | number | |
data.snapshot_list[].overnight_low_price | number | |
data.snapshot_list[].overnight_volume | int | |
data.snapshot_list[].overnight_turnover | number | |
data.snapshot_list[].overnight_change_val | number | |
data.snapshot_list[].overnight_change_rate | number | |
data.snapshot_list[].overnight_amplitude | number | |
pagination | object | 部分接口返回分页信息 |
品类标志位(用于调用方按位筛取专属字段)
| 字段 | 类型 | 说明 |
|---|---|---|
| equity_valid | bool | 是否正股;为 true 时财务字段才有意义。 |
| index_valid | bool | 是否指数。 |
| plate_valid | bool | 是否板块。 |
| wrt_valid | bool | 是否窝轮 / 牛熊证 / 界内证。 |
| trust_valid | bool | 是否信托 / 基金 / REIT。 |
| option_valid | bool | 是否期权。 |
| future_valid | bool | 是否期货。 |
正股字段(equity_valid=true 时有意义;其它品类为 0)
| 字段 | 类型 | 说明 |
|---|---|---|
| issued_shares | int64 | 总股本(股)。 |
| total_market_val | double | 总市值(货币单位)。 |
| outstanding_shares | int64 | 流通股本(股)。 |
| circular_market_val | double | 流通市值(货币单位)。 |
| pe_ratio | double | 静态 PE。 |
| pe_ttm_ratio | double | 滚动 PE(TTM)。 |
| pb_ratio | double | 市净率。 |
| dividend_ttm | double | TTM 股息(每股)。 |
| dividend_ratio_ttm | double | TTM 股息率(百分比)。 |
| dividend_lfy | double | 上一财年股息(每股)。 |
| dividend_lfy_ratio | double | 上一财年股息率(百分比)。 |
| net_asset | double | 净资产。 |
| net_asset_per_share | double | 每股净资产。 |
| net_profit | double | 净利润(上一财年)。 |
| ey_ratio | double | 收益率(EY,百分比)。 |
| earning_per_share | double | 每股收益(EPS,上一财年)。 |
指数字段(index_valid=true)
| 字段 | 类型 | 说明 |
|---|---|---|
| index_raise_count | int64 | 成分股上涨家数。 |
| index_fall_count | int64 | 成分股下跌家数。 |
| index_equal_count | int64 | 成分股平盘家数。 |
窝轮 / 牛熊证 / 界内证(wrt_valid=true)
| 字段 | 类型 | 说明 |
|---|---|---|
| wrt_maturity_date | int64 | 到期日(秒级时间戳)。 |
| wrt_end_trade | int64 | 最后交易日(秒级时间戳)。 |
信托 / 基金 / REIT(trust_valid=true)
| 字段 | 类型 | 说明 |
|---|---|---|
| trust_aum | double | 资产管理规模(AUM)。 |
| trust_dividend_yield | double | 股息率(百分比)。 |
| trust_outstanding_units | int64 | 流通单位数。 |
| trust_netAssetValue | double | 单位净值(NAV)。 |
| trust_premium | double | 溢价(百分比)。 |
| trust_assetClass | string | 资产类别,详见下方 trust_assetClass 枚举表 |
枚举 trust_assetClass(信托 / 基金 / REIT 资产类别)
| 取值 | 含义 |
|---|---|
| STOCK | 股票 |
| BOND | 债券 |
| COMMODITY | 商品 |
| CURRENCY_MARKET | 货币市场 |
| FUTURE | 期货 |
| SWAP | 互换 |
期权(option_valid=true)
| 字段 | 类型 | 说明 |
|---|---|---|
| option_strike_price | double | 行权价。 |
| option_contract_size | int64 | 合约规模。 |
| option_open_interest | int64 | 未平仓量。 |
| option_implied_volatility | double | 隐含波动率(百分比)。 |
| delta | double | Δ。 |
| gamma | double | Γ。 |
| vega | double | ν。 |
| theta | double | Θ。 |
| rho | double | ρ。 |
| option_net_open_interest | int64 | 净未平仓。 |
| option_contract_nominal_value | double | 合约名义价值。 |
| option_owner_lot_multiplier | double | 正股每手乘数。 |
| option_type | string | 期权方向,详见枚举对照表 option_type |
| option_contract_multiplier | int64 | 合约乘数。 |
| index_option_type | int32 | 指数期权类型。 |
| option_expiry_date_distance | int64 | 距到期日天数(已过期为负数)。 |
| option_area_type | string | 期权行权类型,详见枚举对照表 option_area_type |
期货(future_valid=true)
| 字段 | 类型 | 说明 |
|---|---|---|
| future_last_settle_price | double | 上一结算价。 |
| future_position | int64 | 持仓。 |
| future_position_change | int64 | 持仓变化。 |
时段字段(盘前 / 盘后 / 夜盘;非该时段为 0)
| 字段 | 类型 | 说明 |
|---|---|---|
| pre_price / pre_high_price / pre_low_price | double | 盘前价 / 高 / 低。 |
| pre_volume / pre_turnover | int64 / double | 盘前成交量 / 额。 |
| pre_change_val / pre_change_rate | double | 盘前涨跌额 / 涨跌幅(百分比)。 |
| pre_amplitude | double | 盘前振幅(百分比)。 |
| after_price / after_high_price / after_low_price | double | 盘后价 / 高 / 低。 |
| after_volume / after_turnover | int64 / double | 盘后成交量 / 额(SH 科创板自动并入 kcb 段)。 |
| after_change_val / after_change_rate | double | 盘后涨跌额 / 涨跌幅(百分比)。 |
| after_amplitude | double | 盘后振幅(百分比)。 |
| overnight_price / overnight_high_price / overnight_low_price | double | 夜盘价 / 高 / 低。 |
| overnight_volume / overnight_turnover | int64 / double | 夜盘成交量 / 额。 |
| overnight_change_val / overnight_change_rate | double | 夜盘涨跌额 / 涨跌幅(百分比)。 |
| overnight_amplitude | double | 夜盘振幅(百分比)。 |
限制范围
- code 必须使用接口支持且已开通行情权限的市场前缀;下表列出常见市场,其他已注册前缀同样可能受支持,否则返回
invalid_symbol。 - code_list 全部非法 →
invalid_symbol;部分非法 → 仅返回合法部分(对照请求与响应可识别被丢弃的 code)。
常见市场前缀与品类:
| 前缀 | 市场 | 支持品类 |
|---|---|---|
| HK | 香港 | 正股 / 信托 / REIT / 窝轮 / 牛熊证 / 界内证 / 指数 / 板块 / ETF / 期权 |
| US | 美国 | 正股 / ETF / 指数 |
| SH | 上海 | 正股 / ETF / 指数 / 板块 |
| SZ | 深圳 | 正股 / ETF / 指数 / 板块 |
| BJ | 北京 | 正股 / 指数 |
| KR | 韩国 | 正股 / ETF / 指数 |
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功(含部分 code 被识别为非法但仍有合法返回) | 调用方按 data.snapshot_list[].code 与请求 code_list 比对,识别被丢弃的 code |
| -3 | invalid_parameter | 缺 code_list / 元素数为 0 / 元素数 > 400 / 元素非字符串 | 校正请求体后重试 |
| -4 / -6 | internal_error | 服务错误 | 重试;持续失败请联系技术支持 |
| -7 | invalid_symbol | code_list 全部 code 都无法解析(前缀不支持 / 代码不存在) | 检查市场前缀是否在限制范围内;通过 search 接口确认代码合法性 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "",
"data": {
"snapshot_list": [
{
"code": "HK.09988",
"name": "Alibaba-W",
"sc_name": "阿里巴巴-W",
"tc_name": "阿里巴巴-W",
"update_time": 1780382399000,
"data_date": "2026-06-02",
"last_price": 128.7,
"open_price": 129.4,
"high_price": 130.5,
"low_price": 128.0,
"prev_close_price": 129.2,
"close_price_5min": 128.5,
"close_price_15min": 128.2,
"close_price_5day": 126.8,
"close_price_10day": 125.4,
"close_price_20day": 123.1,
"close_price_60day": 118.5,
"close_price_120day": 112.8,
"close_price_250day": 105.6,
"close_price_month": 127.3,
"close_price_year": 106.2,
"close_price_3year": 90.4,
"volume": 30568400,
"turnover": 3947123456.0,
"turnover_rate": 0.16,
"equity_valid": true,
"issued_shares": 19061235690,
"total_market_val": 2453181113703.0,
"pe_ratio": 20.595,
"pe_ttm_ratio": 16.823,
"pb_ratio": 1.853,
"earning_per_share": 6.25,
"listing_date": 1574697600000,
"lot_size": 100,
"sec_status": "NORMAL",
"dark_status": "N/A",
"option_type": "",
"option_area_type": ""
},
{
"code": "BMD.FCPOmain",
"name": "Palm Oil Main",
"sc_name": "棕榈油主连",
"tc_name": "棕櫚油主連",
"update_time": 1780382399000,
"data_date": "2026-06-02",
"last_price": 4521.0,
"future_valid": true,
"future_last_settle_price": 4537.0,
"future_position": 95578,
"future_position_change": 22908,
"sec_status": "NORMAL",
"option_type": "",
"option_area_type": ""
},
{
"code": "HK.TCH260629C390000",
"name": "Tencent 260629 390.00 Call",
"sc_name": "腾讯控股 260629 390.00 购",
"tc_name": "騰訊控股 260629 390.00 購",
"update_time": 1780382399000,
"data_date": "2026-06-02",
"last_price": 13.42,
"option_valid": true,
"option_strike_price": 390.0,
"option_contract_size": 100,
"option_open_interest": 243,
"option_implied_volatility": 33.718,
"delta": 0.612,
"gamma": 0.018,
"vega": 0.421,
"theta": -0.087,
"rho": 0.176,
"option_contract_multiplier": "100",
"option_expiry_date_distance": 26,
"index_option_type": 1,
"option_type": "CALL",
"option_area_type": "AMERICAN",
"sec_status": "NORMAL"
}
]
}
}