证券与资料 · KlineShare

股票信息 {#stock}

GET /v1/stock?symbol=600519.SS
GET /v1/stocks?keyword=茅台&limit=20
GET /v1/stocks?market=sh&page=1&num=100

路径	参数	说明
`/v1/stock`	symbol	单只查询，如 `603778.SS`
`/v1/stocks`	keyword, market, limit	按名称或代码搜索，最多 200 条
`/v1/stocks`	market, page, num	分页列表；market 可选 sh、sz、bj

/v1/stock 响应 data 含 symbol、code、name、market、update_time。/v1/stocks 搜索时 data 为数组；分页时 meta 含 page、count、total、market，以及可选 list.update_time / list.total_stocks。

ETF 专用接口 {#etf}

响应 meta.instrument_type 恒为 etf。部分新上市 ETF 可能暂不可用。

沪深 ETF 与 A 股个股强制拆分：清单、基本信息、实时、分时、K 线均须走 /v1/etf* 路径。个股/指数接口对 ETF 代码返回 400。

权限：专业版及以上（pro / premium）。免费版、基础版返回 403。

GET /v1/etf?symbol=515250.SS
GET /v1/etfs?keyword=智能汽车&limit=20
GET /v1/etf/realtime?symbol=515250.SS
GET /v1/etf/trend?symbol=515250.SS
GET /v2/etf/kline?symbol=515250.SS,510300.SS&period=86400&count=120
GET /public/v1/etf/schema

路径	scope	说明
`/v1/etf`	etf	单只 ETF 基本信息；symbol 如 `515250.SS`、`159915.SZ`，亦支持 6 位代码
`/v1/etfs`	etf	搜索（keyword）或分页列表；支持 `market`（sh/sz）、`category` 筛选
`/v1/etf/realtime`	etf_realtime	实时行情；可选 `include_valuation`（`etf_realtime_valuation`）、`include_depth`（`etf_realtime_depth`）；symbol 批量规则同个股
`/v1/etf/trend`	etf_trend	分时（可选 date=YYYYMMDD）
`/v2/etf/kline`	etf_kline	K 线（最多 5）；参数与响应格式同 `/v2/kline`
`/v1/etf/kline`	etf_kline	过时，请用 `/v2/etf/kline`

字段说明见 GET /public/v1/etf/schema（无需 Key）。

债券专用接口 {#bond}

沪/深/京现券（可转债 / 国债 / 企债）清单与行情独立于板块目录与个股接口，按 kind 分路径。

清单 scope：bond；行情：bond_realtime / bond_trend；K 线：convertible_kline（可转债 K 线 v2）与 bond_kline（国债/企债单券）。字段说明：GET /public/v1/bond/schema（无需 Key）。

现券叶子板：sh_gz / sh_qz / sh_kzz、sz_*、bj_*；并集别名板 hskzz_z / gz_z。

GET /v1/convertible?symbol=110075.SS
GET /v1/convertible/profile?symbol=113704.SS
GET /v1/convertible/profile?symbol=113704.SS&sections=all
GET /v1/convertibles?num=100
GET /v1/treasury?symbol=019766.SS
GET /v1/treasury/profile?symbol=019766.SS&sections=basic,issue
GET /v1/treasuries?num=100
GET /v1/enterprise?symbol=111077.SS
GET /v1/enterprises?board=sh_qz&num=100
GET /v1/convertible/boards/sh_kzz/members?limit=200
GET /v1/treasury/realtime?symbol=019766.SS
GET /v2/convertible/kline?symbol=110075.SS,113704.SS&period=86400&count=120

路径族	scope	说明
`/v1/convertible*`（除 K 线）	bond / bond_realtime / bond_trend	可转债；kind 不匹配 → 404
`/v2/convertible/kline`	convertible_kline	可转债 K 线 v2（最多 5 个 symbol）
`/v1/treasury*`	bond / 行情；K 线为 bond_kline	国债
`/v1/enterprise*`	同上	企债

概况：未传 sections 时仅返回 data.summary；sections=basic,issue,… 或 sections=all 按需扩段。转债可用 convert / clauses / exercises / price_changes / put_call / ballot / invest；国债/企债请求转债专用段时记入 meta.ignored_sections。

列表 / 搜索、板块成分、国债/企债 K 线为列式响应：fields + data。可转债 K 线：GET /v2/convertible/kline（最多 5 只，格式同 /v2/kline）；国债/企债：/v1/treasury|enterprise/kline。

上市公司资料 {#corp}

GET /v1/corp?symbol=600519.SS
GET /public/v1/corp/schema

路径 / 参数	必填	说明
`/v1/corp` · symbol	是	股票代码，如 `600519.SS`
`/public/v1/corp/schema`	-	字段说明（无需 Key）

板块目录 {#catalog}

行业/概念分类与站内板块、指数成分（scope：catalog）。

GET /v1/catalog/nodes
GET /v1/catalog/nodes/{node}
GET /v1/catalog/nodes/{node}/children
GET /v1/catalog/nodes/{node}/members
GET /v1/catalog/plates
GET /v1/catalog/plates/{plate_id}/members
GET /v1/catalog/indices
GET /v1/catalog/indices/{code}/members
GET /v1/catalog/stocks/{symbol}

分类像文件夹：先选体系 → 再进下级 → 末级查成分股。

财报四表 {#finance}

GET /v1/finance/report?symbol=600519.SS
GET /v1/finance/report?symbol=600519.SS&source=income,balance&periods=4
GET /v1/finance/report?symbol=600519.SS&year=2025
GET /v1/finance/report?symbol=600519.SS&years=3
GET /v1/finance/report?symbol=600519.SS&period=2025Q1
GET /public/v1/finance/schema

路径 / 参数	必填	说明
`/v1/finance/report` · symbol	是	股票代码，如 `600519.SS`
source	否	逗号分隔：`metrics` 关键指标、`income` 利润表、`balance` 资产负债表、`cashflow` 现金流量表；默认四表；可选 `special` 专项指标
periods	否	最近几期，默认 `8`，最大 `40`；传 `0` 返回全部
year	否	自然年 `YYYY`，返回该年全部报告期
years	否	最近几个自然年（1–20）；与 `year` 同时传时以 `year` 为准
period	否	单期：`YYYYMMDD`、`2025Q1`、`2025H1`、`2025A`；指定后优先于上述范围参数
`/public/v1/finance/schema`	-	表类型与字段结构说明（无需 Key）

需 finance 权限（免费版及以上）。data.reports.<source>.values.<report_date>.<field> 为 {value, yoy}；字段中文名见同表 fields。每期含 year、period_type（Q1/H1/Q3/A）、label 等。

交易日历 {#calendar}

GET /v1/calendar
GET /v1/calendar?date=20250620
GET /v1/calendar?start=20250101&end=20250630

参数	必填	说明
date	否	指定日期 YYYYMMDD，返回是否交易日及前后相邻交易日
start, end	否	日期区间（须同时提供），最多 366 天
window	否	无参数时的前后窗口天数，默认 30，最大 90

无参数时返回最近/下一交易日及窗口内交易日列表，并附带交易时段配置。