核心用法
TickDB Market Data 是一款纯文档型 Skill,为用户提供统一金融市场数据查询指南。用户需先在 https://tickdb.ai 免费注册获取 API Key,通过 HTTP Header X-API-Key 调用 TickDB 官方 API(https://api.tickdb.ai)。支持市场涵盖外汇(EURUSD 等)、贵金属(XAUUSD 等)、全球指数(SPX/NDX 等)、美股(AAPL.US 等)、港股(700.HK 等)、A股(000001.SH 等)及加密货币(BTCUSDT 等)七大类,产品总数超 27,000 个。
主要接口包括:行情快照(/v1/market/ticker)获取实时价格与24h涨跌;历史K线(/v1/market/kline)与实时K线(/v1/market/kline/latest)支持1m至1M多周期技术分析;订单簿深度(/v1/market/depth)展示买卖盘挂单;股票信息(/v1/market/stock-info)提供基本面数据如PE、PB、股息率;当日分时(/v1/market/intraday)捕捉分钟级走势;市场指标(/v1/market/calc-index)综合估值、换手率、资金流向;资金流向(/v1/market/capital-flow)追踪主力/大单/中单/小单动态。
显著优点
数据覆盖全面:单接口聚合全球多市场数据,无需切换多个数据源,大幅降低集成成本。免费入门门槛低:无需信用卡即可注册获取 API Key,适合个人开发者与量化策略研究。技术文档完善:提供 Python 示例代码、curl 命令、响应字段解析及时间参数处理指南,上手周期短。多维度数据:除价格外,包含估值指标、资金流向、交易时段等深度数据,支持从行情展示到量化分析的多层需求。
潜在缺点与局限性
API Key 依赖:所有请求强制携带有效 Key,过期或无效时返回 401 错误,中断服务体验。免费额度未明示:文档未详细说明免费 tier 的调用频率与数据条数限制,存在隐性配额耗尽风险。部分市场限制:最近成交接口不支持美股和 A股,订单簿深度仅限美股、港股、加密货币。实时性依赖外部:数据质量与延迟取决于 TickDB 官方服务,Skill 本身无缓存或降级机制。纯文档无自动化:Skill 仅提供调用指南,不自动执行请求,用户需自行编写代码处理网络异常、重试、数据解析。
适合人群
- 个人投资者:需要快速查询多市场实时价格与基本面估值
- 量化开发者:构建策略回测、技术指标计算、自动化交易系统
- 金融科技产品团队:集成行情数据至 App/小程序/网站,减少多源对接成本
- 教育研究人员:获取标准化历史数据用于金融建模与学术研究
常规风险
- API Key 泄露风险:Key 硬编码或误提交至代码仓库可能导致账户被盗用,建议采用环境变量存储
- 配额超限:高频调用可能触发 3001(频率超限)或 3002(配额用尽)错误,需合理规划请求策略
- 数据延迟:行情数据非交易所直连,存在毫秒级延迟,不适合高频套利场景
- 服务可用性:依赖 TickDB 官方服务稳定性,建议实现本地缓存与异常降级机制
- 合规边界:Skill 不提供投资建议,用户需自行承担交易决策风险