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 trade statistics showing price distribution by volume for a security.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `700.HK` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
trades | object[] | Optional | Price-level trade distribution |
└ price | string | Optional | Price level |
└ buy_amount | string | Optional | Buy amount at this price |
└ sell_amount | string | Optional | Sell amount at this price |
└ neutral_amount | string | Optional | Neutral amount at this price |
statistics | object | Optional | Aggregate trade statistics |
└ avgprice | string | Optional | Average price. |
└ trades_count | string | Optional | Number of trades. |
└ total_amount | string | Optional | Total market turnover. |
└ buy | string | Optional | Top buying brokers |
└ sell | string | Optional | Top selling brokers |
└ neutral | string | Optional | Neutral value/count. |
└ timestamp | string | Optional | Event time (Unix seconds as string) |
└ preclose | string | Optional | Previous close price. |
└ trade_date | array | Optional | Next projected trade date (YYYY-MM-DD) |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"statistics": {
"avgprice": "210.50",
"buy": "45000000",
"sell": "38000000",
"neutral": "12000000",
"total_amount": "95000000",
"trades_count": "125000",
"preclose": "208.20",
"timestamp": "1778198400",
"trade_date": [
"2026-05-13"
]
},
"trades": [
{
"price": "210.00",
"buy_amount": "5000000",
"sell_amount": "4000000",
"neutral_amount": "1000000"
}
]
}
}Error code
See the Error Codes page for the full list of error codes.