基本面
鉴权
签名方式:每个请求用 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=。 |
仅支持 Longbridge 香港 / 新加坡账户
此方法仅支持 Longbridge 香港 / 新加坡账户,可查询任意标的,包括美股。
按财报期获取经营数据及核心财务指标摘要。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 必填 | 证券代码,例如 `AAPL.US` |
period | string | 可选 | 财报期筛选,如 `q1`、`q2`、`q3`、`q4`、`annual` |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
list | object[] | 可选 | 经营数据报告列表, |
└ id | string | 可选 | 内部报告 ID |
└ report | string | 可选 | 报告期代码(如 `af` = 年报) |
└ title | string | 可选 | 报告标题 |
└ txt | string | 可选 | 管理层讨论文本 |
└ latest | boolean | 可选 | 是否为最新报告 |
└ web_url | string | 可选 | 完整报告页面链接 |
└ keywords | array | 可选 | 关键词。 |
└ financial | object | 可选 | 关键财务指标 |
└ ∟ symbol | string | 可选 | 证券代码 |
└ ∟ name | string | 可选 | 标的名称。 |
└ ∟ region | string | 可选 | 市场地区 |
└ ∟ code | string | 可选 | 股票代码 |
└ ∟ currency | string | 可选 | 报告货币 |
└ ∟ report | string | 可选 | 报告期代码(如 `af` = 年报) |
└ ∟ report_txt | string | 可选 | 报告期标签(如 `FY2024`、`Q1 2024`) |
└ ∟ indicators | object[] | 可选 | 财务指标列表, |
└ ∟ ∟ field_name | string | 可选 | 字段名称(如 `operating_revenue`) |
└ ∟ ∟ indicator_name | string | 可选 | 显示名称 |
└ ∟ ∟ indicator_value | string | 可选 | 格式化数值 |
└ ∟ ∟ yoy | string | 可选 | 同比变化率 |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"list": [
{
"id": "12345",
"report": "af",
"title": "FY2025 Annual Report Summary",
"txt": "Management discussion...",
"latest": true,
"web_url": "https://longbridge.com/wiki/...",
"financial": {
"code": "700",
"currency": "HKD",
"name": "Tencent",
"region": "HK",
"report": "af",
"indicators": [
{
"field_name": "operating_revenue",
"indicator_name": "Revenue",
"indicator_value": "678.6B",
"yoy": "0.0800"
}
]
}
}
]
}
}错误码
参见错误码文档。