基本面
鉴权
签名方式:每个请求用 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` |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
overview | object | 必填 | 当前估值概览 |
overview.metrics | object | 可选 | 按指标(pe/pb/ps)分组的指标映射 |
overview.metrics.pe | object | 可选 | 所请求指标的数据块 |
overview.metrics.pe.metric | string | 可选 | 当前值,如 14.85x |
overview.metrics.pe.industry_median | string | 可选 | 行业中位数 |
overview.metrics.pe.desc | string | 可选 | 可读描述 |
overview.indicator | string | 可选 | 请求的指标键 |
overview.range | integer | 可选 | 回溯年数 |
overview.date | string | 可选 | 数据日期 |
overview.ccy_symbol | string | 可选 | 货币符号 |
history | object | 必填 | 历史时间序列 |
history.metrics.pe | object | 可选 | 该指标的历史数据块 |
history.metrics.pe.low | string | 可选 | 历史低值 |
history.metrics.pe.median | string | 可选 | 历史中位数 |
history.metrics.pe.high | string | 可选 | 历史高值 |
history.metrics.pe.list | object[] | 可选 | 历史数据点列表 |
history.metrics.pe.list[].timestamp | string | 可选 | Unix 秒(字符串) |
history.metrics.pe.list[].value | string | 可选 | 该点数值 |
peers | object | 可选 | 行业可比公司 |
peers.pe.industry_median | string | 可选 | 同业中位数 |
peers.pe.list | object[] | 可选 | 同业公司列表 |
peers.pe.list[].symbol | string | 可选 | 标的代码,如 9626.HK |
peers.pe.list[].name | string | 可选 | 标的名称 |
peers.pe.list[].value | string | 可选 | 指标值 |
layouts | object | 可选 | 用于绘图的分布分组 |
symbols | object | 可选 | 以 symbol 为键的映射 -> { name, market_cap } |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"history": {
"metrics": {
"pe": {
"desc": "P/E Ratio",
"high": "35.2",
"low": "18.1",
"median": "26.5",
"list": [
{
"timestamp": "1622520000",
"value": "28.5"
}
]
},
"pb": null,
"ps": null
}
}
}
}错误码
参见错误码文档。