Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Get ETF asset allocation, grouped by element type: holdings, regional, asset class and industry.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | ETF symbol, e.g. `QQQ.US`. |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
info | object[] | Optional | Asset allocation groups (one per element type) |
└ report_date | string | Optional | Report date, e.g. `20260601` |
└ asset_type | integer | Optional | Element type of this group (holdings / regional / asset class / industry) |
└ lists | object[] | Optional | Elements in this group |
└ ∟ name | string | Optional | Element name |
└ ∟ position_ratio | string | Optional | Position ratio, e.g. `0.0861114` |
└ ∟ name_locales | string | Optional | Localized name (raw string; see `name_locales_map` for the locale map). |
└ ∟ name_locales_map | object | Optional | Localized names (locale → name, e.g. `zh-CN` → `英伟达`) |
└ ∟ ∟ en | string | Optional | English name. |
└ ∟ ∟ zh-CN | string | Optional | Simplified Chinese name. |
└ ∟ ∟ zh-HK | string | Optional | Traditional Chinese name. |
└ ∟ code | string | Optional | Security code (holdings only), e.g. `NVDA` |
└ ∟ symbol | string | Optional | Security symbol (holdings only), e.g. `NVDA.US` |
└ ∟ holding_detail | string | Optional | Holding detail (holdings only) |
Response JSON example
{
"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": "英伟达"
}
}
]
}
]
}
}Error code
See the Error Codes page for the full list of error codes.