# KlineShare 行情 API 参考
A 股**实时行情**、**分时图**、多周期 **K 线**、**股票信息**、**上市公司资料**、**财报四表**、**交易日历**、**涨停专题**、**龙虎榜**、**游资名录**；沪深 ETF 走专用 `/v1/etf*` 路径。基础地址：`/v1`。

套餐档位、scope 与主要指数列表为动态配置，以 `GET /public/v1/catalog` 为准。

## 怎么用文档
左侧 **数据接口** 与用户中心「接口测试」同分类、同入口名。
点击某一项打开该接口的**使用说明**（参数、字段、示例）。

| 文档分区 | 内容 |
|------|------|
| [行情与 K 线](/docs/market) | compact / 沪深 / 北交所 / 竞价 / 指数 / 分时 / K 线 |
| [扩展行情](/docs/extended) | 贵金属、期货、全球指数/债券、站内板块 |
| [证券与资料](/docs/instruments) | ETF、债券、资料、日历 |
| [专题数据](/docs/topics) | 涨停、异动、快讯、龙虎榜、资金流 |

## 健康检查
```http
GET /v1/health
```

无需 Key。响应示例：

```json
{ "success": true, "version": "1" }
```

## 错误码
| HTTP | 含义 | 常见原因 |
|------|------|----------|
| 400 | 参数错误 | 缺少 symbol、period 无效、ETF 走错路径等 |
| 401 | 未授权 | Key 无效、账号过期、Key 已吊销 |
| 403 | 无权限 | 未开通 scope，或 K 线周期/复权不在套餐内 |
| 404 | 未找到 | 股票或公司资料暂无数据 |
| 429 | 限流 | 超过每分钟调用上限 |
| 503 | 服务不可用 | 游资名录等依赖数据暂不可用 |
| 500 | 服务器错误 | 服务暂时不可用 |

错误响应示例：

```json
{ "success": false, "code": 403, "message": "说明文字" }
```

成功响应示例：

```json
{
  "success": true,
  "data": { "...": "业务字段" },
  "meta": { "symbol": "603778.SS" }
}
```