KlineShare 行情 API 参考 {#overview}
A 股实时行情、分时图、多周期 K 线、股票信息、上市公司资料、财报四表、交易日历、涨停专题、龙虎榜、游资名录;沪深 ETF 走专用 /v1/etf* 路径。基础地址:/v1。
套餐档位、scope 与主要指数列表为动态配置,以 GET /public/v1/catalog 为准。
怎么用文档 {#how-to}
左侧 数据接口 与用户中心「接口测试」同分类、同入口名。 点击某一项打开该接口的使用说明(参数、字段、示例)。
| 文档分区 | 内容 |
|---|---|
| 行情与 K 线 | compact / 沪深 / 北交所 / 竞价 / 指数 / 分时 / K 线 |
| 扩展行情 | 贵金属、期货、全球指数/债券、站内板块 |
| 证券与资料 | ETF、债券、资料、日历 |
| 专题数据 | 涨停、异动、快讯、龙虎榜、资金流 |
健康检查 {#health}
GET /v1/health无需 Key。响应示例:
{ "success": true, "version": "1" }错误码 {#errors}
| HTTP | 含义 | 常见原因 |
|---|---|---|
| 400 | 参数错误 | 缺少 symbol、period 无效、ETF 走错路径等 |
| 401 | 未授权 | Key 无效、账号过期、Key 已吊销 |
| 403 | 无权限 | 未开通 scope,或 K 线周期/复权不在套餐内 |
| 404 | 未找到 | 股票或公司资料暂无数据 |
| 429 | 限流 | 超过每分钟调用上限 |
| 503 | 服务不可用 | 游资名录等依赖数据暂不可用 |
| 500 | 服务器错误 | 服务暂时不可用 |
错误响应示例:
{ "success": false, "code": 403, "message": "说明文字" }成功响应示例:
{
"success": true,
"data": { "...": "业务字段" },
"meta": { "symbol": "603778.SS" }
}