证券与资料 · 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。

可转债集合竞价分时 {#convertible-auction}

单只可转债集合竞价过程曲线（约 09:15–09:25，1 秒一点）。响应形态与 /v1/auction 一致，仅接受可转债代码。

GET /v1/convertible/auction?symbol=110075.SS

参数	必填	说明
symbol	是	可转债标准代码，如 `110075.SS` / `127045.SZ`

权限 auction（与个股集合竞价分时相同）。非可转债代码返回 400。

可转债集合竞价 v2（compact） {#convertible-auction-v2}

可转债集合竞价时段行情，接口形态对齐 /v2/auction，仅覆盖可转债。

GET /v2/convertible/auction?symbol=110075.SS&include_minutes=1
GET /v2/convertible/auction?all=1
GET /v2/convertible/auction?all=1&market=SS
GET /v2/convertible/auction?trade_date=20260724&all=1

参数	必填	说明
symbol	与 all 二选一	批量可转债代码；单次上限同 `/v2/auction`
all	与 symbol 二选一	`1` 拉全市场可转债
market	否	`SS`/`SZ`/`BJ`/`CN`；常与 `all=1` 联用
trade_date	否	`YYYYMMDD`；指定历史交易日；未指定则为当日
include_minutes	否	默认关；显式 `1`/`true` 才带分钟序列

权限 auction_v2。非可转债代码返回 400。

上市公司资料 {#corp}

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

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

复权因子 {#adjust-factors}

不建议使用。 自行复权请用 /v1/adjust-params，按返回的 multiplier / addend 计算（见该节公式）。本接口仅作兼容保留。

GET /v1/adjust-factors?symbol=603778.SS&adjust_type=forward&count=256
GET /v1/adjust-factors?symbol=600519.SS&adjust_type=backward&start=20240101&end=20241231

参数	必填	默认	说明
symbol	是	-	股票代码
adjust_type	否	forward	`forward`（前复权因子）、`backward`（后复权因子）
count	否	-	返回最近 N 条；与 start/end 可组合
start / bdate	否	-	起始日期 YYYYMMDD
end / edate	否	-	结束日期 YYYYMMDD

需 kline 权限；adjust_type 受套餐复权权限限制。

data[] 每项含 date（YYYYMMDD）、factor。换算：复权价 = 原始价 / factor。

除权除息 {#exrights}

GET /v1/exrights?symbol=600519.SS&count=20
GET /v1/exrights?symbol=000001.SZ&start=20200101&end=20241231

参数	必填	默认	说明
symbol	是	-	股票代码
count	否	-	返回最近 N 条；与 start/end 可组合
start / bdate	否	-	起始日期 YYYYMMDD
end / edate	否	-	结束日期 YYYYMMDD

需 kline 权限。

data[] 每项含 date、distribution_ratio（送股比例）、placing_ratio / placing_price（配股）、dividend（每股派息，元）。

复权参数 {#adjust-params}

推荐。 自行复权请用本接口，勿再依赖 /v1/adjust-factors。

GET /v1/adjust-params?symbol=600519.SS&adjust_type=forward&count=64
GET /v1/adjust-params?symbol=000001.SZ&adjust_type=backward&start=20200101

参数	必填	默认	说明
symbol	是	-	股票代码
adjust_type	否	forward	`forward` / `backward`
count	否	-	返回最近 N 条；与 start/end 可组合
start / bdate	否	-	起始日期 YYYYMMDD
end / edate	否	-	结束日期 YYYYMMDD

需 kline 权限；adjust_type 受套餐复权权限限制。

data[] 每项含 date、multiplier、addend。换算：复权价 = (原始价 × multiplier + addend) / 10000；对某根 K 线取第一个晚于该 bar 日期的事件参数（无则恒等 10000 / 0）。当 K 线 meta.adjust_mode=affine 时即按此换算。

增发配股 {#zfpg}

GET /v1/zfpg/tabs
GET /v1/zfpg?type=directional&bdate=2026-01-01&edate=2026-09-10
GET /v1/zfpg/daily?date=2026-09-10&type=all
GET /v1/zfpg/stock?symbol=600519.SS&type=all

需 zfpg 权限（免费版及以上）。

路径	说明
`/v1/zfpg/tabs`	可用类型与默认日期字段
`/v1/zfpg`	按类型 / 区间 / 代码查询
`/v1/zfpg/daily`	指定自然日事件（`date` 必填）
`/v1/zfpg/stock`	单票（`symbol` 必填）

参数	必填	说明
type	否	`all` 全部、`directional` 定向增发、`public` 公开增发、`other` 其他发行、`plan` 增发预案、`rights_execute` 配股实施、`rights_plan` 配股预案；默认 `all`
bdate / edate	否	区间起止日 `YYYY-MM-DD`（按该类型默认日期字段过滤）
date	否	单日（`/daily` 必填）
symbol	否	股票代码（`/stock` 必填）
event_type	否	仅 `type=all`：如 `定向增发`、`公开增发`
date_field	否	覆盖默认日期字段
limit	否	返回条数，默认 `200`，最大 `2000`；超出时 `meta.truncated=true`

data[] 字段因类型而异，常见含 symbol、code、name、update_date；定增/公增另有发行价、发行数量、募资额、上市日、发行对象等。

分红送配 {#yjfp}

GET /v1/yjfp/tabs
GET /v1/yjfp?type=detail&status=plan&bdate=2026-01-01&edate=2026-09-10
GET /v1/yjfp/daily?date=2026-09-10&status=all
GET /v1/yjfp/stock?symbol=600519.SS&status=all

需 yjfp 权限（免费版及以上）。

路径	说明
`/v1/yjfp/tabs`	可用类型与默认日期字段；`meta.status_options` 含预案/已实施
`/v1/yjfp`	按类型 / 状态 / 区间 / 代码查询
`/v1/yjfp/daily`	指定自然日事件（`date` 必填）
`/v1/yjfp/stock`	单票（`symbol` 必填）

参数	必填	说明
type	否	`detail` 分红送配明细（默认）、`report_dates` 报告期列表
status	否	仅 `detail`：`all` 全部、`plan` 分红预案、`implemented` 已实施方案；默认 `all`
bdate / edate	否	区间起止日 `YYYY-MM-DD`（按该类型默认日期字段过滤）
date	否	单日（`/daily` 必填）
symbol	否	股票代码（`/stock` 必填）
date_field	否	覆盖默认日期字段（明细默认 `plan_notice_date`）
limit	否	返回条数，默认 `200`，最大 `2000`；超出时 `meta.truncated=true`

data[] 明细常见含 symbol、name、pretax_bonus_rmb、bonus_ratio、it_ratio、plan_notice_date、ex_dividend_date、status、impl_plan_profile 等。

板块目录 {#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

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