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 | Symbol code, e.g. HK.00700. |
limit | int | query | no | Number of records. Default 10, max 100. |
financial_type | int | query | no | Default 7. Options: 7 (annual report) / 102 (all cumulative quarterly reports). See Naming Dictionary. |
currency_code | string | query | no | Currency code (ISO 4217), e.g. CNY. Defaults to the currency of the latest report. |
next_key | string | query | no | Pagination cursor; leave empty for the first page. |
Request Example
bash
curl "https://webapi.moomoo.com/api/v1.0/quote/HK.00700/company/operational-efficiency?limit=1" | jqResponse Fields
data.item_list elements:
| Field | Type | Description |
|---|---|---|
fiscal_year | int | Fiscal year. |
financial_type | int | Financial period type. |
period_text | string | Financial period text, e.g. 2025/FY. |
end_date | int | Period end date (millisecond timestamp). |
end_date_str | string | Period end date (yyyy-MM-dd). |
employee_num | int | Number of employees. |
employee_num_yoy | double | Employee count YoY growth rate (%). |
income_per_capita | double | Revenue per capita (report currency). |
income_per_capita_yoy | double | Revenue per capita YoY growth rate (%). |
profit_per_capita | double | Operating profit per capita. |
profit_per_capita_yoy | double | Operating profit per capita YoY (%). |
net_profit_per_capita | double | Net profit per capita. |
net_profit_per_capita_yoy | double | Net profit per capita YoY (%). |
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" }
}