Skip to content

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 ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, e.g. HK.00700.
next_keystringquerynoPagination cursor; leave empty for the first page.
limitintquerynoPage size. Default 10, max 50.

Request Example ​

bash
curl "https://webapi.futunn.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):

NameTypeDescription
dataobject
data.hk_buy_back_listobject[]HK buyback record list (empty array for A-share requests)
data.hk_buy_back_list[].publ_dateintAnnouncement date, millisecond timestamp
data.hk_buy_back_list[].publ_date_strstringAnnouncement date string (market timezone), format yyyy-MM-dd
data.hk_buy_back_list[].end_dateintBuyback end date, millisecond timestamp
data.hk_buy_back_list[].end_date_strstringBuyback end date string, format yyyy-MM-dd, e.g. 2026-05-22
data.hk_buy_back_list[].buy_back_moneystringBuyback amount (in reporting currency, see currency field), e.g. 500562023.2
data.hk_buy_back_list[].currencystringCurrency of the buyback amount (usually HKD for HK), e.g. 'HKD'
data.hk_buy_back_list[].buy_back_sumintBuyback share count, e.g. 1132000
data.hk_buy_back_list[].percentagenumberPercentage of total share capital for this buyback (percent), e.g. 0.012416
data.hk_buy_back_list[].high_pricenumberHighest price of this buyback (HKD), e.g. 445
data.hk_buy_back_list[].low_pricenumberLowest price of this buyback (HKD), e.g. 439
data.hk_buy_back_list[].cumulative_sumintYear-to-date cumulative buyback share count, e.g. 5547000
data.hk_buy_back_list[].cumulative_percentagenumberYear-to-date cumulative buyback as percentage of total share capital (percent), e.g. 0.0608
data.hk_buy_back_list[].share_typestringShare type, e.g. 'Ordinary shares'
data.a_buy_back_listobject[]A-share buyback record list (empty array for HK requests)
data.a_buy_back_list[].change_reg_dateintChange registration date, millisecond timestamp
data.a_buy_back_list[].change_reg_date_strstringChange registration date string, format yyyy-MM-dd
data.a_buy_back_list[].change_dateintChange date, millisecond timestamp
data.a_buy_back_list[].change_date_strstringChange date string, format yyyy-MM-dd
data.a_buy_back_list[].event_proce_descstringEvent progress description (free text), e.g. 'Implementation completed'
data.a_buy_back_list[].advance_dateintPlan date, millisecond timestamp
data.a_buy_back_list[].advance_date_strstringPlan date string, format yyyy-MM-dd
data.a_buy_back_list[].meet_pass_dateintShareholders' meeting approval date, millisecond timestamp
data.a_buy_back_list[].meet_pass_date_strstringShareholders' meeting approval date string, format yyyy-MM-dd
data.a_buy_back_list[].start_dateintBuyback start date, millisecond timestamp
data.a_buy_back_list[].start_date_strstringBuyback start date string, format yyyy-MM-dd
data.a_buy_back_list[].end_dateintBuyback end date, millisecond timestamp
data.a_buy_back_list[].end_date_strstringBuyback end date string, format yyyy-MM-dd
data.a_buy_back_list[].pay_dateintPayment date, millisecond timestamp
data.a_buy_back_list[].pay_date_strstringPayment date string, format yyyy-MM-dd
data.a_buy_back_list[].sellerstringSeller (party whose shares are repurchased), free text, e.g. 'Public shareholders' / '184 incentive recipients'
data.a_buy_back_list[].buy_back_modestringBuyback method (free text), e.g. 'centralized bidding' / 'Agreement repurchase'
data.a_buy_back_list[].share_typestringShare type
data.a_buy_back_list[].buy_back_sumintBuyback share count
data.a_buy_back_list[].buy_back_moneystringBuyback amount (CNY)
data.a_buy_back_list[].percentagenumberBuyback as percentage of total shares (percent)
data.a_buy_back_list[].value_floorstringBuyback amount lower bound (CNY)
data.a_buy_back_list[].value_ceilingstringBuyback amount upper bound (CNY)
data.a_buy_back_list[].price_floornumberBuyback price lower bound
data.a_buy_back_list[].price_ceilingnumberBuyback price upper bound
data.a_buy_back_list[].volume_floorintBuyback share count lower bound (shares)
data.a_buy_back_list[].volume_ceilingintBuyback share count upper bound (shares)
paginationobject
pagination.has_morebool
pagination.next_keystring

a_buy_back_list element (A-share):

FieldTypeDescription
advance_date / advance_date_strint / stringProposal announcement date.
start_date / start_date_strint / stringBuyback period start date.
end_date / end_date_strint / stringBuyback period end date.
event_proce_descstringEvent progress description.
buy_back_modestringBuyback method.
buy_back_sumintNumber of shares repurchased.
buy_back_moneydoubleBuyback amount (CNY).
percentagedoubleProportion of total shares (%).
value_floor / value_ceilingdoublePlanned buyback fund lower/upper limit.
price_floor / price_ceilingdoublePlanned 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_codeerror.codeTrigger ConditionSuggested Action
0—Success (including valid symbols with no buyback records)—
-3invalid_parameterlimit > 50 / invalid symbol formatFix parameters and retry
-7invalid_symbolSymbol does not exist in securities databaseUse the search API to verify the symbol
-5 / -6internal_errorService errorRetry later; contact support if persistent

Response Example ​

json
{
  "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": []
  },
  "pagination": {
    "has_more": true,
    "next_key": "2"
  }
}