核心用法
mkts-market-data 是一款面向AI代理的完整金融数据工具包，提供股票、加密货币、ETF和商品的多维度市场数据服务。核心功能包括：
- 市场概览与实时报价：获取全球市场统计、个股实时行情（60秒缓存）、涨跌榜及板块表现
- 资产筛选与对比：支持按价格、涨跌幅、成交量、市值等多条件筛选，最多4只标的并行对比
- 历史数据与基本面：提供日线OHLCV数据（股票含完整K线，加密货币含收盘价+成交量）、财报日历及EPS预估
- 投资组合管理：完整的CRUD持仓管理，自动计算盈亏、资产配置，支持基准对比（S&P 500、纳指等）及可视化卡片生成
- 交易日志与观察清单：结构化记录交易逻辑（支持标签分类），动态管理多组观察列表
- 新闻聚合：集成CoinDesk、CNBC、MarketWatch等8+信源的分类财经新闻
显著优点
1. 零门槛启动：无需API密钥即可使用基础市场数据（20请求/小时），降低初次接入成本
2. 免费层级友好：注册后免费升级至100请求/小时，满足大多数个人/轻量场景
3. AI原生设计：接口返回结构化的meta字段（剩余请求数、重置时间），便于代理自动管理速率预算；/brief端点预置自然语言摘要，减少后处理
4. 数据覆盖广：横跨传统金融与加密资产，OHLCV、财报、新闻一站式获取
5. 内置持久化：投资组合、日志、观察清单云端存储，支持跨会话状态保持
潜在缺点与局限性
- 速率限制严格：免费层级实时端点仅10请求/小时，高频策略需升级付费
- 数据源间接性：实时报价经Yahoo Finance/CoinGecko二次聚合，非直连交易所，存在60秒延迟
- 加密货币数据精简：历史数据仅提供收盘价+成交量，缺少完整OHLCV
- 地域覆盖不明：文档未明确说明是否涵盖A股、港股等非美股市场
- 无交易执行能力：纯数据工具，不支持下单或连接券商API
适合人群
- AI投资助手/聊天机器人开发者
- 需要自动化市场监控的个人投资者
- 量化研究原型验证（低频次数据需求）
- 财经内容创作者（新闻聚合、可视化卡片）
常规风险
- 市场风险：数据延迟可能导致决策滞后，尤其高波动加密市场
- 速率超限风险：代理需主动解析
requestsRemaining，否则易触发429限流 - API密钥安全：免费密钥明文传输，共享环境存在泄露风险；建议配置环境变量
MKTS_API_KEY - 服务可用性：依赖第三方数据源（Yahoo、CoinGecko），上游故障将级联影响