经营效率
GET/api/v1.0/quote/{symbol}/company/operational-efficiency获取公司历史经营效率指标(员工人数、人均收入 / 人均营业利润 / 人均净利润及各自同比),按财报期返回。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 标的代码,例: HK.00700 最长长度 32; 格式 ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$ |
limit | int | 查询 | 否 | 返回的财年条数,默认 10,最大 100 ≤ 100; 默认 10 |
next_key | string | 查询 | 否 | 翻页游标,首次请求留空;分页时取上一次响应的 pagination.next_key;以 pagination.has_more=false 停止 最长长度 1000; 默认 "" |
currency_code | string | 查询 | 否 | 货币代码(ISO 4217),不传则返回最新一期财报的货币类型 最长长度 10; 格式 ^$|^[A-Z]*$ |
financial_type | int | 查询 | 否 | 默认 7。可选 7(年报)/ 102(全部累计季报)。详见命名词典。 默认 7; 取值 7, 102 |
请求示例
bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/company/operational-efficiency?limit=1" | jq响应字段
data.item_list 元素:
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.item_list | object[] | |
data.item_list[].fiscal_year | int | 财年,例: 2025 |
data.item_list[].financial_type | int | 财报类型枚举(FinancialType):1=Q1 / 5=Q6(半年) / 6=Q9 / 7=年报FY / 70=马股单季报 / 71=马股累计季报。financial_type=7 时恒为 7;=102 时为 1/5/6/7(马股 70/71) |
data.item_list[].period_text | string | 财报期文本(财年 + 财报类型缩写),例: 2025/FY、2025/Q6 |
data.item_list[].end_date | int | 财报期截止日毫秒时间戳,例: 1767110400000 |
data.item_list[].end_date_str | string | 财报期截止日(市场时区日期串),例: 2025-12-31 |
data.item_list[].employee_num | int | 员工人数,例: 115849 |
data.item_list[].employee_num_yoy | number | 员工人数同比增长率(百分数),例: 4.7857(=4.7857%) |
data.item_list[].income_per_capita | number | 人均收入(原始货币),例: 6489188.5126 |
data.item_list[].income_per_capita_yoy | number | 人均收入同比增长率(百分数),例: 8.6594 |
data.item_list[].profit_per_capita | number | 人均营业利润(原始货币),例: 2085145.3184 |
data.item_list[].profit_per_capita_yoy | number | 人均营业利润同比增长率(百分数),例: 10.7787 |
data.item_list[].net_profit_per_capita | number | 人均净利润(原始货币),例: 1983625.2362 |
data.item_list[].net_profit_per_capita_yoy | number | 人均净利润同比增长率(百分数),例: 11.6246 |
data.currency_code | string | 货币代码(ISO 4217),例: USD / CNY |
pagination | object | |
pagination.has_more | bool | |
pagination.next_key | string |
外层字段:
| 字段 | 类型 | 说明 |
|---|---|---|
currency_code | string | 指标的货币单位(ISO 4217)。 |
限制范围
- 支持市场:HK / US / SH / SZ / BJ / SG / JP / AU / CA。
- 支持品类:有公开财报的公司类标的(正股及等价品类)。
- 非公司品类返回 unsupported(-8);公司暂无经营效率数据返回 no_data(-10)。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功 | — |
| -3 | invalid_parameter | limit 超过 100 / financial_type 不在 {7,102} / symbol 格式非法 | 校正参数后重试 |
| -7 | invalid_symbol | 标的代码无法解析为证券 | 通过 search 接口确认代码合法性 |
| -8 | unsupported | 品类不在支持范围 | 仅对公司类正股调用 |
| -10 | no_data | 标的合法但无经营效率数据 | 视为无数据,无需重试 |
响应示例
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"
}
}