Skip to content

Operational Efficiency ​

GET /api/v1.0/quote/{symbol}/company/operational-efficiency

Get historical operational efficiency metrics for a company (employee count, revenue per capita / operating profit per capita / net profit per capita and their respective YoY), returned by financial reporting period.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesStock symbol, e.g. HK.00700 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
limitintquerynoNumber of fiscal-year entries to return, default 10, max 100 ≤ 100; Default 10
next_keystringquerynoPagination cursor; leave empty for the first request; for paging, use pagination.next_key from the previous response; stop when pagination.has_more=false Max length 1000; Default ""
currency_codestringquerynoCurrency code (ISO 4217); if omitted, returns the currency of the latest financial report Max length 10; Pattern ^$|^[A-Z]*$
financial_typeintquerynoDefault 7. Options: 7 (annual report) / 102 (all cumulative quarterly reports). See Naming Dictionary. Default 7; Values 7, 102

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/company/operational-efficiency?limit=1" | jq

Response Fields ​

data.item_list elements:

NameTypeDescription
dataobject
data.item_listobject[]
data.item_list[].fiscal_yearintFiscal year, e.g. 2025
data.item_list[].financial_typeintFinancial report type enum (FinancialType): 1=Q1 / 5=Q6 (interim) / 6=Q9 / 7=Annual FY / 70=MY single-quarter / 71=MY cumulative-quarter. Always 7 when financial_type=7; one of 1/5/6/7 (MY 70/71) when financial_type=102
data.item_list[].period_textstringReporting period text (fiscal year + report-type abbreviation), e.g. 2025/FY, 2025/Q6
data.item_list[].end_dateintFiscal period end date, millisecond timestamp, e.g. 1767110400000
data.item_list[].end_date_strstringFiscal period end date (market timezone date string), e.g. 2025-12-31
data.item_list[].employee_numintNumber of employees, e.g. 115849
data.item_list[].employee_num_yoynumberYear-over-year growth rate of employee count (percent), e.g. 4.7857 (= 4.7857%)
data.item_list[].income_per_capitanumberRevenue per capita (in reporting currency), e.g. 6489188.5126
data.item_list[].income_per_capita_yoynumberYear-over-year growth rate of revenue per capita (percent), e.g. 8.6594
data.item_list[].profit_per_capitanumberOperating profit per capita (in reporting currency), e.g. 2085145.3184
data.item_list[].profit_per_capita_yoynumberYear-over-year growth rate of operating profit per capita (percent), e.g. 10.7787
data.item_list[].net_profit_per_capitanumberNet profit per capita (in reporting currency), e.g. 1983625.2362
data.item_list[].net_profit_per_capita_yoynumberYear-over-year growth rate of net profit per capita (percent), e.g. 11.6246
data.currency_codestringCurrency code (ISO 4217), e.g. USD / CNY
paginationobject
pagination.has_morebool
pagination.next_keystring

Outer fields:

FieldTypeDescription
currency_codestringCurrency unit for metrics (ISO 4217).

Supported Markets ​

  • Supported markets: HK / US / SH / SZ / BJ / SG / JP / AU / CA.
  • Supported categories: Company-type securities with public financial reports (common stocks and equivalent categories).
  • Non-company categories return unsupported (-8); companies without operational efficiency data return no_data (-10).

Error Codes ​

ret_codeerror.codeTrigger ConditionSuggested Action
0—Success—
-3invalid_parameterlimit exceeds 100 / financial_type not in {7,102} / invalid symbol formatCorrect parameters and retry
-7invalid_symbolSymbol cannot be resolved to a securityVerify code validity via search API
-8unsupportedCategory not in supported rangeOnly call for company-type stocks
-10no_dataSymbol valid but no operational efficiency dataTreat as no data, no need to retry

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "currency_code": "CNY",
    "item_list": [
      {
        "fiscal_year": 2025,
        "financial_type": 7,
        "period_text": "2025/FY",
        "end_date": 1767110400000,
        "end_date_str": "2025-12-31",
        "employee_num": 115849,
        "employee_num_yoy": 4.7857,
        "income_per_capita": 6489188.5126,
        "income_per_capita_yoy": 8.6594,
        "profit_per_capita": 2085145.3184,
        "profit_per_capita_yoy": 10.7787,
        "net_profit_per_capita": 1983625.2362,
        "net_profit_per_capita_yoy": 11.6246
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "1767110400"
  }
}