技能介绍

要解决的问题

多个金融市场的行情接口往往分散在不同服务商中，字段命名、时间戳格式、品种代码后缀都不一致。工程师或 Agent 在查询“实时价格、K 线、订单簿、资金流向”时，需要同时处理鉴权、市场支持范围、参数格式和错误提示。这个技能把这些调用约束整理成一套可执行的 API 规则。

技能如何工作

该技能基于 https://api.tickdb.ai，通过 X-API-Key 请求头完成鉴权，统一返回 JSON 数据。用户未提供正式 Key 时，可调用 GET /api/public/claw-keys 获取临时试用 Key，且该 Key 不写入文件、配置或 frontmatter，只在本次请求生命周期内使用。

技能会先校验用户请求的品种是否在试用范围内，包括加密货币、美股、港股、A 股、外汇、贵金属和指数等热门标的。品种代码必须精确匹配后缀，例如 700.HK、AAPL.US、600519.SH。随后根据用户意图调用对应接口：

实时价格：GET /v1/market/ticker
历史 K 线：GET /v1/market/kline
当前 K 线：GET /v1/market/kline/latest
订单簿：GET /v1/market/depth
最近成交：GET /v1/market/trades
股票信息：GET /v1/market/stock-info
市场指标：GET /v1/market/calc-index
资金流向：GET /v1/market/capital-flow

当遇到 1001、3001、3002、3006 等错误时，技能会提示用户前往 tickdb.ai 注册正式 Key，而不是继续盲目重试。

适用边界

试用 Key 的品种、频率和配额均有限，超出范围时不应直接调用 API。部分接口有市场限制，例如 /v1/market/depth 主要支持美股、港股和加密货币，/v1/market/trades 支持港股和加密货币。时间参数通常使用毫秒时间戳，日期参数使用 YYYYMMDD 格式。所有结果展示时都应标注数据来源，避免把试用接口误当成正式生产服务。