> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/rest-api/basic-info/get-stock-financial-data.md).

# GET获取个股的财务数据

## 接口说明

提供股票财务数据查询能力，包含损益表、收入明细、现金流量表、资产负债表、估值统计指标、股息指标、派息记录、财报数据共 8 类财务数据。

## 请求频率

跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考[接口限制说明](/getting-started/api-limitation.md)

## 错误码说明

参考[HTTP错误码说明](/getting-started/error-codes/http.md)

## 请求头 <a href="#qing-qiu-tou" id="qing-qiu-tou"></a>

| 参数       | 类型     | 必填 | 描述           |
| -------- | ------ | -- | ------------ |
| `apiKey` | String | 是  | 您套餐中的API Key |

## 接口地址

### 1. 损益表（利润表）

查询公司的收入、成本、利润等经营数据。

#### 接口地址

基本路径：`/common/basic/financial/income_statement` 完整路径：`https://data.infoway.io/common/basic/financial/income_statement`

#### 请求参数

| 参数名          | 类型     | 必填 | 描述                                  | 示例值       |
| ------------ | ------ | -- | ----------------------------------- | --------- |
| symbol       | String | 是  | 标的代码                                | 000001.SZ |
| type         | String | 是  | 标的类型                                | STOCK\_CN |
| period\_type | String | 否  | 报告周期：`fq`=季度、`fy`=年度、`fh`=半年，不传返回全部 | fq        |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/income_statement?symbol=000001.SZ&type=STOCK_CN&period_type=fq
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fq",
      "periodDate": "2025-12-31",
      "itemId": "total_revenue",
      "itemName": "Total_revenue",
      "itemGroup": "Income Statement",
      "itemValue": 54032000000,
      "ttm": 210000000000,
      "parentItemId": ""
    }
  ]
}
```

#### 返回字段说明

| 字段名          | 类型      | 描述                           |
| ------------ | ------- | ---------------------------- |
| symbol       | string  | 标的代码（用户传入格式）                 |
| periodType   | string  | 报告周期：`fq`=季度、`fy`=年度、`fh`=半年 |
| periodDate   | string  | 报告期，如 `2025-12-31`           |
| itemId       | string  | 科目 ID                        |
| itemName     | string  | 科目名称                         |
| itemGroup    | string  | 分组                           |
| itemValue    | decimal | 数值                           |
| ttm          | decimal | TTM 滚动合计                     |
| parentItemId | string  | 父科目 ID（子科目时非空）               |

#### 常见科目（itemId）

| itemId              | 说明   |
| ------------------- | ---- |
| total\_revenue      | 总收入  |
| cost\_of\_goods     | 营业成本 |
| gross\_profit       | 毛利润  |
| operating\_expenses | 运营费用 |
| operating\_income   | 营业利润 |
| net\_income         | 净利润  |

***

### 2. 收入明细

查询收入按业务板块或地区的拆分明细。

#### 接口地址

基本路径：`/common/basic/financial/revenue` 完整路径：`https://data.infoway.io/common/basic/financial/revenue`

#### 请求参数

| 参数名          | 类型     | 必填 | 描述                      | 示例值       |
| ------------ | ------ | -- | ----------------------- | --------- |
| symbol       | String | 是  | 标的代码                    | AAPL.US   |
| type         | String | 是  | 标的类型                    | STOCK\_US |
| period\_type | String | 否  | 报告周期：`fy`=年度（主要），不传返回全部 | fy        |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/revenue?symbol=AAPL.US&type=STOCK_US
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "AAPL.US",
      "periodType": "fy",
      "periodDate": "2024",
      "itemId": "product_iphone",
      "itemName": "Product_iphone",
      "itemGroup": "Revenue by business",
      "itemValue": 200583000000,
      "ttm": null
    }
  ]
}
```

#### 返回字段说明

| 字段名        | 类型      | 描述                                          |
| ---------- | ------- | ------------------------------------------- |
| symbol     | string  | 标的代码（用户传入格式）                                |
| periodType | string  | 报告周期                                        |
| periodDate | string  | 报告期                                         |
| itemId     | string  | 项目 ID                                       |
| itemName   | string  | 项目名称                                        |
| itemGroup  | string  | 分组（Revenue by business / Revenue by region） |
| itemValue  | decimal | 数值                                          |
| ttm        | decimal | TTM                                         |

***

### 3. 现金流量表

查询经营/投资/筹资三大现金流数据。

#### 接口地址

基本路径：`/common/basic/financial/cash_flow` 完整路径：`https://data.infoway.io/common/basic/financial/cash_flow`

#### 请求参数

| 参数名          | 类型     | 必填 | 描述                          | 示例值       |
| ------------ | ------ | -- | --------------------------- | --------- |
| symbol       | String | 是  | 标的代码                        | 000001.SZ |
| type         | String | 是  | 标的类型                        | STOCK\_CN |
| period\_type | String | 否  | 报告周期：`fq`=季度、`fy`=年度，不传返回全部 | fq        |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/cash_flow?symbol=000001.SZ&type=STOCK_CN&period_type=fq
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fq",
      "periodDate": "2025-12-31",
      "itemId": "cf_oper",
      "itemName": "Cf_oper",
      "itemGroup": "Cash Flow Statement",
      "itemValue": 25000000000,
      "ttm": null
    }
  ]
}
```

#### 返回字段说明

| 字段名        | 类型      | 描述           |
| ---------- | ------- | ------------ |
| symbol     | string  | 标的代码（用户传入格式） |
| periodType | string  | 报告周期         |
| periodDate | string  | 报告期          |
| itemId     | string  | 科目 ID        |
| itemName   | string  | 科目名称         |
| itemGroup  | string  | 分组           |
| itemValue  | decimal | 数值           |
| ttm        | decimal | TTM          |

#### 常见科目（itemId）

| itemId               | 说明      |
| -------------------- | ------- |
| cf\_oper             | 经营活动现金流 |
| cf\_invest           | 投资活动现金流 |
| cf\_finance          | 筹资活动现金流 |
| cf\_free\_cash\_flow | 自由现金流   |

***

### 4. 资产负债表

查询资产、负债、股东权益等时点数据。

#### 接口地址

基本路径：`/common/basic/financial/balance_sheet` 完整路径：`https://data.infoway.io/common/basic/financial/balance_sheet`

#### 请求参数

| 参数名          | 类型     | 必填 | 描述                          | 示例值       |
| ------------ | ------ | -- | --------------------------- | --------- |
| symbol       | String | 是  | 标的代码                        | 000001.SZ |
| type         | String | 是  | 标的类型                        | STOCK\_CN |
| period\_type | String | 否  | 报告周期：`fq`=季度、`fy`=年度，不传返回全部 | fq        |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/balance_sheet?symbol=000001.SZ&type=STOCK_CN&period_type=fy
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fy",
      "periodDate": "2025-12-31",
      "itemId": "total_assets",
      "itemName": "Total_assets",
      "itemGroup": "Balance Sheet",
      "itemValue": 255000000000,
      "ttm": null
    }
  ]
}
```

#### 返回字段说明

| 字段名        | 类型      | 描述           |
| ---------- | ------- | ------------ |
| symbol     | string  | 标的代码（用户传入格式） |
| periodType | string  | 报告周期         |
| periodDate | string  | 报告期          |
| itemId     | string  | 科目 ID        |
| itemName   | string  | 科目名称         |
| itemGroup  | string  | 分组           |
| itemValue  | decimal | 数值           |
| ttm        | decimal | TTM          |

#### 常见科目（itemId）

| itemId             | 说明     |
| ------------------ | ------ |
| total\_assets      | 总资产    |
| total\_liabilities | 总负债    |
| total\_equity      | 股东权益合计 |
| cash\_and\_equiv   | 现金及等价物 |
| total\_debt        | 总债务    |

***

### 5. 估值与统计指标

查询 PE、PB、ROE 等估值与财务比率。

#### 接口地址

基本路径：`/common/basic/financial/statistics` 完整路径：`https://data.infoway.io/common/basic/financial/statistics`

#### 请求参数

| 参数名          | 类型     | 必填 | 描述          | 示例值       |
| ------------ | ------ | -- | ----------- | --------- |
| symbol       | String | 是  | 标的代码        | 000001.SZ |
| type         | String | 是  | 标的类型        | STOCK\_CN |
| period\_type | String | 否  | 报告周期，不传返回全部 | fq        |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/statistics?symbol=000001.SZ&type=STOCK_CN
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fq",
      "periodDate": "2025-12-31",
      "itemId": "pe_ratio",
      "itemName": "Pe_ratio",
      "itemGroup": "Valuation ratios",
      "itemValue": 25.5,
      "ttmStr": "24.8",
      "currentValue": 26.1
    }
  ]
}
```

#### 返回字段说明

| 字段名          | 类型      | 描述               |
| ------------ | ------- | ---------------- |
| symbol       | string  | 标的代码（用户传入格式）     |
| periodType   | string  | 报告周期             |
| periodDate   | string  | 报告期              |
| itemId       | string  | 指标 ID            |
| itemName     | string  | 指标名称             |
| itemGroup    | string  | 分组               |
| itemValue    | decimal | 数值               |
| ttmStr       | string  | TTM 值（可能为 `"-"`) |
| currentValue | decimal | 当前值              |

#### 指标分组（itemGroup）

| itemGroup            | 说明                |
| -------------------- | ----------------- |
| Key stats            | 市值、股本、营收等核心指标     |
| Valuation ratios     | PE、PB、PS 等估值比率    |
| Profitability ratios | 毛利率、净利率、ROE 等盈利指标 |
| Liquidity ratios     | 流动比率、速动比率         |
| Solvency ratios      | 资产负债率、利息保障倍数      |

***

### 6. 股息指标

查询每股股息、股息率、派息率等指标。

#### 接口地址

基本路径：`/common/basic/financial/dividend` 完整路径：`https://data.infoway.io/common/basic/financial/dividend`

#### 请求参数

| 参数名          | 类型     | 必填 | 描述                          | 示例值       |
| ------------ | ------ | -- | --------------------------- | --------- |
| symbol       | String | 是  | 标的代码                        | 00700.HK  |
| type         | String | 是  | 标的类型                        | STOCK\_HK |
| period\_type | String | 否  | 报告周期：`fq`=季度、`fy`=年度，不传返回全部 | fy        |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/dividend?symbol=00700.HK&type=STOCK_HK
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "00700.HK",
      "periodType": "fy",
      "periodDate": "2025-12-31",
      "itemId": "dividend_yield",
      "itemName": "Dividend_yield",
      "itemGroup": "Dividend",
      "itemValue": 1.25,
      "ttmStr": "1.30",
      "currentValue": 1.28
    }
  ]
}
```

#### 返回字段说明

| 字段名          | 类型      | 描述           |
| ------------ | ------- | ------------ |
| symbol       | string  | 标的代码（用户传入格式） |
| periodType   | string  | 报告周期         |
| periodDate   | string  | 报告期          |
| itemId       | string  | 指标 ID        |
| itemName     | string  | 指标名称         |
| itemGroup    | string  | 分组           |
| itemValue    | decimal | 数值           |
| ttmStr       | string  | TTM 值        |
| currentValue | decimal | 当前值          |

***

### 7. 历史派息记录

查询每次派息的除权日、金额、类型。

#### 接口地址

基本路径：`/common/basic/financial/dividend_payout` 完整路径：`https://data.infoway.io/common/basic/financial/dividend_payout`

#### 请求参数

| 参数名    | 类型     | 必填 | 描述   | 示例值       |
| ------ | ------ | -- | ---- | --------- |
| symbol | String | 是  | 标的代码 | AAPL.US   |
| type   | String | 是  | 标的类型 | STOCK\_US |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/dividend_payout?symbol=AAPL.US&type=STOCK_US
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "AAPL.US",
      "exDate": 1747267200000,
      "recordDate": 1747353600000,
      "paymentDate": 1747948800000,
      "amount": 0.26,
      "type": "quarterly"
    }
  ]
}
```

#### 返回字段说明

| 字段名         | 类型      | 描述                                     |
| ----------- | ------- | -------------------------------------- |
| symbol      | string  | 标的代码（用户传入格式）                           |
| exDate      | int64   | 除权日（Unix 毫秒时间戳）                        |
| recordDate  | int64   | 登记日（Unix 毫秒时间戳）                        |
| paymentDate | int64   | 派息日（Unix 毫秒时间戳）                        |
| amount      | decimal | 派息金额                                   |
| type        | string  | 类型：`quarterly` / `interim` / `special` |

***

### 8. 财报数据（EPS/Revenue Beat）

查询 EPS 和 Revenue 的实际值与预期值（Beat/Miss）。

#### 接口地址

基本路径：`/common/basic/financial/earnings` 完整路径：`https://data.infoway.io/common/basic/financial/earnings`

#### 请求参数

| 参数名          | 类型     | 必填 | 描述                          | 示例值       |
| ------------ | ------ | -- | --------------------------- | --------- |
| symbol       | String | 是  | 标的代码                        | AAPL.US   |
| type         | String | 是  | 标的类型                        | STOCK\_US |
| period\_type | String | 否  | 报告周期：`fq`=季度、`fy`=年度，不传返回全部 | fq        |

#### 请求示例

```
GET https://data.infoway.io/common/basic/financial/earnings?symbol=AAPL.US&type=STOCK_US&period_type=fq
```

#### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "AAPL.US",
      "periodType": "fq",
      "periodKey": "2026-Q1",
      "epsActual": 1.65,
      "epsEstimate": 1.62,
      "epsPercentage": 1.85,
      "revenueActual": 124300000000,
      "revenueEstimate": 122500000000,
      "revenuePercentage": 1.47
    }
  ]
}
```

#### 返回字段说明

| 字段名               | 类型      | 描述                        |
| ----------------- | ------- | ------------------------- |
| symbol            | string  | 标的代码（用户传入格式）              |
| periodType        | string  | 报告周期                      |
| periodKey         | string  | 报告期（如 `2026-Q1` 或 `2025`） |
| epsActual         | decimal | EPS 实际值                   |
| epsEstimate       | decimal | EPS 预期值                   |
| epsPercentage     | decimal | EPS 偏差 %                  |
| revenueActual     | decimal | 收入实际值                     |
| revenueEstimate   | decimal | 收入预期值                     |
| revenuePercentage | decimal | 收入偏差 %                    |

***

### 通用说明

#### type 类型

| 值         | 描述   |
| --------- | ---- |
| STOCK\_US | 美股   |
| STOCK\_CN | A股   |
| STOCK\_HK | 港股   |
| STOCK\_IN | 印度股票 |
| STOCK\_JP | 日本股票 |
| STOCK\_KS | 韩国股票 |

#### symbol 格式

| 市场 | 格式                | 示例          |
| -- | ----------------- | ----------- |
| A股 | `{code}.{suffix}` | 000001.SZ   |
| 港股 | `{code}.HK`       | 00700.HK    |
| 美股 | `{ticker}.US`     | AAPL.US     |
| 印度 | `{ticker}.IN`     | RELIANCE.IN |
| 日本 | `{code}.JP`       | 7203.JP     |
| 韩国 | `{code}.KS`       | 005930.KS   |
