基本面
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
获取任意上市公司的利润表、资产负债表和现金流量表。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 必填 | 证券代码,例如 `AAPL.US` |
kind | string | 必填 | 报表类型:`IncomeStatement`(利润表)、`BalanceSheet`(资产负债表)、`CashFlow`(现金流量表)、`All`(全部) |
period | string | 必填 | 报告期:`Annual`(年报)、`SemiAnnual`(中报)、`Q1`/`Q2`/`Q3`/`ThreeQ`(季报)、`QuarterlyFull`(累计季报) |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
list | object | 必填 | 按报表类型分组的数据(key 为报表类型代码,如 `IS`、`BS`、`CF`) |
title | string | 可选 | 指标标题 |
short_title | string | 可选 | 短标题 |
currency | string | 可选 | 货币 |
has_yoy | boolean | 可选 | 是否有同比数据 |
entry | string | 可选 | 条目标识符 |
periods | string[] | 可选 | 可用报告期列表 |
accounts | object[] | 可选 | 财务科目列表, |
field | string | 必填 | 字段标识符 |
percent | boolean | 可选 | 是否为百分比值 |
tip | string | 可选 | 提示说明 |
values | object[] | 可选 | 按报告期的历史数值, |
period | string | 必填 | 报告期标签(如 `FY 2024`) |
year | integer | 可选 | 财政年度 |
fp_end | string | 可选 | 报告期结束时间戳 |
value | string | 可选 | 报告值 |
ratio | string | 可选 | 比率值 |
yoy | string | 可选 | 同比增长率 |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"list": {
"IS": {
"indicators": [
{
"title": "Income Statement",
"short_title": "IS",
"currency": "USD",
"has_yoy": true,
"entry": "IS",
"periods": [
"FY2025",
"FY2024"
],
"accounts": [
{
"field": "EPS",
"name": "Earnings Per Share(USD)",
"percent": false,
"tip": "",
"values": [
{
"period": "FY 2025",
"year": 2025,
"fp_end": "1758945600",
"value": "7.46",
"ratio": "",
"yoy": "0.227"
}
]
}
]
}
]
}
}
}
}错误码
参见错误码文档。