S SPARKDATA
中文
Menu
← Back to data results

US equities

US Stock Range Quotation

USStockRangeQuotation
FreeJSONTry online

Operation explorer

US Stock Range Quotation

USStockRangeQuotation
Manage API keys

Loading account…

The example is prefilled. Choose an API key and run it.

Uses the account’s current access and allowance. Field notes stay separate so copied JSON remains executable.

  • stockObject: 苹果 · AAPL.N
  • Samples use verified instruments and dictionary values. Records depend on the query range, data updates and the selected key's permissions.
  • The sample requests 5 records; some business aggregates may return more rows, as shown in the actual response.
Example field notes 5
stockObjectstring_array · required
股票的唯一标识代码，用于区分不同上市公司Use an exact name or dictionary code. 苹果 (7006136)
beginDatedate
区间行情的开始日期，日期格式为：YYYY-MM-DDUse YYYY-MM-DD; wrap array values in a JSON array.
endDatedate
区间行情的结束日期，日期格式为：YYYY-MM-DDUse YYYY-MM-DD; wrap array values in a JSON array.
pageNostring
定位分页查询的目标页码，默认值为1Page numbers start at 1; the sample reads the first page.
pageSizestring
单页返回的最大记录条数，默认为500The sample requests 5 records for a quick preview.
POST /v1/data/operations/USStockRangeQuotation

curl example with field notes
# stockObject: string_array (required) — 股票的唯一标识代码，用于区分不同上市公司
# beginDate: date — 区间行情的开始日期，日期格式为：YYYY-MM-DD
# endDate: date — 区间行情的结束日期，日期格式为：YYYY-MM-DD
# pageNo: string — 定位分页查询的目标页码，默认值为1
# pageSize: string — 单页返回的最大记录条数，默认为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-15","endDate":"2026-11-14","pageNo":"1","pageSize":"5"}}'

This API is free. Query it with any API key in your account.

Data description

Use the field names shown below when building requests.

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

POST /v1/data/operations/USStockRangeQuotation · JSON

Input parameters

FieldTypeConstraintDescription and example
stockObject
股票代码		string_array
string_array		Required
Dictionary selection: STOCK_COMPANY_US		股票的唯一标识代码，用于区分不同上市公司

Example: ["7006136"]

beginDate
开始日期		date
date		Optional区间行情的开始日期，日期格式为：YYYY-MM-DD

Example: 2026-10-15

endDate
结束日期		date
date		Optional区间行情的结束日期，日期格式为：YYYY-MM-DD

Example: 2026-11-14

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

Example: 1

pageSize
页内记录数		string
string		Optional单页返回的最大记录条数，默认为500

Example: 5

Response fields

FieldTypeConstraintDescription and example
stockobject
股票内码		string
string		—股票内码

Example: Example text

stockcode
股票代码		string
string		—股票代码

Example: Example text

stockabbr
股票简称		string
string		—股票简称

Example: Example text

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

Example: 2026-09-30

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

Example: 2026-09-30

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

Request example

Example instruments, required parameters and applicable page limits are prefilled. Open the side drawer for field notes and a live response.

{
  "parameters": {
    "stockObject": [
      "7006136"
    ],
    "beginDate": "2026-10-15",
    "endDate": "2026-11-14",
    "pageNo": "1",
    "pageSize": "5"
  }
}
  • stockObject: 苹果 · AAPL.N
  • Samples use verified instruments and dictionary values. Records depend on the query range, data updates and the selected key's permissions.
  • The sample requests 5 records; some business aggregates may return more rows, as shown in the actual response.

Coverage and access boundaries

Run the example to check the securities, dates and fields you need. Available history and content rights vary by endpoint. Requests use your account access and the selected API key.

Follow the parameter notes for minute intervals, price adjustment and time units. A missing field does not mean a zero value.