Operational Efficiency
GET/api/v1.0/quote/{symbol}/company/operational-efficiencyGet 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
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Stock symbol, e.g. HK.00700 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$ |
limit | int | query | no | Number of fiscal-year entries to return, default 10, max 100 ≤ 100; Default 10 |
next_key | string | query | no | Pagination 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_code | string | query | no | Currency code (ISO 4217); if omitted, returns the currency of the latest financial report Max length 10; Pattern ^$|^[A-Z]*$ |
financial_type | int | query | no | Default 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" | jqResponse Fields
data.item_list elements:
| Name | Type | Description |
|---|---|---|
data | object | |
data.item_list | object[] | |
data.item_list[].fiscal_year | int | Fiscal year, e.g. 2025 |
data.item_list[].financial_type | int | Financial 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_text | string | Reporting period text (fiscal year + report-type abbreviation), e.g. 2025/FY, 2025/Q6 |
data.item_list[].end_date | int | Fiscal period end date, millisecond timestamp, e.g. 1767110400000 |
data.item_list[].end_date_str | string | Fiscal period end date (market timezone date string), e.g. 2025-12-31 |
data.item_list[].employee_num | int | Number of employees, e.g. 115849 |
data.item_list[].employee_num_yoy | number | Year-over-year growth rate of employee count (percent), e.g. 4.7857 (= 4.7857%) |
data.item_list[].income_per_capita | number | Revenue per capita (in reporting currency), e.g. 6489188.5126 |
data.item_list[].income_per_capita_yoy | number | Year-over-year growth rate of revenue per capita (percent), e.g. 8.6594 |
data.item_list[].profit_per_capita | number | Operating profit per capita (in reporting currency), e.g. 2085145.3184 |
data.item_list[].profit_per_capita_yoy | number | Year-over-year growth rate of operating profit per capita (percent), e.g. 10.7787 |
data.item_list[].net_profit_per_capita | number | Net profit per capita (in reporting currency), e.g. 1983625.2362 |
data.item_list[].net_profit_per_capita_yoy | number | Year-over-year growth rate of net profit per capita (percent), e.g. 11.6246 |
data.currency_code | string | Currency code (ISO 4217), e.g. USD / CNY |
pagination | object | |
pagination.has_more | bool | |
pagination.next_key | string |
Outer fields:
| Field | Type | Description |
|---|---|---|
currency_code | string | Currency 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_code | error.code | Trigger Condition | Suggested Action |
|---|---|---|---|
| 0 | — | Success | — |
| -3 | invalid_parameter | limit exceeds 100 / financial_type not in {7,102} / invalid symbol format | Correct parameters and retry |
| -7 | invalid_symbol | Symbol cannot be resolved to a security | Verify code validity via search API |
| -8 | unsupported | Category not in supported range | Only call for company-type stocks |
| -10 | no_data | Symbol valid but no operational efficiency data | Treat 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"
}
}