DataBull

美股指数历史行情

公开接口

指数行情 Index · 美股指数历史行情

查询美股指数的历史 K 线，支持日线 / 周线 / 月线。index_code 两种写法都接受：清单代码（I:SPX）或等价简称（GSPC）。

接口地址

GET /us/index/history
完整地址：https://api.databull.cn/us/index/history

接口说明

查询美股指数的历史 K 线，支持日线 / 周线 / 月线。

index_code 两种写法都接受：**清单代码**（I:SPX，与 /us/index/list 返回的一致，推荐）或等价的**简称**（GSPC）。带 .INDX 后缀（GSPC.INDX）会被自动剥离。

当前可查的指数：GSPC 标普500、NDX 纳斯达克100、IXIC 纳斯达克综合、DJI 道琼斯工业、NYA 纽交所综合、XAX 美国交易所综合、SP400 标普中盘400、SPXTR 标普500全收益、OEX 标普100、VIX 波动率指数、DJT 道琼斯运输。传入不在此列的代码返回 404 与 empty_reason=index_not_found。

返回体 data.items 为记录数组，每条含 date、open、close、high、low、volume、amount、change_amount、chg_pct、amplitude、period，按日期升序。其中 change_amount / chg_pct / amplitude 由相邻两根 K 线派生，区间内第一根没有昨收参考，三者均为 0。

响应里的 data_scope 标明这份数据的时效性：realtime 为本次按需取数的最新数据，local 为已同步入库的历史数据——此时还会附上 data.coverage（from / to 为这批数据实际覆盖的起止交易日，complete 表示是否盖满了请求区间）。数据通道不可用时会自动返回 local 数据，complete=false 即表示尾部还差一段，稍后重试可拿到更新的数据。

日期不传或留空时默认近 1 年至当日。区间内无数据时 data.items 为空数组，并在响应头 X-Empty-Reason 给出 index_not_found（代码不可用）或 no_data_in_range（代码可用但该区间/该周期无数据）。

请求参数

参数位置类型必填默认说明
index_code查询string否I:SPX指数代码，清单代码（I:SPX）或简称（GSPC），大小写不敏感
start_date查询string否近 1 年起始日期（含），YYYYMMDD 或 YYYY-MM-DD；留空默认近 1 年
end_date查询string否当日结束日期（含），YYYYMMDD 或 YYYY-MM-DD；留空默认当日
period查询string否dK 线周期：d 日线 / w 周线 / m 月线；留空默认 d，非法值回落为 d

返回字段

字段类型说明
codenumber业务状态码，0 表示成功
dataobject查询结果对象
data.indexobject本次命中的指数档案（symbol / quote_symbol / name / category）
data.periodstring本次返回的周期，d 日线 / w 周线 / m 月线
data.countnumber本次返回的记录条数
data.itemsarray行情记录数组，按日期升序
data.items[].datestring交易日期，YYYY-MM-DD
data.items[].open / close / high / lownumber开 / 收 / 高 / 低价
data.items[].volumenumber成交量；VIX 等指数恒为 0（本身无成交量）
data.items[].amountnumber成交额；指数恒为 0（指数没有成交额概念）
data.items[].change_amountnumber涨跌额，由相邻两根 K 线派生
data.items[].chg_pctnumber涨跌幅（%），由相邻两根 K 线派生
data.items[].amplitudenumber振幅（%），由相邻两根 K 线派生
data.items[].periodstring本条记录的周期
data.data_scopestring数据范围：local 已同步入库的历史数据 / realtime 本次按需取数
data.coverageobject仅 data_scope=local 时出现：这批数据的实际覆盖范围
data.coverage.from / data.coverage.tostring该批数据实际覆盖的首 / 末交易日（YYYY-MM-DD）
data.coverage.completeboolean是否已盖满请求区间；false 表示尾部还差一段，稍后重试可拿到更新的数据
empty_reasonstring仅当 items 为空时出现，标注为空的原因（见下）

接口示例

cURL
curl "https://api.databull.cn/us/index/history?index_code=I:SPX&start_date=20250101" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_us_index_history(index_code="I:SPX", period="d")
print(result)

响应示例

JSON
{
  "code": 0,
  "data": {
    "index": {
      "symbol": "I:SPX",
      "quote_symbol": "GSPC",
      "name": "标普500",
      "category": "broad"
    },
    "period": "d",
    "count": 2,
    "items": [
      {
        "date": "2026-09-30",
        "open": 7688.99,
        "close": 7651.5398,
        "high": 7722.88,
        "low": 7651.5398,
        "volume": 4276559789.0,
        "amount": 0.0,
        "change_amount": -19.3002,
        "chg_pct": -0.2516,
        "amplitude": 0.93,
        "period": "d"
      },
      {
        "date": "2026-10-01",
        "open": 7666.47,
        "close": 7666.4527,
        "high": 7684.75,
        "low": 7616.78,
        "volume": 5783800353.0,
        "amount": 0.0,
        "change_amount": 14.9129,
        "chg_pct": 0.1949,
        "amplitude": 0.8883,
        "period": "d"
      }
    ],
    "data_scope": "realtime"
  }
}

错误码

状态码触发条件
401缺少或无效 API 凭证
403该数据当前不可用
404指数代码不可用，或区间内无数据
502服务暂时不可用，请稍后重试
403当前套餐不包含该市场数据，升级套餐后可用

说明

  • 响应为 {"code": 0, "data": {...}} 信封结构，与 A 股指数历史行情一致。
  • 当前可查的指数：GSPC 标普500、NDX 纳斯达克100、IXIC 纳斯达克综合、DJI 道琼斯工业、NYA 纽交所综合、XAX 美国交易所综合、SP400 标普中盘400、SPXTR 标普500全收益、OEX 标普100、VIX 波动率指数、DJT 道琼斯运输。传入不在此列的代码返回 404。
  • change_amount / chg_pct / amplitude 由相邻两根 K 线派生，因此查询区间内第一根没有昨收参考，三者均为 0。想拿到区间首日的真实涨跌幅，把 start_date 往前多留一个交易日即可。
  • 指数没有成交额与换手率概念，amount 恒为 0；VIX 本身无成交量，volume 恒为 0。
  • 日期不传或留空时默认近 1 年至当日。YYYYMMDD 与 YYYY-MM-DD 两种写法都接受。
  • data_scope 与 data.coverage 说明这份数据的来源与覆盖范围：realtime 为本次取到的最新数据，不带 coverage；local 为已同步入库的历史数据，此时 coverage.from / coverage.to 给出实际覆盖的首末交易日，coverage.complete=false 表示请求区间尾部还差一段（例如数据只同步到上一交易日）。数据通道暂时不可用时接口会自动返回 local 数据，不会直接报错——complete=false 时稍后重试即可拿到更新的数据。
  • 区间内无数据时 data.items 为空数组，响应头 X-Empty-Reason 给出原因：index_not_found（代码不在可查列表，见「美股指数列表」的 quote_ready 字段）或 no_data_in_range（代码可用但该区间 / 该周期无数据）。
  • 该接口属于「美股」数据域，需付费套餐（专业版及以上）方可调用；免费版仅覆盖 A 股。