鉴权 {#auth}

除 GET /v1/health、本文档与 /public/v1/* 元数据外，数据接口均需 API Key。

GET /v1/realtime?symbol=603778.SS
X-API-Key: tg_xxxxxxxxxxxxxxxxxxxxxxxx

也支持查询参数 ?api_key=tg_xxx（不推荐，易泄露到日志）。Key 在用户中心签发，完整 Key 仅显示一次。

权限说明 {#permissions}

权限分两层：接口权限（scope） 与 K 线数据策略。

接口权限 {#permissions-scopes}

未开通相应 scope 时返回 403。各套餐接口差异见 GET /public/v1/catalog 的 scope_rows（含各档位 ✓/— 对照）与 tier_columns。

K 线数据策略 {#permissions-kline}

在拥有 kline scope 的前提下，限制可请求的周期、条数、复权方式与技术指标。超出套餐上限时条数会自动裁切。GET /v1/me 可查看当前 Key 的 kline 摘要。

账号状态 {#permissions-account}

• 用户中心「接口测试」无有效 Key → 403
• 账号已过期 → 401
• 账号或 Key 已禁用 → 401 / 403

限流规则 {#rate-limit}

采用每分钟固定窗口计数：全局限流（账号下所有接口合计）与各 scope 分接口限流。触发限流返回 429，响应含 retry_after（秒），Header 含 Retry-After。