Skip to content

HK IPO Over-Allotment ​

GET /api/v1.0/quote/{symbol}/ipo/greenshoe

HK IPO greenshoe / over-allotment: presence, execution, shares and proceeds. Public facts only.

Request ​

ParameterTypeInRequiredDescription
symbolstringpathyesHK symbol (path param), e.g. HK.00700

Example ​

bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/ipo/greenshoe' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response ​

FieldTypeDescription
data.has_greenshoeintegerWhether a greenshoe exists
data.executedintegerWhether the greenshoe was exercised
data.expire_timeintegerGreenshoe expiry, unix seconds
data.list_timeintegerOver-allotment listing day, unix seconds
data.planned_sharesstringPlanned over-allotment shares
data.actual_sharesstringOver-allotment shares
data.planned_proceedsstringPlanned proceeds
data.actual_proceedsstringActual proceeds

Errors ​

ret_codeerror.codeDescription
0—Success
-3invalid_parameterMissing or invalid parameter
-7invalid_symbolUnknown symbol
-8unsupportedMarket or product is not supported
-9permission_deniedMissing permission
-10no_dataNo data
-11rate_limitedToo many requests

Sample ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "has_greenshoe": 0,
    "executed": 0,
    "expire_time": 0,
    "list_time": 0,
    "planned_shares": "example",
    "actual_shares": "example",
    "planned_proceeds": "example",
    "actual_proceeds": "example"
  }
}