核心用法
mkts-market-data 是一个综合性的金融市场数据聚合技能，通过统一API接口提供多资产类别的实时与历史数据查询。核心功能涵盖：
市场数据查询：支持股票、加密货币、ETF、大宗商品四大资产类型，提供资产列表筛选（按类型/板块/市值/涨跌幅）、单资产详情、实时报价（对接Yahoo Finance/CoinGecko）、历史OHLCV数据等。
组合投资管理：完整的CRUD操作，包括持仓录入（支持成本价、购买日期、备注）、实时盈亏计算（含日变动）、资产配置分析、业绩对比（可对标S&P 500、QQQ、BTC等基准生成统一图表），以及生成分享卡片（1200×630 PNG）。
辅助工具：板块表现聚合、多空筛选器（支持价格/涨跌幅/市值/成交量范围条件）、财报日历（实时查询或预缓存周视图）、财经新闻RSS聚合（CoinDesk/CNBC等源）、交易日志（支持标签分类：thesis/lesson/mistake/buy/sell等）、多 watchlist 管理。
显著优点
- 零门槛入门：无需API Key即可使用基础行情端点（20请求/小时/IP），降低试用成本
- 多源聚合：智能路由至Yahoo Finance（股票/ETF）和CoinGecko（加密），自动处理数据标准化
- Agent友好设计：
/v1/brief端点聚合市场概览+涨跌排行+板块摘要+自然语言亮点，单次调用满足晨会简报需求 - 元数据透明：所有响应包含
meta.requestsRemaining和resetTime，便于客户端自主限流管理 - 写入端点丰富：少有的支持投资组合持久化、交易日志、观察名单的免费级金融API
潜在局限与风险
数据层级差异：加密货币历史数据仅提供收盘价+成交量，缺少开盘/最高/最低价，技术分析场景受限。股票数据完整但来源依赖Yahoo Finance，存在延迟（非真正实时，60秒缓存）。
速率限制严格：免费Key仅100请求/小时（快照）/10请求/小时（实时），"实时"端点（/live）单独限流更严，高并发场景易触发429。
地域与合规：未明确数据许可范围，Yahoo Finance条款限制商业再分发；无Level 2订单簿数据，不适合高频策略。
账户端点风险：Portfolio/Journal/Watchlist端点强制API Key认证，返回 Cache-Control: private, no-store，代理层需确保不缓存用户敏感持仓数据。
适合人群
- 个人投资者/量化爱好者：构建自动化盯盘、定投提醒、盈亏报表工具
- AI Agent开发者：为LLM提供结构化金融数据，支持自然语言问答（"我今年的收益跑赢标普了吗？"）
- 内容创作者：利用
/v1/portfolio/card生成社交媒体分享图，/v1/brief快速获取市场摘要
常规风险提示
⚠️ 非投资级数据源：标注为"实时"实为60秒缓存聚合，延迟高于专业终端（Bloomberg/Refinitiv），不适用于毫秒级决策。
⚠️ API Key管理：免费Key注册仅显示一次，需妥善保存；Max 3 keys/email，团队共享需规划分配。
⚠️ 合规边界：新闻数据来自RSS聚合，需注意来源版权声明；组合数据存储于mkts服务端，敏感持仓需评估信任模型。
⚠️ 限流容错：生产集成必须实现429响应的 Retry-After 退避逻辑，建议使用 /v1/brief 替代多轮单资产查询以减少请求量。