MarketPulse: 实时股票和加密货币数据代理 - Openclaw Skills

作者:互联网

2026-03-26

AI教程

什么是 MarketPulse?

MarketPulse 是专为自主代理设计的综合财务数据集成方案。它提供了一个连接传统股票市场和快速波动的加密货币空间的统一网关,全部由 AIsa API 驱动。通过集成此技能,开发人员可以赋予其代理进行深度投资研究、监控市场波动并生成详细财务报告的能力。

MarketPulse 为现代开发人员而生,将复杂的数据检索简化为可操作的见解。无论您是在构建个人交易机器人还是企业财务分析代理,这个 Openclaw Skills 库的成员都能确保您的代理访问到机构级数据,包括 SEC 备案、内部交易活动和实时 OHLCV 数据。

下载入口:https://github.com/openclaw/skills/tree/main/skills/0xjordansg-yolo/openclaw-aisa-finance-stock-equity-crypto-market-price-data-yahoo-finance-coinhacko

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install openclaw-aisa-finance-stock-equity-crypto-market-price-data-yahoo-finance-coinhacko

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 openclaw-aisa-finance-stock-equity-crypto-market-price-data-yahoo-finance-coinhacko。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

MarketPulse 应用场景

  • 针对股票和加密货币的自动化跨资产投资组合监控。
  • 深度投资研究,包括 SEC 备案和分析师预测。
  • 带有历史趋势分析的实时加密货币价格追踪。
  • 市场筛选,根据市盈率 (P/E) 和营收增长等自定义财务指标识别被低估的股票。
  • 监控内部交易活动和机构持仓变化,以预测市场情绪。
MarketPulse 工作原理
  1. 代理使用 AISA_API_KEY 环境变量初始化 MarketPulse 技能,以通过 AIsa 后端身份验证。
  2. 用户或父级自动化触发特定财务数据点(如股价或公司新闻)的请求。
  3. 该技能执行优化的 curl 命令或 Python 脚本,从结构化的 AIsa 端点获取实时或历史数据。
  4. MarketPulse 解析 JSON 响应,突出显示使用成本和剩余额度等关键指标。
  5. 结构化数据返回给代理,以便在 Openclaw Skills 生态系统中进行进一步分析、预警或报告。

MarketPulse 配置指南

要开始使用 MarketPulse,请遵循以下安装步骤:

  1. 在 aisa.one 注册以获取您唯一的 API 密钥。
  2. 确保您的环境已安装 curlpython3
  3. 在终端中设置环境变量:
export AISA_API_KEY="your-key"
  1. 您现在可以运行附带的 Python 客户端来测试连接:
python3 scripts/market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31

MarketPulse 数据架构与分类体系

MarketPulse 将数据组织成高度结构化的类别,以确保 AI 代理可以轻松导航财务元数据。数据分类包括:

数据类别 描述 关键字段
传统金融价格 历史和盘中股票价格 ticker, interval, multiplier, timestamp, OHLCV
财务数据 企业资产负债表和利润表 ticker, statement_type, fiscal_period
市场指标 实时和历史估值概览 pe_ratio, revenue_growth, dividend_yield
加密数据 实时和历史代币价格 symbol-usd, price, volume, market_cap
合规性 SEC 备案和内部活动 filing_type, cik, insider_name, shares_traded
name: MarketPulse
description: "Query real-time and historical financial data across equities and crypto—prices, market moves, metrics, and trends for analysis, alerts, and reporting."
homepage: https://openclaw.ai
metadata: {"openclaw":{"emoji":"??","requires":{"bins":["curl","python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}

OpenClaw Market ??

Complete market data for autonomous agents. Powered by AIsa.

One API key. Stocks + Crypto + Financials. Everything you need.

?? What Can You Do?

Cross-Asset Portfolio

"Get BTC, ETH prices alongside AAPL, NVDA stock data for my portfolio"

Investment Research

"Full analysis: NVDA price trends, insider trades, analyst estimates, SEC filings"

Crypto Tracking

"Real-time prices for BTC, ETH, SOL with 30-day historical charts"

Earnings Analysis

"Get Tesla earnings reports, analyst estimates, and price reaction"

Market Screening

"Find stocks with P/E < 15 and revenue growth > 20%"

Whale Watching

"Track insider trades at Apple and correlate with price movements"

Quick Start

export AISA_API_KEY="your-key"

?? Traditional Finance

Stock Prices

# Historical price data (daily)
curl "https://api.aisa.one/apis/v1/financial/prices?ticker=AAPL&interval=day&interval_multiplier=1&start_date=2025-01-01&end_date=2025-12-31" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Weekly price data
curl "https://api.aisa.one/apis/v1/financial/prices?ticker=AAPL&interval=week&interval_multiplier=1&start_date=2025-01-01&end_date=2025-12-31" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Minute-level data (intraday)
curl "https://api.aisa.one/apis/v1/financial/prices?ticker=AAPL&interval=minute&interval_multiplier=5&start_date=2025-01-15&end_date=2025-01-15" r
  -H "Authorization: Bearer $AISA_API_KEY"

Parameters:

  • ticker: Stock symbol (required)
  • interval: second, minute, day, week, month, year (required)
  • interval_multiplier: Multiplier for interval, e.g., 5 for 5-minute bars (required)
  • start_date: Start date YYYY-MM-DD (required)
  • end_date: End date YYYY-MM-DD (required)

Company News

# Get news by ticker
curl "https://api.aisa.one/apis/v1/financial/news?ticker=AAPL&limit=10" r
  -H "Authorization: Bearer $AISA_API_KEY"

Financial Statements

# All financial statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/all?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Income statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/income?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Balance sheets
curl "https://api.aisa.one/apis/v1/financial/financial_statements/balance?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Cash flow statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/cash?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

Financial Metrics

# Real-time financial metrics snapshot
curl "https://api.aisa.one/apis/v1/financial/financial-metrics/snapshot?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Historical financial metrics
curl "https://api.aisa.one/apis/v1/financial/financial-metrics?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

Analyst Estimates

# Earnings per share estimates
curl "https://api.aisa.one/apis/v1/financial/analyst/eps?ticker=AAPL&period=annual" r
  -H "Authorization: Bearer $AISA_API_KEY"

Insider Trading

# Get insider trades
curl "https://api.aisa.one/apis/v1/financial/insider/trades?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

Institutional Ownership

# Get institutional ownership
curl "https://api.aisa.one/apis/v1/financial/institutional/ownership?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

SEC Filings

# Get SEC filings
curl "https://api.aisa.one/apis/v1/financial/sec/filings?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Get SEC filing items
curl "https://api.aisa.one/apis/v1/financial/sec/items?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

Company Facts

# Get company facts by CIK
curl "https://api.aisa.one/apis/v1/financial/company/facts?ticker=AAPL" r
  -H "Authorization: Bearer $AISA_API_KEY"

Stock Screener

# Screen for stocks matching criteria
curl -X POST "https://api.aisa.one/apis/v1/financial/search/stock" r
  -H "Authorization: Bearer $AISA_API_KEY" r
  -H "Content-Type: application/json" r
  -d '{"filters":{"pe_ratio":{"max":15},"revenue_growth":{"min":0.2}}}'

Interest Rates

# Current interest rates
curl "https://api.aisa.one/apis/v1/financial/interest_rates/snapshot" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Historical interest rates
curl "https://api.aisa.one/apis/v1/financial/interest_rates/historical?bank=fed" r
  -H "Authorization: Bearer $AISA_API_KEY"

? Cryptocurrency

Real-Time Price Snapshot

# Get current BTC price (use ticker format: SYMBOL-USD)
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=BTC-USD" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Get current ETH price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=ETH-USD" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Get current SOL price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=SOL-USD" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Get TRUMP token price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=TRUMP-USD" r
  -H "Authorization: Bearer $AISA_API_KEY"

Note: Crypto tickers use format SYMBOL-USD (e.g., BTC-USD, ETH-USD).

Historical Price Data

# Get BTC historical prices (daily)
curl "https://api.aisa.one/apis/v1/financial/crypto/prices?ticker=BTC-USD&interval=day&interval_multiplier=1&start_date=2025-01-01&end_date=2025-01-31" r
  -H "Authorization: Bearer $AISA_API_KEY"

# Get ETH hourly data
curl "https://api.aisa.one/apis/v1/financial/crypto/prices?ticker=ETH-USD&interval=minute&interval_multiplier=60&start_date=2025-01-15&end_date=2025-01-16" r
  -H "Authorization: Bearer $AISA_API_KEY"

Supported Cryptocurrencies

Ticker Name
BTC-USD Bitcoin
ETH-USD Ethereum
SOL-USD Solana
BNB-USD Binance Coin
XRP-USD Ripple
DOGE-USD Dogecoin
ADA-USD Cardano
AVAX-USD Avalanche
DOT-USD Polkadot
MATIC-USD Polygon
LINK-USD Chainlink
UNI-USD Uniswap
ATOM-USD Cosmos
LTC-USD Litecoin
TRUMP-USD Trump Token
... And many more

Python Client

# ==================== Stock Data ====================
# Note: start_date and end_date are REQUIRED for prices
python3 {baseDir}/scripts/market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31
python3 {baseDir}/scripts/market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31 --interval week
python3 {baseDir}/scripts/market_client.py stock news --ticker AAPL --count 10

# ==================== Financial Statements ====================
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type all
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type income
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type balance
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type cash

# ==================== Metrics & Analysis ====================
python3 {baseDir}/scripts/market_client.py stock metrics --ticker AAPL
python3 {baseDir}/scripts/market_client.py stock analyst --ticker AAPL

# ==================== Insider & Institutional ====================
python3 {baseDir}/scripts/market_client.py stock insider --ticker AAPL
python3 {baseDir}/scripts/market_client.py stock ownership --ticker AAPL

# ==================== SEC Filings ====================
python3 {baseDir}/scripts/market_client.py stock filings --ticker AAPL

# ==================== Stock Screener ====================
python3 {baseDir}/scripts/market_client.py stock screen --pe-max 15 --growth-min 0.2

# ==================== Interest Rates ====================
python3 {baseDir}/scripts/market_client.py stock rates
python3 {baseDir}/scripts/market_client.py stock rates --historical

# ==================== Crypto Data ====================
# Note: Use ticker format SYMBOL-USD (or just SYMBOL, auto-converted)
python3 {baseDir}/scripts/market_client.py crypto snapshot --ticker BTC-USD
python3 {baseDir}/scripts/market_client.py crypto snapshot --ticker ETH  # Auto-converts to ETH-USD
python3 {baseDir}/scripts/market_client.py crypto historical --ticker BTC-USD --start 2025-01-01 --end 2025-01-31
python3 {baseDir}/scripts/market_client.py crypto portfolio --tickers BTC-USD,ETH-USD,SOL-USD

API Endpoints Reference

Traditional Finance

Endpoint Method Description
/financial/prices GET Historical stock prices (requires interval params)
/financial/news GET Company news by ticker
/financial/financial_statements/all GET All financial statements
/financial/financial_statements/income GET Income statements
/financial/financial_statements/balance GET Balance sheets
/financial/financial_statements/cash GET Cash flow statements
/financial/financial-metrics/snapshot GET Real-time financial metrics
/financial/financial-metrics GET Historical metrics
/financial/analyst/eps GET EPS estimates
/financial/insider/trades GET Insider trades
/financial/institutional/ownership GET Institutional ownership
/financial/sec/filings GET SEC filings
/financial/sec/items GET SEC filing items
/financial/company/facts GET Company facts
/financial/search/stock POST Stock screener
/financial/interest_rates/snapshot GET Current interest rates
/financial/interest_rates/historical GET Historical rates

Cryptocurrency

Endpoint Method Description
/financial/crypto/prices/snapshot GET Real-time price snapshot
/financial/crypto/prices GET Historical OHLCV data

Pricing

API Cost
Stock prices ~$0.001
Company news ~$0.001
Financial statements ~$0.002
Analyst estimates ~$0.002
SEC filings ~$0.001
Crypto snapshot ~$0.0005
Crypto historical ~$0.001

Every response includes usage.cost and usage.credits_remaining.


Get Started

  1. Sign up at aisa.one
  2. Get your API key
  3. Add credits (pay-as-you-go)
  4. Set environment variable: export AISA_API_KEY="your-key"

Full API Reference

See API Reference for complete endpoint documentation.