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 intraday A/H premium timeseries data for a dual-listed security.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | HK-side symbol of a dual-listed stock, e.g. `939.HK` |
days | integer | Required | Number of intraday trading days to return, e.g. `1` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
klines | object[] | Required | Intraday A/H premium kline data |
└ timestamp | string | Optional | Unix timestamp |
└ ahpremium_rate | string | Optional | A/H premium rate |
└ aprice | string | Optional | A-share price (CNY) |
└ apreclose | string | Optional | A-share previous close (CNY) |
└ hprice | string | Optional | H-share price (HKD) |
└ hpreclose | string | Optional | H-share previous close (HKD) |
└ currency_rate | string | Optional | CNH/HKD exchange rate |
└ price_spread | string | Optional | Price spread |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"klines": [
{
"ahpremium_rate": "0.1523",
"apreclose": "24.80",
"aprice": "25.10",
"currency_rate": "0.8920",
"hpreclose": "19.20",
"hprice": "19.50",
"price_spread": "1.23",
"timestamp": "1778198400"
}
]
}
}Error code
See the Error Codes page for the full list of error codes.