Buybacks

GET /api/v1.0/quote/{symbol}/corporate-actions/buybacks

Get the share buyback history for a company. Returns HK or A-share data depending on the market of the symbol.

Parameters

Name	Type	In	Required	Description
symbol	string	path	yes	Symbol code, e.g. HK.00700.
next_key	string	query	no	Pagination cursor; leave empty for the first page.
limit	int	query	no	Page size. Default 10, max 50.

Request Example

curl "https://webapi.moomoo.com/api/v1.0/quote/HK.00700/corporate-actions/buybacks?limit=2" | jq

Response Fields

Returns data containing hk_buy_back_list (HK records) + a_buy_back_list (A-share records); pagination via pagination.

hk_buy_back_list element (HK):

Field	Type	Description
publ_date / publ_date_str	int / string	Announcement date (millisecond timestamp / yyyy-MM-dd).
end_date / end_date_str	int / string	Buyback end date.
buy_back_money	double	Buyback amount (currency per currency field).
currency	string	Buyback amount currency.
buy_back_sum	int	Number of shares repurchased.
percentage	double	Buyback proportion of total shares (%).
high_price / low_price	double	Highest / lowest buyback price.
cumulative_sum	int	Year-to-date cumulative repurchased shares.
cumulative_percentage	double	Year-to-date cumulative buyback proportion (%).
share_type	string	Share class.

a_buy_back_list element (A-share):

Field	Type	Description
advance_date / advance_date_str	int / string	Proposal announcement date.
start_date / start_date_str	int / string	Buyback period start date.
end_date / end_date_str	int / string	Buyback period end date.
event_proce_desc	string	Event progress description.
buy_back_mode	string	Buyback method.
buy_back_sum	int	Number of shares repurchased.
buy_back_money	double	Buyback amount (CNY).
percentage	double	Proportion of total shares (%).
value_floor / value_ceiling	double	Planned buyback fund lower/upper limit.
price_floor / price_ceiling	double	Planned buyback price lower/upper limit.

Supported Markets

• Supported markets: HK, A-shares (SH / SZ).
• Categories: Only equities have buyback records; ETF / options / warrants etc. have no data.
• US and other markets return success but with empty lists.

Error Codes

ret_code	error.code	Trigger Condition	Suggested Action
0	—	Success (including valid symbols with no buyback records)	—
-3	invalid_parameter	limit > 50 / invalid symbol format	Fix parameters and retry
-7	invalid_symbol	Symbol does not exist in securities database	Use the search API to verify the symbol
-5 / -6	internal_error	Gateway or backend internal error	Retry later; contact support if persistent

Response Example

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "hk_buy_back_list": [
      {
        "buy_back_money": 500433679.2,
        "buy_back_sum": 1092000,
        "cumulative_percentage": 0.15384,
        "cumulative_sum": 14027100,
        "currency": "HKD",
        "end_date": 1780588800000,
        "end_date_str": "2026-06-05",
        "high_price": 465.8,
        "low_price": 452.4,
        "percentage": 0.011976,
        "publ_date": 1780588800000,
        "publ_date_str": "2026-06-05",
        "share_type": "Ordinary shares"
      }
    ],
    "a_buy_back_list": null
  },
  "pagination": { "has_more": true, "next_key": "2" }
}