# 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": "总收入",
      "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": "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": "经营活动现金流",
      "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": "总资产",
      "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": "市盈率",
      "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": "股息率",
      "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 | 日本股票 |

#### symbol 格式

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infoway.io/rest-api/basic-info/get-stock-financial-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.