美股拆股记录
公开接口美股 US Stock · 美股拆股记录
查询美股历史拆股（拆股 / 合股）记录，按执行日升序返回。
接口地址
GET /us/stock/splits完整地址：
https://api.databull.cn/us/stock/splits接口说明
查询美股历史拆股（拆股 / 合股）记录，按**执行日** execution_date 升序返回。
每条含 split_from（拆前股数）、split_to（拆后股数）、execution_date（执行日）、ticker。例如 AAPL 2020-08-31 的 split_from=1, split_to=4 表示 1 股拆成 4 股。
start_date / end_date 按**执行日**过滤，留空表示不限。
代码格式非法返回 400；无记录返回 200 + 空数组，并在响应头 X-Empty-Reason: no_data_in_range 标明原因。
结果缓存 1 小时，高频调用请自行控制节奏。
请求参数
参数位置类型必填默认说明
symbol查询string否AAPL美股代码，如 AAPLstart_date查询string否end_date查询string否limit查询integer否50返回条数上限，1~1000；取值 1~1000返回字段
字段类型说明
tickerstring美股代码execution_datestring执行日（YYYY-MM-DD）split_fromnumber拆前股数split_tonumber拆后股数接口示例
cURL
curl "https://api.databull.cn/us/stock/splits?symbol=AAPL&start_date=20250101" \
-H "Authorization: Bearer $DATABULL_API_KEY"Python
import requests
url = "https://api.databull.cn/us/stock/splits"
params = {
"symbol": "AAPL",
"start_date": "20250101",
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(url, params=params, headers=headers, timeout=10)
resp.raise_for_status()
print(resp.json())响应示例
JSON
[
{
"ticker": "AAPL",
"execution_date": "2020-08-31",
"split_from": 1,
"split_to": 4
}
]错误码
状态码触发条件
400证券代码格式非法，或请求的时间范围暂不支持
403该数据当前不可用
502服务暂时不可用，可稍后重试
403当前套餐不包含该市场数据，升级套餐后可用
说明
- `split_from=1, split_to=4` 表示 1 股拆成 4 股；反向（`split_from=4, split_to=1`）即合股。
- `start_date` / `end_date` 按**执行日**过滤，留空表示不限。
- 调整历史持仓做复权时必须把拆股计入，否则价格序列会出现假涨跌。
- 该接口属于「美股」数据域，需付费套餐（专业版及以上）方可调用；免费版仅覆盖 A 股。
Esc