基本面
鑑權
簽名方式:每個請求用 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": "英伟达"
}
}
]
}
]
}
}錯誤碼
參見錯誤碼文檔。