基本面
鉴权
签名方式:每个请求用 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=。 |
获取 ETF 资产配置,按元素类型分组:持仓、地区、资产类别与行业。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 必填 | ETF 代码,如 `QQQ.US`。 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
info | object[] | 可选 | 资产配置分组(每种元素类型一组) |
└ report_date | string | 可选 | 报告日期,如 `20260601` |
└ asset_type | integer | 可选 | 本组的元素类型(持仓 / 地区 / 资产类别 / 行业) |
└ lists | object[] | 可选 | 本组的元素列表 |
└ ∟ name | string | 可选 | 元素名称 |
└ ∟ position_ratio | string | 可选 | 持仓占比,如 `0.0861114` |
└ ∟ name_locales | string | 可选 | 本地化名称(原始字符串,语言映射见 `name_locales_map`)。 |
└ ∟ name_locales_map | object | 可选 | 本地化名称(locale → 名称,如 `zh-CN` → `英伟达`) |
└ ∟ ∟ en | string | 可选 | 英文名称。 |
└ ∟ ∟ zh-CN | string | 可选 | 简体中文名称。 |
└ ∟ ∟ zh-HK | string | 可选 | 繁体中文名称。 |
└ ∟ code | string | 可选 | 证券代码(仅持仓),如 `NVDA` |
└ ∟ symbol | string | 可选 | 证券代码带市场后缀(仅持仓),如 `NVDA.US` |
└ ∟ holding_detail | string | 可选 | 持仓明细(仅持仓) |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"info": [
{
"report_date": "20260601",
"asset_type": "holdings",
"lists": [
{
"name": "NVIDIA",
"code": "NVDA",
"position_ratio": "0.0861114",
"symbol": "NVDA.US",
"name_locales_map": {
"zh-CN": "英伟达"
}
}
]
}
]
}
}错误码
参见错误码文档。