S SPARKDATA
EN
菜单
← 返回数据列表

美股

美股区间行情

USStockRangeQuotation
免费JSON支持在线试运行

接口试运行

美股区间行情

USStockRangeQuotation
管理 API Key

正在读取账户…

示例已填好，选择 API Key 后即可运行。

使用账户的现有权限与额度。字段说明独立展示，复制出的 JSON 可直接调用。

  • stockObject: 苹果 · AAPL.N
  • 样例使用已核验的标的和字典值；返回记录取决于查询范围、数据更新及当前 Key 权限。
  • 默认请求 5 条；部分业务聚合可能返回更多记录，以实际响应为准。
示例字段说明 5
stockObject股票代码 · 必填
股票的唯一标识代码，用于区分不同上市公司可填写准确名称或字典代码。 苹果 (7006136)
beginDate开始日期
区间行情的开始日期，日期格式为：YYYY-MM-DD日期格式为 YYYY-MM-DD；数组类型请用 JSON 数组。
endDate结束日期
区间行情的结束日期，日期格式为：YYYY-MM-DD日期格式为 YYYY-MM-DD；数组类型请用 JSON 数组。
pageNo页面编号
定位分页查询的目标页码，默认值为1页码从 1 开始；样例读取第一页。
pageSize页内记录数
单页返回的最大记录条数，默认为500样例限制为 5 条，便于快速查看结果。
POST /v1/data/operations/USStockRangeQuotation

curl 调用示例（含字段注释）
# stockObject: 股票代码（必填） — 股票的唯一标识代码，用于区分不同上市公司
# beginDate: 开始日期 — 区间行情的开始日期，日期格式为：YYYY-MM-DD
# endDate: 结束日期 — 区间行情的结束日期，日期格式为：YYYY-MM-DD
# pageNo: 页面编号 — 定位分页查询的目标页码，默认值为1
# pageSize: 页内记录数 — 单页返回的最大记录条数，默认为500
curl --silent --show-error --fail-with-body --request POST \
  'https://spark-data.cn/v1/data/operations/USStockRangeQuotation' \
  --header "Authorization: Bearer ${SPARKDATA_API_KEY:?Set SPARKDATA_API_KEY first}" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data-binary '{"parameters":{"stockObject":["7006136"],"beginDate":"2026-10-14","endDate":"2026-11-13","pageNo":"1","pageSize":"5"}}'

此接口免费开放，使用账户下任一 API Key 即可查询。

数据说明

【API描述】 美股区间行情API用于获取美股市场指定区间的行情表现信息；比如近一周、本周以来、近一月、本月以来、近3月、近半年、去年，近一年、今年以来、上市以来或其他指定区间的行情数据；帮助用户了解区间内个股的市场动态。 该API返回某个或多个A股股票的区间行情信息；涵盖区间前收盘价、区间开盘价、区间最高价、区间最低价、区间收盘价、区间最高收盘价、区间最低收盘价、区间振幅、区间成交均价、区间涨跌、区间涨跌幅、区间换手率、区间成交量、区间成交额、区间成交笔数、区间日均成交量、区间日均成交额、区间日均换手率等市场关键指标。 典型问法：某公司近一月的涨跌幅是多少？某公司近一年的换手率是多少？ 【API使用场景】 1、用户需要获取某个或多个美股股票的市场区间行情信息； 2、查询个股区间内的行情走势和波动情况；如去年走势，上周走势， 3、投资分析和研究；提供选定区间内的行情数据支持。

POST /v1/data/operations/USStockRangeQuotation · JSON

输入参数

字段类型约束说明与示例
stockObject
股票代码		文本列表
string_array		必填
按字典选择: STOCK_COMPANY_US		股票的唯一标识代码，用于区分不同上市公司

示例: ["7006136"]

beginDate
开始日期		日期（年-月-日）
date		可选区间行情的开始日期，日期格式为：YYYY-MM-DD

示例: 2026-10-14

endDate
结束日期		日期（年-月-日）
date		可选区间行情的结束日期，日期格式为：YYYY-MM-DD

示例: 2026-11-13

pageNo
页面编号		文本
string		可选定位分页查询的目标页码，默认值为1

示例: 1

pageSize
页内记录数		文本
string		可选单页返回的最大记录条数，默认为500

示例: 5

返回字段

字段类型约束说明与示例
stockobject
股票内码		文本
string		—股票内码

示例: 示例文本

stockcode
股票代码		文本
string		—股票代码

示例: 示例文本

stockabbr
股票简称		文本
string		—股票简称

示例: 示例文本

begindate
区间开始日期		日期（年-月-日）
date		—行情区间开始日期，格式“YYYY-MM-DD”

示例: 2026-09-30

enddate
区间截止日期		日期（年-月-日）
date		—行情区间结束日期，格式“YYYY-MM-DD”

示例: 2026-09-30

tradedays
区间交易日天数(天)		数字
number		—行情区间内，美股的交易日天数

示例: 1

prevclosepricebt
区间前收盘价(元)		数字
number		—行情区间内，美股前收盘价

示例: 1

openpricebt
区间开盘价(元)		数字
number		—行情区间内，美股开盘价

示例: 1

highpricebt
区间最高价(元)		数字
number		—行情区间内，美股最高价

示例: 1

lowpricebt
区间最低价(元)		数字
number		—行情区间内，美股最低价

示例: 1

closepricebt
区间收盘价(元)		数字
number		—行情区间内，美股收盘价

示例: 1

hightclosepricebt
区间收盘最高价(元)		数字
number		—行情区间内，美股最高收盘价

示例: 1

lowestclosepricebt
区间收盘最低价(元)		数字
number		—行情区间内，美股最低收盘价

示例: 1

avgpricebt
区间均价(元)		数字
number		—行情区间内，美股成交均价

示例: 1

changeofpricebt
区间涨跌(元)		数字
number		—行情区间内，美股涨跌情况

示例: 1

changepctbt
区间涨跌幅(%)		数字
number		—行情区间内，美股涨跌幅

示例: 1

rangepctbt
区间振幅(%)		数字
number		—行情区间内，美股振幅

示例: 1

turnovervaluebt
区间成交额(万元)		数字
number		—行情区间内，美股成交总额

示例: 1

turnovervalueperdaybt
区间日均成交额(万元)		数字
number		—行情区间内，美股日均成交金额

示例: 1

turnovervolumebt
区间成交量(万股)		数字
number		—行情区间内，美股成交总量

示例: 1

turnovervolumeperdaybt
区间日均成交量(万股)		数字
number		—行情区间内，美股日均成交量

示例: 1

turnoverdealsbt
区间成交笔数(笔)		数字
number		—行情区间内，美股成交总笔数

示例: 1

调用示例

已填入示例标的、必填参数与适用的分页限制。点击试运行，在右侧抽屉查看字段说明并获取真实返回。

{
  "parameters": {
    "stockObject": [
      "7006136"
    ],
    "beginDate": "2026-10-14",
    "endDate": "2026-11-13",
    "pageNo": "1",
    "pageSize": "5"
  }
}
  • stockObject: 苹果 · AAPL.N
  • 样例使用已核验的标的和字典值；返回记录取决于查询范围、数据更新及当前 Key 权限。
  • 默认请求 5 条；部分业务聚合可能返回更多记录，以实际响应为准。

覆盖与使用边界

请先运行示例，确认所需证券、日期范围和字段是否可用。可用历史范围与内容使用许可因接口而异；查询使用账户和所选 API Key 的权限与额度。

分钟周期、复权方式和时间单位请按上方参数说明填写。接口没有返回的数据不代表数值为零。