股票信息 {#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 /v1/etf/kline?symbol=515250.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 | 实时行情；symbol 可重复传参或逗号/分号分隔；单次上限见套餐（基础 20、专业 40、旗舰 60） |
/v1/etf/trend | etf_trend | 分时（可选 date=YYYYMMDD） |
/v1/etf/kline | etf_kline | K 线（参数同 K 线接口） |
字段说明见 GET /public/v1/etf/schema（无需 Key）。/v1/etf 的 data 含 symbol、code、sname、category、benchmark、aum 等；实时/分时/K 线响应结构与对应个股接口相同。
上市公司资料 {#corp}
GET /v1/corp?symbol=600519.SS
GET /public/v1/corp/schema| 路径 / 参数 | 必填 | 说明 |
|---|---|---|
/v1/corp · symbol | 是 | 股票代码，如 600519.SS |
/public/v1/corp/schema | - | 字段说明（无需 Key） |
交易日历 {#calendar}
GET /v1/calendar
GET /v1/calendar?date=20250620
GET /v1/calendar?start=20250101&end=20250630| 参数 | 必填 | 说明 |
|---|---|---|
| date | 否 | 指定日期 YYYYMMDD，返回是否交易日及前后相邻交易日 |
| start, end | 否 | 日期区间（须同时提供），最多 366 天 |
| window | 否 | 无参数时的前后窗口天数，默认 30，最大 90 |
无参数时返回最近/下一交易日及窗口内交易日列表，并附带交易时段配置。