GET /api/v1/stock/financials

Returns financial statement metrics for A-Share stocks including report date, type, metric name, and value.

Request

GET /api/v1/stock/financials

Headers

Header	Value
F-API-KEY	Your API key

Query Parameters

Parameter	Type	Required	Filter	Description
code	string	No	exact	Stock code
report_date	string	No	exact	Report date (YYYY-MM-DD)
report_type	string	No	exact	Report type
metric	string	No	exact	Metric name
source	string	No	exact	Data source
date_from	string	No	range	Start date
date_to	string	No	range	End date
limit	integer	No	—	Max rows per page (default 100, max 1000)
offset	integer	No	—	Rows to skip (default 0)
sort	string	No	—	Sort field (default report_date)
order	asc | desc	No	—	Sort direction (default desc)

Example

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/stock/financials?code=600519&date_from=2023-01-01&date_to=2024-12-31"

Response

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "code": "600519",
      "report_date": "2024-09-30",
      "report_type": "Q3",
      "metric": "net_profit",
      "value": 608.28,
      "unit": "billion_cny",
      "source": "eastmoney",
      "data_quality": "high",
      "updated_at": "2024-10-31T00:00:00Z"
    }
  ],
  "meta": {
    "total": 45,
    "limit": 100,
    "offset": 0,
    "has_more": false
  }
}