核心用法
mkts-market-data 是一个功能全面的金融市场数据查询工具，支持通过 REST API 获取股票、加密货币、ETF和大宗商品的实时与历史数据。核心功能包括：
市场数据查询：支持资产列表筛选（按类型、板块、市值）、单资产详情、实时报价（60秒缓存）、涨跌排行、板块表现对比。特别提供 /v1/brief 端点，一键获取全球市场摘要、涨跌前五、板块概览和自然语言 highlights，适合快速市场简报。
技术分析工具：包含历史价格 OHLCV 数据（股票支持完整开高低收量，加密货币仅收量）、收益日历（EPS预估、实际值、惊喜百分比）、多资产对比 /v1/compare。筛选器 /v1/screen 支持复杂条件如"跌幅超3%且市值>100亿"。
投资组合管理（需API密钥）：完整的 CRUD 功能，包括持仓读写、盈亏计算、资产配置、业绩对比基准（SPY、QQQ、BTC等）、生成分享卡片（1200×630 PNG）。交易日志 /v1/journal 支持标签分类（thesis、lesson、mistake等），自选股 /v1/watchlist 支持动态增删符号。
显著优点
- 零门槛启动：无需注册即可使用基础市场数据（20请求/小时），降低尝鲜成本
- 统一聚合层：整合 Yahoo Finance（股票/ETF/大宗商品）和 CoinGecko（加密货币）数据源，自动路由
- Agent 友好设计：JSON 响应格式统一，含
meta.requestsRemaining预算提示、/v1/brief预格式化摘要、详细错误码（429带Retry-After） - 个人投资闭环：从行情→筛选→持仓→日志→分享的完整工作流，API密钥隔离多用户数据
- 灵活筛选语法：支持价格、涨跌幅、成交量、市值的多维度范围查询
潜在局限与风险
数据层依赖：作为聚合层，非原生交易所直连，存在上游延迟（60秒缓存）和单点故障风险。Yahoo Finance 和 CoinGecko 的免费额度政策变动可能影响服务稳定性。
速率限制严格：免费层级100请求/小时对高频场景（如实时监控多资产组合）可能吃紧，实时报价端点更严格（仅10请求/小时）。Keyless 模式仅20请求/小时，易触发429。
功能边界：加密货币历史数据仅收盘价+成交量，无完整OHLCV；收益日历不支持加密货币/大宗商品；部分端点如 /live 明确标注"stricter rate limits"，需特别注意配额管理。
安全考量：API密钥注册仅需邮箱，无强制验证，存在滥用风险。Portfolio/Journal/Watchlist 端点返回 Cache-Control: private, no-store，但文档未说明传输层是否强制 TLS、密钥存储是否加密、或审计日志保留策略。security_level 评估为 A（功能成熟但缺乏安全审计细节）。
适合人群
- 个人投资者构建自动化投研工作流
- 开发者快速集成市场数据到 AI Agent 或聊天机器人
- 轻量级量化策略回测（历史数据支持）
- 社交媒体内容创作者（分享卡片生成功能）
常规风险
- 速率超限导致服务中断：需实现
meta.requestsRemaining监控和指数退避重试 - 数据源漂移：聚合层字段映射变更可能影响下游解析
- API密钥泄露：免费注册无强验证，密钥若硬编码存在泄露风险
- 监管合规：金融数据使用需遵守 Yahoo Finance/CoinGecko 服务条款，不得用于实时交易执行系统