Trade
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=. |
Fetch the grid-trading information for a security: lot size, last done price, price steps, and authorization status. Use it to build a valid grid rule before calling Submit Grid Order. The channel_info.strategy_granted field tells you whether the strategy risk-disclosure consent has already been recorded — if it is false, submit the Strategy Questionnaire first.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol in `ticker.region` format, e.g. `700.HK`. |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
last_done | string | Required | Latest traded price |
lot_size | string | Required | Board lot size |
buy_lot_size | string | Required | Minimum lot size for a buy order |
sell_lot_size | string | Required | Minimum lot size for a sell order |
bid_sizes | object[] | Required | Price-step tiers |
└ str_proceed | string | Required | Start price of the tier |
└ end_proceed | string | Required | End price of the tier |
└ bid_size | string | Required | Minimum price step within the tier |
channel_info | object | Required | Trading-channel info and authorization. `strategy_granted` indicates whether the one-time strategy risk-disclosure consent has been recorded |
└ strategy_granted | boolean | Required | Whether the one-time strategy risk-disclosure consent has been recorded |
└ support_rth | boolean | Required | Whether the security supports regular-trading-hours grids |
└ currency | string | Required | Trading currency |
└ settlement_currency | string[] | Required | Supported settlement currencies |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"name": "TENCENT",
"last_done": "300.000",
"lot_size": "100",
"buy_lot_size": "100",
"sell_lot_size": "100",
"bid_sizes": [
{
"str_proceed": "0.010",
"end_proceed": "500.000",
"bid_size": "0.200"
}
],
"channel_info": {
"strategy_granted": true,
"support_rth": false,
"currency": "HKD",
"settlement_currency": [
"HKD"
]
}
}
}Error code
See the Error Codes page for the full list of error codes.