财务数据
获取最新或指定报告期的财务快照
接口说明
最新或指定报告期的财务快照,约 400 个字段:EPS、ROE、BPS 及三表科目,单次返回单票单报告期。
基本面筛选、财务因子构建用它
字段多,建议先调一次看返回的 fields 字典再按需取列
快速调用
同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。
最新一期财务
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
fin = pro.financial(code="sz000001") # → 一行宽表(约400字段)
eps = fin["EPS"].iloc[0] # 字段名大小写敏感
最新一期财务
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/financial",
headers={"X-API-Key": KEY},
params={"code": "sz000001"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["fields"]
最新一期财务
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/financial?code=sz000001"
输入参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| code | str | True | 证券代码 |
| report_date | str | False | 报告期 YYYY-MM-DD, 缺省最新一期 |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| code | str | 证券代码 |
| fields | dict | 稀疏字典: 英文字段名→值(如 EPS/ROE/BPS/ipo_date); 未披露字段缺失 |
返回数据样例
{
"code": "sz000001",
"fields": {
"EPS": 1.24,
"deductEPS": 1.24,
"undistributedProfitPerShare": 14.8334,
"netAssetsPerShare": 24.13,
"capitalReservePerShare": 4.1445,
"ROE": 4.687,
"operatingCashFlowPerShare": 11.08,
"moneyFunds": 354877014016.0,
"tradingFinancialAssets": 821274017792.0,
"investmentRealEstate": 552000000.0,
"fixedAssets": 10464000000.0,
"intangibleAssets": 5415000064.0,
"goodwill": 7568000000.0,
"deferredIncomeTaxAssets": 50064998400.0,
"totalAssets": 6028785090560.0
}
}
样例取自平台实时数据,财务字段共 221 个,样例仅展示前 15 个。
最佳实践:字段名大小写敏感: 先不传 fields 看全部列名再挑; fields 写错的列不会丢——挂 df.attrs["dropped_fields"] 提示。