MarketPulse

OpenClaw Market（MarketPulse）是一款面向自主智能体的综合金融市场数据查询工具，通过单一的AIsa API密钥即可获取股票、加密货币及传统金融指标的全方位数据支持。该技能为开发者和分析师提供了从实时价格快照到历史财务报表的完整数据链路，覆盖美股、加密货币等多个资产类别，支持分钟级到年度的多时间粒度查询。

核心用法上，用户可通过Python客户端或直接调用REST API获取数据。对于股票数据，支持查询历史价格（支持秒、分钟、日、周、月、年级别）、公司新闻、三大财务报表（利润表、资产负债表、现金流）、财务指标快照、分析师EPS预期、内幕交易、机构持仓及SEC文件等深度信息。加密货币方面，提供BTC、ETH等主流币种的实时价格和历史OHLCV数据。此外还包含股票筛选器（支持PE比率、收入增长等条件筛选）和利率数据查询功能。所有API端点均通过Bearer Token认证，返回JSON格式数据并附带计费信息。

显著优点包括跨资产类别的数据整合能力，用户可在单一接口下同时监控股票和加密货币投资组合；数据覆盖面广，不仅包含基础价格数据，还涵盖内幕交易、机构持仓等专业级金融信息；使用门槛低，提供完善的Python命令行工具和curl示例；计费模式透明，每次响应均包含成本消耗和剩余额度提示，便于成本控制。

潜在局限性方面，作为T3来源的社区项目，其长期维护稳定性和企业级SLA保障存在不确定性；完全依赖外部AIsa API服务，若该服务出现中断或数据延迟，将直接影响技能可用性；采用按量付费模式，高频查询可能产生显著费用，不适合高频交易场景；网络请求设置60秒超时，在网络不稳定环境下响应可能较慢。

适合的目标群体包括：需要进行投资研究的个人投资者和金融分析师，可利用其获取财报、分析师预期和内幕交易数据；构建投资组合监控工具的开发者，可通过API集成实现自动化盯盘；进行市场趋势分析的数据科学家，可利用历史数据进行量化研究；以及需要SEC文件和利率数据的合规和宏观研究人员。

使用该技能存在的常规风险包括：API密钥泄露风险，虽然技能本身通过环境变量安全获取密钥，但用户需妥善保管密钥避免硬编码；成本控制风险，需监控usage.credits_remaining避免超额消费；网络依赖性风险，所有功能均需稳定网络连接至api.aisa.one；以及数据准确性风险，关键投资决策应二次验证API返回数据的准确性。

核心用法

MarketPulse 是一个面向自主代理的金融市场数据聚合工具，通过单一 API 密钥提供股票与加密货币的全方位数据服务。用户可通过命令行工具或直接使用 curl 访问 API，获取实时价格、历史 K 线、财务报表、分析师预测、内幕交易、SEC 文件等多类金融数据。

主要功能模块

传统金融数据：

• 股票历史价格（支持秒/分钟/日/周/月/年级别粒度）
• 公司新闻与舆情监控
• 三大财务报表（利润表、资产负债表、现金流量表）
• 财务指标快照与历史数据
• 分析师 EPS 预测与评级
• 内幕交易与机构持仓追踪
• SEC 文件检索与公司基本信息
• 智能选股器（支持 P/E、营收增长等条件筛选）
• 美联储利率数据

加密货币数据：

• 实时价格快照（BTC、ETH、SOL 等主流币种）
• 历史 OHLCV 数据（支持分钟级精度）
• 组合查询功能

使用方式：

# 设置 API 密钥
export AISA_API_KEY="your-key"

# 使用 Python 客户端
python3 market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31
python3 market_client.py crypto snapshot --ticker BTC-USD

---

显著优点

| 优势 | 说明 |

|------|------|

| **数据覆盖全面** | 横跨美股传统金融与加密货币两大市场，一站式满足多元化投资分析需求 |

| **API 设计简洁** | RESTful 接口风格统一，参数命名直观，学习成本低 |

| **多粒度支持** | 从秒级到年级别的灵活时间粒度，适应高频交易到长期趋势分析 |

| **成本透明** | 单次调用成本低至 $0.0005，实时返回使用额度与余额 |

| **安全合规** | 静态分析得分 95/100，仅使用 Python 标准库，无第三方依赖风险 |

| **Python 客户端** | 封装完善的命令行工具，降低非技术用户使用门槛 |

---

潜在缺点与局限性

| 限制 | 详情 |

|------|------|

| **单一供应商依赖** | 所有数据源自 `api.aisa.one`，服务可用性完全依赖 AISa 平台稳定性 |

| **需预付费** | 采用 pay-as-you-go 模式，必须预先充值才能使用，无免费额度说明 |

| **环境变量强制依赖** | 功能必需 `AISA_API_KEY`，未配置时直接抛出错误中断执行 |

| **无本地缓存机制** | 每次调用均实时请求 API，高频率场景下成本累积较快 |

| **重试机制缺失** | 仅配置 60 秒超时，无指数退避或限流应对方案 |

| **许可证不明确** | 当前版本未声明开源许可证，影响二次开发确定性 |

---

适合人群

• 量化交易员：需要程序化获取多资产实时行情与历史数据
• 基本面分析师：依赖财务报表、分析师预测、内幕交易等深度数据
• 加密货币投资者：同时关注传统市场与加密市场的跨资产配置者
• 金融自动化代理（AI Agents）：为自主决策系统提供标准化数据输入
• 个人投资者与开发者：需要低成本、易集成的市场数据 API

---

常规风险

| 风险类别 | 等级 | 说明 |

|----------|------|------|

| 数据时效性 | 中 | 依赖上游数据源更新频率，极端行情下可能存在延迟 |

| API 服务中断 | 中 | 单一供应商架构，无备用数据源或本地缓存兜底 |

| 密钥泄露 | 低 | 使用环境变量传递密钥符合安全规范，但用户可能误写入命令历史 |

| 成本失控 | 低 | 每次调用返回剩余额度，但缺乏用量预警或硬上限机制 |

| 合规风险 | 低 | 数据来源为商业 API，需自行确保使用场景符合监管要求 |