← 返回 Skills 市场
aisadocs

Marketpulse

作者 AIsa · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
73
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install marketpulse
功能描述
Query stocks, crypto, prediction markets, and portfolio research through AIsa. Use when: the user needs market data, screening, price history, or investment...
使用说明 (SKILL.md)

MarketPulse 📊

Complete equity market data for autonomous agents. Powered by AIsa.

One API key. Stocks, financials, filings, and macro data. Everything you need.

Compatibility

Works with any agentskills.io-compatible harness, including:

  • Claude Code and Claude (Anthropic)
  • OpenAI Codex
  • Cursor
  • Gemini CLI (Google)
  • OpenCode, Goose, OpenClaw, Hermes
  • and any other harness that implements the Agent Skills specification

Requires Python 3, a POSIX shell, and AISA_API_KEY (get one at aisa.one).

🔥 What Can You Do?

Investment Research

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

Earnings Analysis

"Get Tesla earnings press releases, analyst estimates, and price reaction"

Market Screening

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

Whale Watching

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

Segment Deep-Dive

"Break down Apple's revenue by product segment and geography"

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" \
  -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" \
  -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" \
  -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" \
  -H "Authorization: Bearer $AISA_API_KEY"

Financial Statements

# All financial statements (requires period)
curl "https://api.aisa.one/apis/v1/financial/financials?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Income statements
curl "https://api.aisa.one/apis/v1/financial/financials/income-statements?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Balance sheets
curl "https://api.aisa.one/apis/v1/financial/financials/balance-sheets?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Cash flow statements
curl "https://api.aisa.one/apis/v1/financial/financials/cash-flow-statements?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

Parameters:

  • ticker: Stock symbol (required)
  • period: annual, quarterly, or ttm (required)

Segmented Revenues

# Break down revenue by business segment and geography
curl "https://api.aisa.one/apis/v1/financial/financials/segmented-revenues?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

Parameters:

  • ticker: Stock symbol (required)
  • period: annual or quarterly (required)

Financial Metrics

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

# Historical financial metrics (period required)
curl "https://api.aisa.one/apis/v1/financial/financial-metrics?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

Analyst Estimates

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

Earnings Press Releases

# Get earnings press releases
curl "https://api.aisa.one/apis/v1/financial/earnings/press-releases?ticker=NVDA" \
  -H "Authorization: Bearer $AISA_API_KEY"

Note: This endpoint has narrower ticker coverage than other financial endpoints. Passing an unsupported ticker returns {"error":"Invalid ticker"}. See earnings-press-releases-tickers.md for the full list of supported tickers (~2,776 as of 2026-04-14).

Insider Trading

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

Institutional Ownership

# Get institutional ownership (by ticker OR investor)
curl "https://api.aisa.one/apis/v1/financial/institutional-ownership?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

SEC Filings

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

# Get SEC filing items (requires filing type and year)
curl "https://api.aisa.one/apis/v1/financial/filings/items?ticker=AAPL&filing_type=10-K&year=2024" \
  -H "Authorization: Bearer $AISA_API_KEY"

Company Facts

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

Stock Screener

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

Search Line Items

# Search specific financial line items across tickers
curl -X POST "https://api.aisa.one/apis/v1/financial/financials/search/line-items" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tickers":["AAPL","MSFT"],"line_items":["revenue","net_income"],"period":"annual"}'

Interest Rates (Macro)

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

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

Python Client

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

# ==================== Financial Statements ====================
python3 scripts/market_client.py stock statements --ticker AAPL --type all --period annual
python3 scripts/market_client.py stock statements --ticker AAPL --type income --period quarterly
python3 scripts/market_client.py stock statements --ticker AAPL --type balance --period annual
python3 scripts/market_client.py stock statements --ticker AAPL --type cash --period ttm

# ==================== Segmented Revenues ====================
python3 scripts/market_client.py stock segments --ticker AAPL --period annual

# ==================== Metrics & Analysis ====================
python3 scripts/market_client.py stock metrics --ticker AAPL
python3 scripts/market_client.py stock metrics --ticker AAPL --historical --period annual
python3 scripts/market_client.py stock analyst --ticker AAPL
python3 scripts/market_client.py stock earnings --ticker AAPL

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

# ==================== SEC Filings ====================
python3 scripts/market_client.py stock filings --ticker AAPL
python3 scripts/market_client.py stock filings --ticker AAPL --items --filing-type 10-K --year 2024

# ==================== Stock Screener / Line Items ====================
python3 scripts/market_client.py stock screen --pe-max 15 --growth-min 0.2
python3 scripts/market_client.py stock line-items --tickers AAPL,MSFT --items revenue,net_income --period annual

# ==================== Interest Rates ====================
python3 scripts/market_client.py stock rates
python3 scripts/market_client.py stock rates --historical --bank fed

API Endpoints Reference

Endpoint Method Description
/financial/prices GET Historical stock prices (requires interval params)
/financial/news GET Company news by ticker
/financial/financials GET All financial statements (requires period)
/financial/financials/income-statements GET Income statements (requires period)
/financial/financials/balance-sheets GET Balance sheets (requires period)
/financial/financials/cash-flow-statements GET Cash flow statements (requires period)
/financial/financials/segmented-revenues GET Revenue by segment/geography (requires period)
/financial/financial-metrics/snapshot GET Real-time financial metrics
/financial/financial-metrics GET Historical metrics (requires period)
/financial/analyst-estimates GET EPS estimates
/financial/earnings/press-releases GET Earnings press releases (see supported tickers)
/financial/insider-trades GET Insider trades
/financial/institutional-ownership GET Institutional ownership
/financial/filings GET SEC filings
/financial/filings/items GET SEC filing items (requires filing_type, year)
/financial/company/facts GET Company facts
/financial/financials/search/screener POST Stock screener
/financial/financials/search/line-items POST Search specific line items across tickers
/financial/macro/interest-rates/snapshot GET Current interest rates
/financial/macro/interest-rates GET Historical rates

Pricing

API Cost
Stock prices ~$0.001
Company news ~$0.001
Financial statements ~$0.002
Segmented revenues ~$0.002
Analyst estimates ~$0.002
Earnings press releases ~$0.001
SEC filings ~$0.001
Line items / screener ~$0.002
Interest rates ~$0.0005

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.

安全使用建议
This package appears coherent: the bundled Python client sends your AISA_API_KEY as a Bearer token to https://api.aisa.one. Before installing, confirm you trust the AIsa service and that the API key's scope/permissions are appropriate; treat the key as sensitive (rotate/revoke if exposed). If you need stronger isolation, run the script in a restricted environment or use a scoped test key. The skill does not request other credentials or access to local files beyond running the script.
功能分析
Type: OpenClaw Skill Name: marketpulse Version: 1.0.1 The marketpulse skill is a legitimate financial data client for the AIsa API (api.aisa.one). The Python script (scripts/market_client.py) uses standard libraries to fetch stock and cryptocurrency data, and the instructions in SKILL.md are well-aligned with the stated purpose, even including safety guardrails to prevent the AI from generating financial advice. No indicators of data exfiltration, malicious execution, or prompt injection were found.
能力标签
cryptorequires-sensitive-credentials
能力评估
Purpose & Capability
Name/description (market data, screening, price history, portfolio research) maps directly to the included Python client which calls an AIsa market API endpoint. Required binary (python3) and primaryEnv (AISA_API_KEY) are proportional and expected.
Instruction Scope
SKILL.md instructs running the bundled script and setting AISA_API_KEY. It does not ask the agent to read unrelated system files or secrets, nor to transmit data to endpoints outside the declared AIsa API host.
Install Mechanism
There is no install spec (instruction-only), so nothing is downloaded or written to disk by an installer. The package does include a local Python script to execute; that is coherent with being an instruction-driven skill.
Credentials
Only a single environment variable (AISA_API_KEY) is required. The key is necessary and used to authenticate requests to the AIsa API; no unrelated credentials or config paths are requested.
Persistence & Privilege
The skill is not always-enabled and does not request persistent system-wide privileges. Autonomous invocation is allowed (platform default) but there is no evidence the skill attempts to modify other skills or global agent settings.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install marketpulse
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /marketpulse 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Improved documentation and guidance throughout SKILL.md. - Clarified use cases, high-intent workflows, and when to use the skill. - Specified required environment variable (AISA_API_KEY) and package setup details. - Outlined guardrails on data accuracy and financial advice. - Added compatibility and environment metadata for supported platforms.
元数据
Slug marketpulse
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Marketpulse 是什么?

Query stocks, crypto, prediction markets, and portfolio research through AIsa. Use when: the user needs market data, screening, price history, or investment... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 73 次。

如何安装 Marketpulse?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install marketpulse」即可一键安装,无需额外配置。

Marketpulse 是免费的吗?

是的,Marketpulse 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Marketpulse 支持哪些平台?

Marketpulse 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Marketpulse?

由 AIsa(@aisadocs)开发并维护,当前版本 v1.0.1。

💬 留言讨论