利润表

获取Ashare上市公司的利润表(损益表)数据,包括营业收入、营业成本、营业利润、净利润等财务指标。

接口说明

HTTP请求

GET /v1/financials/income-statement

请求参数

参数名类型必选描述
symbol字符串股票代码,可以是单个代码或以逗号分隔的多个代码(最多10个)。支持多种格式,如600519sh.600519600519.SH
period字符串报告期类型,可选值:annual(年报)、quarterly(季报)、ttm(滚动12个月)。默认为annual
begin_date字符串起始日期,格式为YYYY-MM-DD。如果未指定,默认返回最近5个报告期的数据。
end_date字符串结束日期,格式为YYYY-MM-DD。如果未指定,默认为当前日期。
report_type字符串报表类型,可选值:consolidated(合并报表)、parent(母公司报表)。默认为consolidated
fields字符串指定返回字段,用逗号分隔。如果未指定,返回所有可用字段。
limit整数返回的报告期数量限制,默认为5,最大为20。

返回字段

字段名类型描述
symbol字符串股票代码
name字符串公司名称
income_statements数组利润表数据数组,按报告期降序排列

每个利润表数据项包含以下主要字段(根据会计准则可能有所差异):

字段名类型描述
report_date字符串报告期,格式为YYYY-MM-DD,如2022-12-31(年报)、2022-09-30(三季报)等
report_name字符串报告期名称,如”2022年年报”、“2022年第三季度报”
revenue数值营业收入(元)
operating_cost数值营业成本(元)
selling_expenses数值销售费用(元)
admin_expenses数值管理费用(元)
rd_expenses数值研发费用(元)
financial_expenses数值财务费用(元)
interest_expenses数值利息费用(元)
interest_income数值利息收入(元)
investment_income数值投资收益(元)
operating_profit数值营业利润(元)
non_operating_income数值营业外收入(元)
non_operating_expenses数值营业外支出(元)
profit_before_tax数值利润总额(元)
income_tax数值所得税费用(元)
net_profit数值净利润(元)
net_profit_parent数值归属于母公司股东的净利润(元)
net_profit_minority数值少数股东损益(元)
basic_eps数值基本每股收益(元/股)
diluted_eps数值稀释每股收益(元/股)
comprehensive_income数值综合收益总额(元)
comprehensive_income_parent数值归属于母公司股东的综合收益总额(元)
comprehensive_income_minority数值归属于少数股东的综合收益总额(元)
ebitda数值息税折旧摊销前利润(元)
gross_profit数值毛利润(元)
gross_margin数值毛利率(%)
operating_margin数值营业利润率(%)
net_margin数值净利润率(%)
annual_growth_revenue数值营业收入同比增长率(%),仅当period=annual或ttm时有效
annual_growth_profit数值净利润同比增长率(%),仅当period=annual或ttm时有效

示例

请求示例

获取单个公司的年度利润表

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519&period=annual&limit=3" \
  -H "X-API-KEY: your_api_key_here"

获取单个公司的季度利润表

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519&period=quarterly&limit=4" \
  -H "X-API-KEY: your_api_key_here"

获取多个公司的TTM利润表

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519,000858&period=ttm&limit=1" \
  -H "X-API-KEY: your_api_key_here"

获取指定字段

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519&period=annual&fields=report_date,revenue,net_profit,basic_eps&limit=5" \
  -H "X-API-KEY: your_api_key_here"

响应示例

单个公司年报响应

{
  "code": 200,
  "message": "success",
  "data": {
    "symbol": "600519",
    "name": "贵州茅台",
    "income_statements": [
      {
        "report_date": "2022-12-31",
        "report_name": "2022年年报",
        "revenue": 119937778604.24,
        "operating_cost": 16138284220.05,
        "selling_expenses": 5162392622.66,
        "admin_expenses": 5924657180.26,
        "rd_expenses": 601320452.67,
        "financial_expenses": -2729895923.10,
        "interest_expenses": 0.00,
        "interest_income": 2755974908.10,
        "investment_income": 350882136.86,
        "operating_profit": 95191902188.54,
        "non_operating_income": 134989064.48,
        "non_operating_expenses": 53478089.65,
        "profit_before_tax": 95273413163.37,
        "income_tax": 23806665723.61,
        "net_profit": 71466747439.76,
        "net_profit_parent": 71263121099.75,
        "net_profit_minority": 203626340.01,
        "basic_eps": 5.67,
        "diluted_eps": 5.67,
        "comprehensive_income": 71474201439.76,
        "comprehensive_income_parent": 71270575099.75,
        "comprehensive_income_minority": 203626340.01,
        "ebitda": 98329982188.54,
        "gross_profit": 103799494384.19,
        "gross_margin": 86.54,
        "operating_margin": 79.37,
        "net_margin": 59.59,
        "annual_growth_revenue": 16.18,
        "annual_growth_profit": 18.96
      },
      {
        "report_date": "2021-12-31",
        "report_name": "2021年年报",
        "revenue": 103203469169.81,
        "operating_cost": 14224681331.38,
        // 更多字段...
      },
      {
        "report_date": "2020-12-31",
        "report_name": "2020年年报",
        "revenue": 94915380916.90,
        "operating_cost": 16321622105.50,
        // 更多字段...
      }
    ]
  }
}

多个公司TTM响应

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "symbol": "600519",
      "name": "贵州茅台",
      "income_statements": [
        {
          "report_date": "2023-09-30",
          "report_name": "2023年TTM",
          "revenue": 127862735123.78,
          "operating_cost": 17220163352.33,
          "net_profit": 76120345692.38,
          "net_profit_parent": 75892467135.62,
          // 更多字段...
        }
      ]
    },
    {
      "symbol": "000858",
      "name": "五粮液",
      "income_statements": [
        {
          "report_date": "2023-09-30",
          "report_name": "2023年TTM",
          "revenue": 68295764320.91,
          "operating_cost": 24123867220.14,
          "net_profit": 23506789432.56,
          "net_profit_parent": 23126538911.33,
          // 更多字段...
        }
      ]
    }
  ]
}

指定字段响应

{
  "code": 200,
  "message": "success",
  "data": {
    "symbol": "600519",
    "name": "贵州茅台",
    "income_statements": [
      {
        "report_date": "2022-12-31",
        "revenue": 119937778604.24,
        "net_profit": 71466747439.76,
        "basic_eps": 5.67
      },
      {
        "report_date": "2021-12-31",
        "revenue": 103203469169.81,
        "net_profit": 60037631911.96,
        "basic_eps": 4.78
      },
      {
        "report_date": "2020-12-31",
        "revenue": 94915380916.90,
        "net_profit": 46697285429.62,
        "basic_eps": 3.72
      },
      {
        "report_date": "2019-12-31",
        "revenue": 85429537827.66,
        "net_profit": 41206471014.43,
        "basic_eps": 3.28
      },
      {
        "report_date": "2018-12-31",
        "revenue": 73638186125.88,
        "net_profit": 35203625263.59,
        "basic_eps": 2.80
      }
    ]
  }
}

错误码

除了通用错误码外,此接口还可能返回以下错误码:

错误码描述
invalid_symbol无效的股票代码
invalid_period无效的报告期类型
invalid_report_type无效的报表类型
no_data指定条件下无数据
too_many_symbols请求的股票代码数量超过上限(最多支持10个)

注意事项

  1. TTM(Trailing Twelve Months)数据是指最近12个月的滚动数据,适合消除季节性因素分析公司业绩。
  2. 财务数据的更新频率与公司公告时间一致,通常年报在次年4月底前披露,季报在季度结束后一个月内披露。
  3. 不同行业的公司财务科目可能有所不同,部分科目可能为null。
  4. 所有金额数据的单位均为”元”。
  5. 增长率字段在非年报或TTM模式下可能为null。
  6. 历史数据可能因公司重述而与原始披露数据有所不同,我们提供的是最新重述后的数据。

报告期说明

Ashare上市公司需要披露的财报包括:

  • 年报:每年1月1日至12月31日的财务数据,通常在次年4月30日前披露。
  • 半年报:每年1月1日至6月30日的财务数据,通常在当年8月31日前披露。
  • 一季报:每年1月1日至3月31日的财务数据,通常在当年4月30日前披露。
  • 三季报:每年1月1日至9月30日的财务数据,通常在当年10月31日前披露。

使用period=quarterly可获取全部季度报告,包括一季报、半年报、三季报和年报。

相关接口

利润表

获取Ashare上市公司的利润表(损益表)数据,包括营业收入、营业成本、营业利润、净利润等财务指标。

接口说明

HTTP请求

GET /v1/financials/income-statement

请求参数

参数名类型必选描述
symbol字符串股票代码,可以是单个代码或以逗号分隔的多个代码(最多10个)。支持多种格式,如600519sh.600519600519.SH
period字符串报告期类型,可选值:annual(年报)、quarterly(季报)、ttm(滚动12个月)。默认为annual
begin_date字符串起始日期,格式为YYYY-MM-DD。如果未指定,默认返回最近5个报告期的数据。
end_date字符串结束日期,格式为YYYY-MM-DD。如果未指定,默认为当前日期。
report_type字符串报表类型,可选值:consolidated(合并报表)、parent(母公司报表)。默认为consolidated
fields字符串指定返回字段,用逗号分隔。如果未指定,返回所有可用字段。
limit整数返回的报告期数量限制,默认为5,最大为20。

返回字段

字段名类型描述
symbol字符串股票代码
name字符串公司名称
income_statements数组利润表数据数组,按报告期降序排列

每个利润表数据项包含以下主要字段(根据会计准则可能有所差异):

字段名类型描述
report_date字符串报告期,格式为YYYY-MM-DD,如2022-12-31(年报)、2022-09-30(三季报)等
report_name字符串报告期名称,如”2022年年报”、“2022年第三季度报”
revenue数值营业收入(元)
operating_cost数值营业成本(元)
selling_expenses数值销售费用(元)
admin_expenses数值管理费用(元)
rd_expenses数值研发费用(元)
financial_expenses数值财务费用(元)
interest_expenses数值利息费用(元)
interest_income数值利息收入(元)
investment_income数值投资收益(元)
operating_profit数值营业利润(元)
non_operating_income数值营业外收入(元)
non_operating_expenses数值营业外支出(元)
profit_before_tax数值利润总额(元)
income_tax数值所得税费用(元)
net_profit数值净利润(元)
net_profit_parent数值归属于母公司股东的净利润(元)
net_profit_minority数值少数股东损益(元)
basic_eps数值基本每股收益(元/股)
diluted_eps数值稀释每股收益(元/股)
comprehensive_income数值综合收益总额(元)
comprehensive_income_parent数值归属于母公司股东的综合收益总额(元)
comprehensive_income_minority数值归属于少数股东的综合收益总额(元)
ebitda数值息税折旧摊销前利润(元)
gross_profit数值毛利润(元)
gross_margin数值毛利率(%)
operating_margin数值营业利润率(%)
net_margin数值净利润率(%)
annual_growth_revenue数值营业收入同比增长率(%),仅当period=annual或ttm时有效
annual_growth_profit数值净利润同比增长率(%),仅当period=annual或ttm时有效

示例

请求示例

获取单个公司的年度利润表

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519&period=annual&limit=3" \
  -H "X-API-KEY: your_api_key_here"

获取单个公司的季度利润表

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519&period=quarterly&limit=4" \
  -H "X-API-KEY: your_api_key_here"

获取多个公司的TTM利润表

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519,000858&period=ttm&limit=1" \
  -H "X-API-KEY: your_api_key_here"

获取指定字段

curl -X GET "https://api.alphafin.x-pai.com/v1/financials/income-statement?symbol=600519&period=annual&fields=report_date,revenue,net_profit,basic_eps&limit=5" \
  -H "X-API-KEY: your_api_key_here"

响应示例

单个公司年报响应

{
  "code": 200,
  "message": "success",
  "data": {
    "symbol": "600519",
    "name": "贵州茅台",
    "income_statements": [
      {
        "report_date": "2022-12-31",
        "report_name": "2022年年报",
        "revenue": 119937778604.24,
        "operating_cost": 16138284220.05,
        "selling_expenses": 5162392622.66,
        "admin_expenses": 5924657180.26,
        "rd_expenses": 601320452.67,
        "financial_expenses": -2729895923.10,
        "interest_expenses": 0.00,
        "interest_income": 2755974908.10,
        "investment_income": 350882136.86,
        "operating_profit": 95191902188.54,
        "non_operating_income": 134989064.48,
        "non_operating_expenses": 53478089.65,
        "profit_before_tax": 95273413163.37,
        "income_tax": 23806665723.61,
        "net_profit": 71466747439.76,
        "net_profit_parent": 71263121099.75,
        "net_profit_minority": 203626340.01,
        "basic_eps": 5.67,
        "diluted_eps": 5.67,
        "comprehensive_income": 71474201439.76,
        "comprehensive_income_parent": 71270575099.75,
        "comprehensive_income_minority": 203626340.01,
        "ebitda": 98329982188.54,
        "gross_profit": 103799494384.19,
        "gross_margin": 86.54,
        "operating_margin": 79.37,
        "net_margin": 59.59,
        "annual_growth_revenue": 16.18,
        "annual_growth_profit": 18.96
      },
      {
        "report_date": "2021-12-31",
        "report_name": "2021年年报",
        "revenue": 103203469169.81,
        "operating_cost": 14224681331.38,
        // 更多字段...
      },
      {
        "report_date": "2020-12-31",
        "report_name": "2020年年报",
        "revenue": 94915380916.90,
        "operating_cost": 16321622105.50,
        // 更多字段...
      }
    ]
  }
}

多个公司TTM响应

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "symbol": "600519",
      "name": "贵州茅台",
      "income_statements": [
        {
          "report_date": "2023-09-30",
          "report_name": "2023年TTM",
          "revenue": 127862735123.78,
          "operating_cost": 17220163352.33,
          "net_profit": 76120345692.38,
          "net_profit_parent": 75892467135.62,
          // 更多字段...
        }
      ]
    },
    {
      "symbol": "000858",
      "name": "五粮液",
      "income_statements": [
        {
          "report_date": "2023-09-30",
          "report_name": "2023年TTM",
          "revenue": 68295764320.91,
          "operating_cost": 24123867220.14,
          "net_profit": 23506789432.56,
          "net_profit_parent": 23126538911.33,
          // 更多字段...
        }
      ]
    }
  ]
}

指定字段响应

{
  "code": 200,
  "message": "success",
  "data": {
    "symbol": "600519",
    "name": "贵州茅台",
    "income_statements": [
      {
        "report_date": "2022-12-31",
        "revenue": 119937778604.24,
        "net_profit": 71466747439.76,
        "basic_eps": 5.67
      },
      {
        "report_date": "2021-12-31",
        "revenue": 103203469169.81,
        "net_profit": 60037631911.96,
        "basic_eps": 4.78
      },
      {
        "report_date": "2020-12-31",
        "revenue": 94915380916.90,
        "net_profit": 46697285429.62,
        "basic_eps": 3.72
      },
      {
        "report_date": "2019-12-31",
        "revenue": 85429537827.66,
        "net_profit": 41206471014.43,
        "basic_eps": 3.28
      },
      {
        "report_date": "2018-12-31",
        "revenue": 73638186125.88,
        "net_profit": 35203625263.59,
        "basic_eps": 2.80
      }
    ]
  }
}

错误码

除了通用错误码外,此接口还可能返回以下错误码:

错误码描述
invalid_symbol无效的股票代码
invalid_period无效的报告期类型
invalid_report_type无效的报表类型
no_data指定条件下无数据
too_many_symbols请求的股票代码数量超过上限(最多支持10个)

注意事项

  1. TTM(Trailing Twelve Months)数据是指最近12个月的滚动数据,适合消除季节性因素分析公司业绩。
  2. 财务数据的更新频率与公司公告时间一致,通常年报在次年4月底前披露,季报在季度结束后一个月内披露。
  3. 不同行业的公司财务科目可能有所不同,部分科目可能为null。
  4. 所有金额数据的单位均为”元”。
  5. 增长率字段在非年报或TTM模式下可能为null。
  6. 历史数据可能因公司重述而与原始披露数据有所不同,我们提供的是最新重述后的数据。

报告期说明

Ashare上市公司需要披露的财报包括:

  • 年报:每年1月1日至12月31日的财务数据,通常在次年4月30日前披露。
  • 半年报:每年1月1日至6月30日的财务数据,通常在当年8月31日前披露。
  • 一季报:每年1月1日至3月31日的财务数据,通常在当年4月30日前披露。
  • 三季报:每年1月1日至9月30日的财务数据,通常在当年10月31日前披露。

使用period=quarterly可获取全部季度报告,包括一季报、半年报、三季报和年报。

相关接口