财务报表

财务报表模块，提供 A 股整体合并报表（consolidated）多期序列，覆盖利润表、资产负债表、现金流量表。 三个接口入参契约完全一致，仅返回字段不同（见各自小节）。 所有接口均返回统一响应信封 ApiResponse，业务错误经 code 字段表达，HTTP 状态码恒为 200。

通用约定

• Base URL：https://fuyao.aicubes.cn。
• 必需请求头：X-api-key，缺失或无效返回 code=2001。
• 时间戳字段统一为毫秒级 Unix 时间戳，时区按 Asia/Shanghai。
• 所有金额字段单位为原币元，basic_eps 单位为元/股（量级远小于金额字段，不可做单位换算）；A 股币种恒为 CNY。
• 字段为 null 表示「该期未披露」，透传不补零。

取数模式

三个接口共用两种取数模式，互斥、二选一：

模式	触发条件	行为
最近 N 期	不传 start / end	返回最近 limit 期，按 period_end 降序。
时间区间	同时传 start + end（毫秒戳）	返回 [start, end] 闭区间内全部报告期，按 period_end 降序。

同时传 start/end 与 limit，或仅传 start、仅传 end（半开区间），返回 code=1004。

共有请求参数

参数	位置	类型	必需	说明	默认值
thscode	query	string	是	单只标的 thscode，不接受逗号；含交易所后缀（如 600519.SH / 000858.SZ / 430047.BJ）。	-
period	query	enum	是	报告期类型：annual(仅 Q4 报告期) / quarterly(每个季度末)。	annual
limit	query	integer	否	最近 N 期模式：默认 4，范围 [1, 20]。与 start/end 互斥。	4
start	query	long	否	时间区间模式：起始毫秒戳，需与 end 同传；窗口跨度不超过 10 年。	-
end	query	long	否	时间区间模式：结束毫秒戳，end >= start。	-

共有响应字段

每条 item 都含以下元数据字段，data.timestamp 取响应中最大的 period_end_ms：

字段	类型	说明
thscode	string	带交易所后缀的完整 thscode。
ticker	string	纯代码（不含后缀）。
period	enum	入参 period 回显。
fiscal_year	int	财年（自然年）。
fiscal_period	string	FY / Q1 / Q2 / Q3 / Q4。
report_date_ms	long	披露日（毫秒）。
period_end_ms	long	报告期末（Asia/Shanghai 零点毫秒戳）。
currency	string	币种，A 股恒为 CNY。

利润表

GET /api/a-share/financials/income-statements

MCP Tool：get_a_share_financials_income_statements

A 股整体合并利润表多期序列。取数模式与参数见上文。

请求示例

# 最近 3 期年报
curl 'https://fuyao.aicubes.cn/api/a-share/financials/income-statements?thscode=600519.SH&period=annual&limit=3' \
  -H 'X-api-key: <your-api-key>'

# 2023Q1–2024Q4 全部季报（时间区间模式）
# start = 2023-01-01 00:00:00+08:00 → 1672502400000
# end   = 2024-12-31 00:00:00+08:00 → 1735574400000
curl 'https://fuyao.aicubes.cn/api/a-share/financials/income-statements?thscode=600519.SH&period=quarterly&start=1672502400000&end=1735574400000' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "e5f6g7h8",
  "data": {
    "timestamp": 1735574400000,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "period": "annual",
        "fiscal_year": 2024,
        "fiscal_period": "FY",
        "report_date_ms": 1735574400000,
        "period_end_ms": 1735574400000,
        "currency": "CNY",
        "operating_income": 174144000000,
        "operating_costs": 13000000000,
        "operating_expenses": 50000000000,
        "sales_fee": 5000000000,
        "manage_fee": 9000000000,
        "research_and_development_expenses": 150000000,
        "operating_profit": 124000000000,
        "interest_expenses": 0,
        "profit_total": 124000000000,
        "income_tax_expense": 31000000000,
        "net_profit": 93000000000,
        "parent_holder_net_profit": 86000000000,
        "basic_eps": 68.50
      }
    ]
  }
}

利润表附加字段

字段	类型	说明
operating_income	number	营业收入（原币元）。
operating_costs	number	营业成本（原币元）。
operating_expenses	number	营业总成本（原币元）。
sales_fee	number	销售费用（原币元）。
manage_fee	number	管理费用（原币元）。
research_and_development_expenses	number	研发费用（原币元）。
operating_profit	number	营业利润（原币元）。
interest_expenses	number	利息费用（原币元）。
profit_total	number	利润总额（原币元）。
income_tax_expense	number	所得税费用（原币元）。
net_profit	number	净利润（原币元）。
parent_holder_net_profit	number	归属于母公司股东的净利润（原币元）。
basic_eps	number	基本每股收益（元/股）。

资产负债表

GET /api/a-share/financials/balance-sheets

MCP Tool：get_a_share_financials_balance_sheets

A 股整体合并资产负债表多期序列。取数模式与参数同利润表。

请求示例

# 五粮液最近 4 期季报（默认 limit=4）
curl 'https://fuyao.aicubes.cn/api/a-share/financials/balance-sheets?thscode=000858.SZ&period=quarterly' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "f6g7h8i9",
  "data": {
    "timestamp": 1735574400000,
    "item": [
      {
        "thscode": "000858.SZ",
        "ticker": "000858",
        "period": "quarterly",
        "fiscal_year": 2024,
        "fiscal_period": "Q4",
        "report_date_ms": 1735574400000,
        "period_end_ms": 1735574400000,
        "currency": "CNY",
        "assets_total": 250000000000,
        "total_current_assets": 200000000000,
        "non_current_nets_total": 50000000000,
        "cash": 130000000000,
        "accounts_receivable": 500000000,
        "total_debt": 60000000000,
        "holder_equity_total": 190000000000
      }
    ]
  }
}

资产负债表附加字段

字段	类型	说明
assets_total	number	资产总计（原币元）。
total_current_assets	number	流动资产合计（原币元）。
non_current_nets_total	number	非流动资产合计（原币元）。
cash	number	货币资金（原币元）。
accounts_receivable	number	应收账款（原币元）。
total_debt	number	负债合计（原币元）。
holder_equity_total	number	所有者权益（股东权益）合计（原币元）。

现金流量表

GET /api/a-share/financials/cash-flow-statements

MCP Tool：get_a_share_financials_cash_flow_statements

A 股整体合并现金流量表多期序列。取数模式与参数同利润表。

请求示例

# 茅台 2020–2024 全部年报（时间区间模式）
# start = 2020-01-01 00:00:00+08:00 → 1577808000000
# end   = 2024-12-31 00:00:00+08:00 → 1735574400000
curl 'https://fuyao.aicubes.cn/api/a-share/financials/cash-flow-statements?thscode=600519.SH&period=annual&start=1577808000000&end=1735574400000' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "g7h8i9j0",
  "data": {
    "timestamp": 1735574400000,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "period": "annual",
        "fiscal_year": 2024,
        "fiscal_period": "FY",
        "report_date_ms": 1735574400000,
        "period_end_ms": 1735574400000,
        "currency": "CNY",
        "act_cash_flow_net": 92000000000,
        "invest_cash_flow_net": -3000000000,
        "financing_cash_flow_net": -65000000000,
        "pay_fixed_assets_etc_cash": 3500000000,
        "pay_dividends_profits_interest_cash": 64000000000,
        "cash_equivalents_net_addition": 24000000000
      }
    ]
  }
}

现金流量表附加字段

字段	类型	说明
act_cash_flow_net	number	经营活动产生的现金流量净额（原币元）。
invest_cash_flow_net	number	投资活动产生的现金流量净额（原币元）。
financing_cash_flow_net	number	筹资活动产生的现金流量净额（原币元）。
pay_fixed_assets_etc_cash	number	购建固定资产、无形资产和其他长期资产支付的现金（原币元）。
pay_dividends_profits_interest_cash	number	分配股利、利润或偿付利息支付的现金（原币元）。
cash_equivalents_net_addition	number	现金及现金等价物净增加额（原币元）。