基本面
鉴权
签名方式:每个请求用 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 business-segments AAPL.US --history
longbridge business-segments AAPL.US --history --report qf
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 必填 | 证券代码,例如 `AAPL.US` |
report | string | 可选 | 报告类型:`qf`(季报)/ `saf`(半年报)/ `af`(年报) |
cate | string | 可选 | 分部类别过滤 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
historical | object[] | 可选 | 历史报告期列表 |
└ total | string | 可选 | 当期总收入 |
└ currency | string | 可选 | 货币代码 |
└ date | string | 可选 | 报告期,格式 YYYYMMDD,例如 `20260331` |
└ report | string | 可选 | 报告期代码(如 `af` = 年报) |
└ report_txt | string | 可选 | 报告期标签(如 `FY2024`、`Q1 2024`) |
└ fp_start | string | 可选 | 财政期开始日期,格式 `YYYY.MM.DD` |
└ fp_end | string | 可选 | 报告期结束时间戳 |
└ rpt_date | string | 可选 | 财报发布日期 |
└ business | object[] | 可选 | 业务分部列表 |
└ ∟ name | string | 可选 | 业务分部名称 |
└ ∟ percent | string | 可选 | 收入占比(百分比,例如 `40.80`) |
└ ∟ value | string | 可选 | 绝对收入数值 |
└ ∟ id | string | 可选 | 新创建提醒的 ID |
└ ∟ yoy | string | 可选 | 同比增长率 |
└ regionals | array | 可选 | 地区分部列表(当前通常为空数组) |
└ bus_ids | array | 可选 | 业务分部 ID 列表。 |
└ reg_ids | array | 可选 | 区域分部 ID 列表。 |
└ yoy | string | 可选 | 同比增长率 |
bus_ids | array | 可选 | 业务分部 ID 列表。 |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"historical": [
{
"date": "20260331",
"total": "124300000000",
"currency": "USD",
"business": [
{
"name": "Americas",
"percent": "40.80",
"value": "31968000000"
},
{
"name": "Europe",
"percent": "23.64",
"value": "18521000000"
},
{
"name": "Greater China",
"percent": "20.72",
"value": "16233000000"
}
],
"regionals": []
}
]
}
}错误码
参见错误码文档。