Google Finance 行报价实时高级接口

POST /v3/serp/google/finance_quote/live/advanced

本接口使用 POST /v3/serp/google/finance_quote/live/advanced，实时获取 Google Finance「报价」页中的数据。返回结果由请求中的股票或金融产品代码、地区和语言决定。

请求数据使用 UTF-8 编码的 JSON 格式，并将任务对象放 JSON 数组中。每次请求最多提交 1 个任务；平台限流以认证说明中的 30/60/120 次/分钟规则为准。

计费说明

每个任务单独计费。window 参数不是 1D 时，单任务费用将按 2 倍计算。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

核心参数

参数	类型	填	说明
`keyword`	string	是	股票代码、金融产品代码或交易品种代码。例如 `CLW00:NYMEX`。最多 700 个字符。请求中的 URL 编码会被解码，`+` 会被解码为空格。若中需要使用 `%`，请传 `%25`；需要使用 `+`，请传 `%2B`。
`location_code`	integer	条件填	搜索引擎地区代码。未指定 `location_name` 时提供。提供此参数后无需再提供 `location_name`。可通过 `/v3/serp/google/locations` 获取可用地区及代码。例如：`2840`。
`language_code`	string	条件填	搜索引擎语言代码。未指定 `language_name` 时提供。提供此参数后无需再提供 `language_name`。可通过 `/v3/serp/google/languages` 获取可用语言及代码。例如：`en`。
`device`	string	否	设备类型。可选值：`desktop`。

location_code 与 location_name 二选一；language_code 与 language_name 二选一。

附加参数

参数	类型	填	说明
`location_name`	string	条件填	搜索引擎地区名。未指定 `location_code` 时提供。示例：`London,England,United Kingdom`。
`language_name`	string	条件填	搜索引擎语言名。未指定 `language_code` 时提供。示例：`English`。
`os`	string	否	设备操作系统。可选值：`windows`。
`tag`	string	否	用户自定义任务标识，最长 255 个字符。可用于请求与结果，返回时会保留在响应的 `data` 对象中。
`window`	string	否	Google Finance 行图表的时间窗口。可选值：`1D`、`5D`、`1M`、`6M`、`YTD`、`1Y`、`5Y`、`MAX`。默认值：`1D`。除 `1D` 外的取值会使该任务按 2 倍计费。

请求示例

cURL

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/serp/google/finance_quote/live/advanced" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "keyword": "CLW00:NYMEX",
      "location_code": 2840,
      "language_name": "English",
      "device": "desktop",
      "window": "1D"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/serp/google/finance_quote/live/advanced"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

# 每次请求只能提交一个任务
payload = [
    {
        "keyword": "CLW00:NYMEX",
        "location_code": 2840,
        "language_name": "English",
        "device": "desktop",
        "window": "1D",
    }
]

response = requests.post(url, headers=headers, json=payload, timeout=60)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，状态码：%s，消息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

typescript

import axios from "axios";

const response = await axios.post(
  "https://api.seermartech.cn/v3/serp/google/finance_quote/live/advanced",
  [
    {
      keyword: "CLW00:NYMEX",
      location_code: 2840,
      language_name: "English",
      device: "desktop",
      window: "1D",
    },
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

console.log(response.data);

响应结构

接口返回 JSON 对象 tasks 为任务结果数组。

顶层字段

字段	类型	说明
`version`	string	当前接口版本。
`status_code`	integer	请求级状态码。成功通常为 `20000`。
`status_message`	string	请求级状态说明。
`time`	string	请求执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务总数。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数。
`tasks`	array	任务结果数组。

任务字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，通常处于 `10000` 至 `60000` 范围。
`status_message`	string	任务状态说明。
`time`	string	任务执行耗时。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的数量。
`path`	array	请求路径信息。
`data`	object	创建任务时提交的参数。
`result`	array	搜索结果数组。

`result` 结果字段

字段	类型	说明
`keyword`	string	请求中的。返回值中的 URL 编码会被解码，`+` 会被转换为空格。
`type`	string	搜索类型。本接口固定为 `finance_quote`。
`se_domain`	string	请求使用的搜索引擎域名。
`location_code`	string	地区代码。
`language_code`	string	语言代码。
`check_url`	string	对应的搜索结果页面 URL，可用于核验返回结果。
`datetime`	string	接收结果的时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`spell`	object	搜索引擎自动纠错信息。未发生纠错时通常为空。
`refinement_chips`	object	搜索筛选项。本接口通常为 `null`。
`item_types`	array	结果项类型列表。
`se_results_count`	integer	搜索结果总数。
`items_count`	integer	`items` 数组中的结果数量。
`items`	array	搜索结果项数组。

item_types 可能以下值：

google_finance_hero_groups
google_finance_quote
google_finance_compare_to
google_finance_news
google_finance_financial
google_finance_futures_chain
google_finance_details
google_finance_about
google_finance_interested
google_finance_people_also_search

结果项通用字段

大多数 items素以下字段：

字段	类型	说明
`type`	string	结果项类型。
`rank_group`	integer	同类型结果项中的组排名。不同类型不会计该排名。
`rank_absolute`	integer	所有结果项中的绝对排名。

金融市场数据结构

以下对象会在多个结果项中重复出现 google_finance_hero_groups、google_finance_quote、google_finance_compare_to、google_finance_interested 和 google_finance_people_also_search。

`google_finance_market_index_element`

字段	类型	说明
`type`	string	固定为 `google_finance_market_index_element`。
`ticker`	string	市场指数代码，例如 `DAX`。
`market_identifier`	string	市场标识，例如 `INDEXDB`。
`index_value`	float	指定时间点的指数值。
`index_value_delta`	float	指数值变化量。
`identifier`	string	由 `ticker` 和 `market_identifier` 组成的完整标识，例如 `PX1:INDEXDB`。
`displayed_name`	string	页面展示的指数名称，例如 `CAC 40`。
`url`	string	指向该指数页的 URL。
`location`	string	指数所在地区，例如 `Europe/Paris`。
`trend`	string	价格趋势：`up`、`down` 或 `stable`。
`timestamp`	string	数值读取时间，UTC 格式。
`percentage_delta`	float	指数变化百分比。

`google_finance_market_instrument_element`

字段	类型	说明
`type`	string	固定为 `google_finance_market_instrument_element`。
`ticker`	string	金融代码，例如 `YMW00`。
`price`	float	指定时间点的价格。
`price_delta`	float	价格变化量。
`price_currency`	string	价格币种，例如 `USD`。
`identifier`	string	金融完整标识，例如 `YMW00:CBOT`。
`displayed_name`	string	页面展示名称，例如 `E-mini Dow ($5)`。
`url`	string	金融页 URL。
`location`	string	所在地区。
`trend`	string	价格趋势：`up`、`down` 或 `stable`。
`timestamp`	string	价格读取时间，UTC 格式。
`percentage_delta`	float	价格变化百分比。

`google_finance_asset_pair_element`

字段	类型	说明
`type`	string	固定为 `google_finance_asset_pair_element`。
`base_symbol`	string	基础资产代码，例如 `EUR`。
`quote_symbol`	string	计价资产代码，例如 `USD`。
`base_display_name`	string	基础资产名称，例如 `Euro`。
`quote_display_name`	string	计价资产名称。
`price`	float	基础资产相对于计价资产的价格。
`price_delta`	float	价格变化量。
`identifier`	string	资产对标识，例如 `EUR-USD`。
`displayed_name`	string	页面展示名称，例如 `EUR / USD`。
`url`	string	资产对页 URL。
`location`	string	所在地区。
`trend`	string	价格趋势：`up`、`down` 或 `stable`。
`timestamp`	string	价格读取时间，UTC 格式。
`percentage_delta`	float	价格变化百分比。

主要结果项

`google_finance_hero_groups`

表示金融市场概览数据。

字段	类型	说明
`type`	string	固定为 `google_finance_hero_groups`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`markets`	array	市场数据数组。

markets 中的每个：

字段	类型	说明
`market`	string	市场类别：`US`、`Europe`、`Asia`、`Currencies`、`Crypto` 或 `Futures`。
`items`	array	市场指数、金融或资产对数据。

items[].type 可能为：

google_finance_asset_pair_element
google_finance_market_instrument_element
google_finance_market_index_element

字段参见金融市场数据结构。

`google_finance_quote`

表示请求标的的核心报价信息。

字段	类型	说明
`type`	string	固定为 `google_finance_quote`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`quote`	object	报价对象，通常为市场指数或金融对象。
`graph_items`	array	行图表数据点。

quote 的结构取决于标的类型，可能为 google_finance_market_index_element、google_finance_market_instrument_element 或 google_finance_asset_pair_element。

graph_items 字段：

字段	类型	说明
`timestamp`	string	图表数据点的时间，UTC 格式。
`value`	float	图表数据点的价格或指数值。
`volume`	float	图表数据点对应的成交量。

`google_finance_compare_to`

表示与当前标的进行趋势对比的市场数据。

字段	类型	说明
`type`	string	固定为 `google_finance_compare_to`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`items`	array	参与对比的市场指数、金融或资产对。

`google_finance_news`

表示与当前金融标的的新闻。

字段	类型	说明
`type`	string	固定为 `google_finance_news`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`title`	string	新闻模块标题，例如 `Top news`。
`sub_title`	string	新闻模块副标题。
`items`	array	新闻文章数组。

新闻文章字段：

字段	类型	说明
`type`	string	固定为 `google_finance_news_element`。
`title`	string	新闻标题。
`url`	string	新闻文章 URL。
`source`	string	新闻来源网站名称。
`image_url`	string	新闻文章主图 URL。
`timestamp`	string	新闻时间，UTC 格式。
`quotes`	array	新闻中引用的市场指数、金融或资产对。

`google_finance_financial`

表示企业或金融标的的财务指标。

字段	类型	说明
`type`	string	固定为 `google_finance_financial`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`quarterly_metrics`	array	季度财务指标。
`annual_metrics`	array	年度财务指标。

quarterly_metrics 和 annual_metrics 中的每个均为 google_finance_financial_element，字段如下：

字段	类型	说明
`type`	string	固定为 `google_finance_financial_element`。
`timestamp`	string	指标时间，UTC 格式。
`revenue` / `revenue_delta`	float	营收及变化量。
`operating_expense` / `operating_expense_delta`	float	营业费用及变化量。
`net_income` / `net_income_delta`	float	净利润及变化量。
`net_profit_margin` / `net_profit_margin_delta`	float	净利率及变化量。
`earnings_per_share` / `earnings_per_share_delta`	float	每股收益及变化量。
`ebitda` / `ebitda_delta`	float	EBITDA 及变化量。
`effective_tax_rate`	float	有效税率。
`cash_and_short_term_investments` / `cash_and_short_term_investments_delta`	float	现金及短期投资及变化量。
`total_assets` / `total_assets_delta`	float	总资产及变化量。
`total_liabilities` / `total_liabilities_delta`	float	总负债及变化量。
`total_equity`	float	总股东权益。
`shares_outstanding`	float	流通股数量。
`price_to_book`	float	市净率。
`return_on_assets`	float	资产回报率。
`return_on_capital`	float	资本回报率。
`cash_from_operations` / `cash_from_operations_delta`	float	经营活动现金流及变化量。
`cash_from_investing` / `cash_from_investing_delta`	float	投资活动现金流及变化量。
`cash_from_financing` / `cash_from_financing_delta`	float	融资活动现金流及变化量。
`net_change_in_cash` / `net_change_in_cash_delta`	float	现金净变化额及变化量。
`free_cash_flow` / `free_cash_flow_delta`	float	自由现金流及变化量。

`google_finance_futures_chain`

表示期货合约链数据。

字段	类型	说明
`type`	string	固定为 `google_finance_futures_chain`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`markets`	array	期货市场数据。

期货字段：

字段	类型	说明
`type`	string	固定为 `google_finance_futures_chain_element`。
`expiration_timestamp`	string	到期时间，UTC 格式。
`symbol`	string	期货合约代码。
`price`	float	期货价格。
`price_currency`	string	价格币种。
`price_delta`	float	价格变化量。
`percentage_delta`	float	价格变化百分比。
`trend`	string	价格趋势：`up`、`down` 或 `stable`。

`google_finance_details`

表示当前标的的详细和估值信息。

字段	类型	说明
`type`	string	固定为 `google_finance_details`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`badges`	array	标签，例如 `Futures Contract`。
`previous_close`	float	前一交易日收盘价。
`start_day_range` / `end_day_range`	float	当日价格区间起点和终点。
`start_year_range` / `end_year_range`	float	年度价格区间起点和终点。
`market_cap`	float	市值。
`volume`	float	总成交量。
`avg_volume`	float	平均成交量。
`pe_ratio`	float	市盈率。
`dividend_yield`	float	股息率。
`primary_exchange`	string	主要交易所。
`ytd_return`	float	年初至今收益率。
`expense_ratio`	float	费用率。
`category`	string	分类名称。
`net_asset` / `net_assets`	float	净资产值。不同返回版本可能使用一个字段名。
`yield`	float	收益率。
`front_load`	float	前端申购费。
`market_segment`	string	市场板块。
`open_interest`	float	未平仓合约数量。
`settlement_price`	float	结算价。
`cdp_climate_change_score`	string	按碳信息披露项目方法计算的气候变化评分。
`metrics_currency`	string	指标币种。

`google_finance_about`

表示企业或发行方的基本信息。

字段	类型	说明
`type`	string	固定为 `google_finance_about`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`displayed_name`	string	页面展示的名称。
`description`	string	简介。
`description_source_url`	string	简介来源 URL。
`ceo`	string	首席执行官。
`founded`	string	成立日期，格式为 `yyyy-mm-ddThh-mm-ssZ`。
`headquarters`	string	总部所在地。
`website`	string	官网。
`employees`	integer	员工数量。

`google_finance_interested`

表示根据近期搜索、证券及活动生成的市场标的列表。

字段	类型	说明
`type`	string	固定为 `google_finance_interested`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`items`	array	市场指数、金融或资产对。

`google_finance_people_also_search`

表示用户可能感的金融标的。

字段	类型	说明
`type`	string	固定为 `google_finance_people_also_search`。
`rank_group`	integer	组排名。
`rank_absolute`	integer	绝对排名。
`items`	array	市场指数、金融或资产对。

响应示例

以下为型期货报价响应的结构示例，部分数组已省略：

json

{
  "version": "0.1.20241227",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "3.1191 sec.",
  "cost": 0.002,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "3.1191 sec.",
      "cost": 0.002,
      "result_count": 1,
      "data": {
        "api": "serp",
        "function": "live",
        "se": "google",
        "se_type": "finance_quote",
        "language_name": "English",
        "location_code": 2840,
        "keyword": "CLW00:NYMEX",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "CLW00:NYMEX",
          "type": "finance_quote",
          "location_code": "2840",
          "language_code": "en",
          "datetime": "2025-02-13 13:58:12 +00:00",
          "se_results_count": 0,
          "items_count": 11,
          "items": [
            {
              "type": "google_finance_quote",
              "rank_group": 1,
              "rank_absolute": 2,
              "quote": {
                "type": "google_finance_market_instrument_element",
                "ticker": "CLW00",
                "price": 70.33000183105469,
                "price_delta": -0.90999603,
                "price_currency": "USD",
                "identifier": "CLW00:NYMEX",
                "displayed_name": "Crude Oil",
                "url": "https://google.com/finance/quote/CLW00:NYMEX?hl=en&gl=us",
                "location": null,
                "trend": "down",
                "timestamp": "2025-02-13 13:58:12 +00:00",
                "percentage_delta": -1.2773668
              },
              "graph_items": []
            },
            {
              "type": "google_finance_news",
              "rank_group": 1,
              "rank_absolute": 4,
              "title": "Top news",
              "sub_title": null,
              "items": []
            },
            {
              "type": "google_finance_details",
              "rank_group": 1,
              "rank_absolute": 8,
              "badges": ["Futures Contract"],
              "previous_close": 71.24,
              "start_day_range": 70.16,
              "end_day_range": 71.18,
              "start_year_range": 70.16,
              "end_year_range": 71.18,
              "market_cap": null,
              "volume": 72805,
              "avg_volume": null,
              "pe_ratio": null,
              "dividend_yield": null,
              "primary_exchange": "NYMEX",
              "ytd_return": null,
              "expense_ratio": null,
              "net_assets": null,
              "yield": null,
              "front_load": null,
              "market_segment": "ENRGY",
              "open_interest": 256985,
              "settlement_price": 71.24,
              "cdp_climate_change_score": null,
              "metrics_currency": "USD"
            },
            {
              "type": "google_finance_about",
              "rank_group": 1,
              "rank_absolute": 9,
              "displayed_name": "NYMEX:CLW00",
              "description": null,
              "description_source_url": null,
              "ceo": null,
              "founded": null,
              "headquarters": null,
              "website": null,
              "employees": null
            }
          ]
        }
      ]
    }
  ]
}

错误处理

请根据顶层和任务级别的 status_code、status_message 判断请求是否成功。建议对以下进行处理：

HTTP 请求失败；
顶层 status_code 非 20000；
tasks_error 大于 0；
单个任务的 status_code 非成功状态；
result 为空或数据缺失；
响应中的字段值为 null。

完整错误码可参考错误码说明。

实用场景

监控股票、指数和期货实时，及时发现价格异动并触发投资研究或运营预警。
采集指定标的的历史图表点位，分析短期、年度及长期价格趋势，为市场报告提供数据支持。
对比市场指数与资产对，识别行业、地区、货币或大宗商品之间的联动。
汇总金融与引用标的，跟踪影响股票、期货和指数价格的新闻事件。
提取企业季度及年度财务指标，支持竞品研究、投资筛选和企业财务趋势分析。

Google Finance 行报价实时高级接口 ​

计费说明 ​

请求参数 ​

核心参数 ​

附加参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

任务字段 ​

result 结果字段 ​

结果项通用字段 ​

金融市场数据结构 ​

google_finance_market_index_element ​

google_finance_market_instrument_element ​

google_finance_asset_pair_element ​

主要结果项 ​

google_finance_hero_groups ​

google_finance_quote ​

google_finance_compare_to ​

google_finance_news ​

google_finance_financial ​

google_finance_futures_chain ​

google_finance_details ​

google_finance_about ​

google_finance_interested ​

google_finance_people_also_search ​

响应示例 ​

错误处理 ​