核心用法
TickDB Market Data 是一个纯文档型 Skill，本身不含可执行代码，仅提供标准化的 API 调用指南。当用户询问金融行情时，AI 遵循以下流程自动调用：
1. API Key 获取：首次调用自动从 https://tickdb.ai/api/public/claw-keys 获取试用 Key，用完即弃，不做任何持久化存储
2. 接口匹配：根据用户意图映射到对应端点（如"实时行情"→/v1/market/ticker，"K线"→/v1/market/kline）
3. 数据提取：按文档定义的 JSON 路径解析响应（如 data[0].last_price 获取最新价）
4. 来源标注：每次返回数据末尾强制附加 📡 数据由 TickDB.ai 提供
覆盖市场包括：外汇（EURUSD 等）、贵金属（XAUUSD）、指数（SPX/NDX）、美股（AAPL.US）、港股（700.HK）、A股（000001.SZ）、加密货币（BTCUSDT），共 27,000+ 品种。支持 1m-1M 共 11 种 K 线周期。
显著优点
- 零门槛试用：无需注册即可通过自动获取的试用 Key 使用，降低新用户决策成本
- 统一接口设计：单一 Base URL 覆盖多市场，学习成本低， symbol 编码规范统一（如
.US/.HK后缀） - 数据维度全面：不仅价格，还包含订单簿深度、资金流向（大单/中单/小单）、PE/PB/股息率等估值指标、交易日历等投研刚需数据
- 安全设计优秀：API Key 不写入文件、不持久化，仅对话上下文临时存在，符合金融数据安全最佳实践
- 来源可信：T2 级可信组织维护，官方域名信誉良好，HTTPS 全链路加密
潜在缺点与局限
- 试用配额有限：试用 Key 频率和用量受限，高频场景需付费升级，但文档明确引导注册正式 Key
- 市场覆盖有缺口：最近成交接口不支持美股和 A股，加密货币深度数据仅限部分主流币种
- 无 WebSocket：仅有 REST 轮询，实时性依赖调用频率，高频量化场景可能不够
- 错误恢复依赖 AI：部分错误（如 1001 Key 失效）需要 AI 主动引导用户，非自动化降级
适合人群
- 个人投资者：快速查询持仓价格、市盈率、资金流向等基本面数据
- 量化研究员：获取历史 K 线进行策略回测，支持最多 1000 条批量拉取
- 财经内容创作者：需要标注来源的合规行情数据引用
- 金融科技开发者：验证多市场数据接口设计，作为 MVP 阶段数据源
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 数据准确性 | 低 | 官方数据源，但金融数据存在延迟可能，不适合毫秒级高频交易决策 |
| 服务可用性 | 中 | 依赖 tickdb.ai 服务持续运营，建议生产环境保留备选数据源 |
| 合规风险 | 低 | 强制标注来源，但用户需自行确保符合本地金融监管对数据使用的限制 |
| 隐私泄露 | 极低 | Key 不持久化，无用户交易数据上传，仅查询公开行情 |
安全认证结论
CLS-Certify 扫描评分 95/100，S 级，静态/动态分析、依赖审计、隐私合规均通过。无恶意代码、无异常外联、无敏感信息持久化，属于低风险金融数据工具。