A-Share Endpoints

GET /api/v1/stock/spot

Real-time A-Share spot data snapshot.

Query Parameters:

Parameter	Type	Filter Type	Description
code	string	exact	Stock code
industry	string	exact	Industry name
source	string	exact	Data source
name	string	like	Stock name (fuzzy)

Example:

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/stock/spot?industry=半导体&limit=10"

GET /api/v1/stock/financials

Stock financial statement metrics.

Query Parameters:

Parameter	Type	Filter Type	Description
code	string	exact	Stock code
report_date	string	exact	Report date (YYYY-MM-DD)
report_type	string	exact	Report type
metric	string	exact	Metric name
source	string	exact	Data source
date_from	string	date range	Start date
date_to	string	date range	End date

GET /api/v1/stock/industry-sw

Shenwan industry classification.

Query Parameters:

Parameter	Type	Filter Type	Description
code	string	exact	Stock code
industry_code	string	exact	Industry code
source	string	exact	Data source
name	string	like	Stock name (fuzzy)