美股分红记录
公开接口美股 US Stock · 美股分红记录
查询美股历史分红（股息）记录，按除息日升序返回。
接口地址
GET /us/stock/dividends完整地址：
https://api.databull.cn/us/stock/dividends接口说明
查询美股历史分红（股息）记录，按**除息日**ex_dividend_date 升序返回。
每条含 cash_amount（每股派息金额）、ex_dividend_date（除息日）、pay_date（派息日）、record_date（登记日）、declaration_date（宣告日）、dividend_type（CD 现金分红 / SC 股票分红）、frequency（年派息次数）、currency（币种）。
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美股代码cash_amountnumber每股派息金额currencystring币种，如 USDex_dividend_datestring除息日（YYYY-MM-DD）——计算股息率与持有浮盈时用这个日期record_datestring登记日pay_datestring派息日declaration_datestring宣告日dividend_typestring分红类型：CD 现金分红 / SC 股票分红frequencyinteger年派息次数，0 表示无固定频次接口示例
cURL
curl "https://api.databull.cn/us/stock/dividends?symbol=AAPL&start_date=20250101" \
-H "Authorization: Bearer $DATABULL_API_KEY"Python
import requests
url = "https://api.databull.cn/us/stock/dividends"
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",
"cash_amount": 0.27,
"currency": "USD",
"ex_dividend_date": "2026-08-10",
"record_date": "2026-08-11",
"pay_date": "2026-08-13",
"declaration_date": "2026-07-30",
"dividend_type": "CD",
"frequency": 4
}
]错误码
状态码触发条件
400证券代码格式非法，或请求的时间范围暂不支持
403该数据当前不可用
502服务暂时不可用，可稍后重试
403当前套餐不包含该市场数据，升级套餐后可用
说明
- `start_date` / `end_date` 按**除息日**过滤，留空表示不限；支持 `YYYYMMDD` 与 `YYYY-MM-DD` 两种写法。
- 响应为 `{"code": 0, "data": [...]}`；无记录时返回空数组，并在响应头 `X-Empty-Reason: no_data_in_range` 标明原因。
- 本接口结果缓存 1 小时；高频调用请自行控制节奏。
- 该接口属于「美股」数据域，需付费套餐（专业版及以上）方可调用；免费版仅覆盖 A 股。
Esc