← Back to Skills Marketplace
MarketPulse Financial Data
by
bowen-dotcom
· GitHub ↗
· v1.0.2
· MIT-0
1041
Downloads
0
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install aisa-market-skill
Description
Query real-time and historical financial data across equities and crypto—prices, market moves, metrics, and trends for analysis, alerts, and reporting.
README (SKILL.md)
\r \r
OpenClaw Market 📊\r
\r Complete market data for autonomous agents. Powered by AIsa.\r \r One API key. Stocks + Crypto + Financials. Everything you need.\r \r
🔥 What Can You Do?\r
\r
Cross-Asset Portfolio\r
"Get BTC, ETH prices alongside AAPL, NVDA stock data for my portfolio"\r
```\r
\r
### Investment Research\r
```\r
"Full analysis: NVDA price trends, insider trades, analyst estimates, SEC filings"\r
```\r
\r
### Crypto Tracking\r
```\r
"Real-time prices for BTC, ETH, SOL with 30-day historical charts"\r
```\r
\r
### Earnings Analysis\r
```\r
"Get Tesla earnings reports, analyst estimates, and price reaction"\r
```\r
\r
### Market Screening\r
```\r
"Find stocks with P/E \x3C 15 and revenue growth > 20%"\r
```\r
\r
### Whale Watching\r
```\r
"Track insider trades at Apple and correlate with price movements"\r
```\r
\r
## Quick Start\r
\r
```bash\r
export AISA_API_KEY="your-key"\r
```\r
\r
---\r
\r
## 🏦 Traditional Finance\r
\r
### Stock Prices\r
\r
```bash\r
# Historical price data (daily)\r
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"\r
\r
# Weekly price data\r
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"\r
\r
# Minute-level data (intraday)\r
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"\r
```\r
\r
**Parameters:**\r
- `ticker`: Stock symbol (required)\r
- `interval`: `second`, `minute`, `day`, `week`, `month`, `year` (required)\r
- `interval_multiplier`: Multiplier for interval, e.g., 5 for 5-minute bars (required)\r
- `start_date`: Start date YYYY-MM-DD (required)\r
- `end_date`: End date YYYY-MM-DD (required)\r
\r
### Company News\r
\r
```bash\r
# Get news by ticker\r
curl "https://api.aisa.one/apis/v1/financial/news?ticker=AAPL&limit=10" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Financial Statements\r
\r
```bash\r
# All financial statements\r
curl "https://api.aisa.one/apis/v1/financial/financial_statements/all?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Income statements\r
curl "https://api.aisa.one/apis/v1/financial/financial_statements/income?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Balance sheets\r
curl "https://api.aisa.one/apis/v1/financial/financial_statements/balance?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Cash flow statements\r
curl "https://api.aisa.one/apis/v1/financial/financial_statements/cash?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Financial Metrics\r
\r
```bash\r
# Real-time financial metrics snapshot\r
curl "https://api.aisa.one/apis/v1/financial/financial-metrics/snapshot?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Historical financial metrics\r
curl "https://api.aisa.one/apis/v1/financial/financial-metrics?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Analyst Estimates\r
\r
```bash\r
# Earnings per share estimates\r
curl "https://api.aisa.one/apis/v1/financial/analyst/eps?ticker=AAPL&period=annual" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Insider Trading\r
\r
```bash\r
# Get insider trades\r
curl "https://api.aisa.one/apis/v1/financial/insider/trades?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Institutional Ownership\r
\r
```bash\r
# Get institutional ownership\r
curl "https://api.aisa.one/apis/v1/financial/institutional/ownership?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### SEC Filings\r
\r
```bash\r
# Get SEC filings\r
curl "https://api.aisa.one/apis/v1/financial/sec/filings?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Get SEC filing items\r
curl "https://api.aisa.one/apis/v1/financial/sec/items?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Company Facts\r
\r
```bash\r
# Get company facts by CIK\r
curl "https://api.aisa.one/apis/v1/financial/company/facts?ticker=AAPL" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Stock Screener\r
\r
```bash\r
# Screen for stocks matching criteria\r
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}}}'\r
```\r
\r
### Interest Rates\r
\r
```bash\r
# Current interest rates\r
curl "https://api.aisa.one/apis/v1/financial/interest_rates/snapshot" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Historical interest rates\r
curl "https://api.aisa.one/apis/v1/financial/interest_rates/historical?bank=fed" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
---\r
\r
## ₿ Cryptocurrency\r
\r
### Real-Time Price Snapshot\r
\r
```bash\r
# Get current BTC price (use ticker format: SYMBOL-USD)\r
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=BTC-USD" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Get current ETH price\r
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=ETH-USD" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Get current SOL price\r
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=SOL-USD" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Get TRUMP token price\r
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=TRUMP-USD" \\r
-H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
**Note:** Crypto tickers use format `SYMBOL-USD` (e.g., `BTC-USD`, `ETH-USD`).\r
\r
### Historical Price Data\r
\r
```bash\r
# Get BTC historical prices (daily)\r
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"\r
\r
# Get ETH hourly data\r
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"\r
```\r
\r
### Supported Cryptocurrencies\r
\r
| Ticker | Name |\r
|--------|------|\r
| BTC-USD | Bitcoin |\r
| ETH-USD | Ethereum |\r
| SOL-USD | Solana |\r
| BNB-USD | Binance Coin |\r
| XRP-USD | Ripple |\r
| DOGE-USD | Dogecoin |\r
| ADA-USD | Cardano |\r
| AVAX-USD | Avalanche |\r
| DOT-USD | Polkadot |\r
| MATIC-USD | Polygon |\r
| LINK-USD | Chainlink |\r
| UNI-USD | Uniswap |\r
| ATOM-USD | Cosmos |\r
| LTC-USD | Litecoin |\r
| TRUMP-USD | Trump Token |\r
| ... | And many more |\r
\r
---\r
\r
## Python Client\r
\r
```bash\r
# ==================== Stock Data ====================\r
# Note: start_date and end_date are REQUIRED for prices\r
python3 {baseDir}/scripts/market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31\r
python3 {baseDir}/scripts/market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31 --interval week\r
python3 {baseDir}/scripts/market_client.py stock news --ticker AAPL --count 10\r
\r
# ==================== Financial Statements ====================\r
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type all\r
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type income\r
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type balance\r
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type cash\r
\r
# ==================== Metrics & Analysis ====================\r
python3 {baseDir}/scripts/market_client.py stock metrics --ticker AAPL\r
python3 {baseDir}/scripts/market_client.py stock analyst --ticker AAPL\r
\r
# ==================== Insider & Institutional ====================\r
python3 {baseDir}/scripts/market_client.py stock insider --ticker AAPL\r
python3 {baseDir}/scripts/market_client.py stock ownership --ticker AAPL\r
\r
# ==================== SEC Filings ====================\r
python3 {baseDir}/scripts/market_client.py stock filings --ticker AAPL\r
\r
# ==================== Stock Screener ====================\r
python3 {baseDir}/scripts/market_client.py stock screen --pe-max 15 --growth-min 0.2\r
\r
# ==================== Interest Rates ====================\r
python3 {baseDir}/scripts/market_client.py stock rates\r
python3 {baseDir}/scripts/market_client.py stock rates --historical\r
\r
# ==================== Crypto Data ====================\r
# Note: Use ticker format SYMBOL-USD (or just SYMBOL, auto-converted)\r
python3 {baseDir}/scripts/market_client.py crypto snapshot --ticker BTC-USD\r
python3 {baseDir}/scripts/market_client.py crypto snapshot --ticker ETH # Auto-converts to ETH-USD\r
python3 {baseDir}/scripts/market_client.py crypto historical --ticker BTC-USD --start 2025-01-01 --end 2025-01-31\r
python3 {baseDir}/scripts/market_client.py crypto portfolio --tickers BTC-USD,ETH-USD,SOL-USD\r
```\r
\r
---\r
\r
## API Endpoints Reference\r
\r
### Traditional Finance\r
\r
| Endpoint | Method | Description |\r
|----------|--------|-------------|\r
| `/financial/prices` | GET | Historical stock prices (requires interval params) |\r
| `/financial/news` | GET | Company news by ticker |\r
| `/financial/financial_statements/all` | GET | All financial statements |\r
| `/financial/financial_statements/income` | GET | Income statements |\r
| `/financial/financial_statements/balance` | GET | Balance sheets |\r
| `/financial/financial_statements/cash` | GET | Cash flow statements |\r
| `/financial/financial-metrics/snapshot` | GET | Real-time financial metrics |\r
| `/financial/financial-metrics` | GET | Historical metrics |\r
| `/financial/analyst/eps` | GET | EPS estimates |\r
| `/financial/insider/trades` | GET | Insider trades |\r
| `/financial/institutional/ownership` | GET | Institutional ownership |\r
| `/financial/sec/filings` | GET | SEC filings |\r
| `/financial/sec/items` | GET | SEC filing items |\r
| `/financial/company/facts` | GET | Company facts |\r
| `/financial/search/stock` | POST | Stock screener |\r
| `/financial/interest_rates/snapshot` | GET | Current interest rates |\r
| `/financial/interest_rates/historical` | GET | Historical rates |\r
\r
### Cryptocurrency\r
\r
| Endpoint | Method | Description |\r
|----------|--------|-------------|\r
| `/financial/crypto/prices/snapshot` | GET | Real-time price snapshot |\r
| `/financial/crypto/prices` | GET | Historical OHLCV data |\r
\r
---\r
\r
## Pricing\r
\r
| API | Cost |\r
|-----|------|\r
| Stock prices | ~$0.001 |\r
| Company news | ~$0.001 |\r
| Financial statements | ~$0.002 |\r
| Analyst estimates | ~$0.002 |\r
| SEC filings | ~$0.001 |\r
| Crypto snapshot | ~$0.0005 |\r
| Crypto historical | ~$0.001 |\r
\r
Every response includes `usage.cost` and `usage.credits_remaining`.\r
\r
---\r
\r
## Get Started\r
\r
1. Sign up at [aisa.one](https://aisa.one)\r
2. Get your API key\r
3. Add credits (pay-as-you-go)\r
4. Set environment variable: `export AISA_API_KEY="your-key"`\r
\r
## Full API Reference\r
\r
See [API Reference](https://docs.aisa.one/reference/) for complete endpoint documentation.\r
Usage Guidance
This package appears internally consistent with a market-data client that uses a single AISA_API_KEY to call api.aisa.one. Before installing: verify you trust the AIsa service and the skill's source (owner and domain are 'unknown' / openclaw.ai), because your API key will allow outbound requests and billing/usage tied to that key. Use a least-privilege API key or a scoped/test key if possible, monitor API usage after enabling the skill, and review the included scripts/market_client.py yourself before running them. If you do not recognize the publisher, consider contacting them or using an alternative from a known vendor.
Capability Analysis
Type: OpenClaw Skill
Name: aisa-market-skill
Version: 1.0.2
The MarketPulse skill bundle is a legitimate financial data integration for the AIsa API (api.aisa.one). The Python client (scripts/market_client.py) uses standard libraries to perform authenticated requests for stock and cryptocurrency data, and the SKILL.md instructions correctly guide the agent on how to use these tools without any evidence of prompt injection, data exfiltration, or malicious execution.
Capability Assessment
Purpose & Capability
Name and description match the contained artifacts: SKILL.md shows curl examples to api.aisa.one and scripts/market_client.py is a client that calls AIsa endpoints. Required binaries (curl, python3) and AISA_API_KEY are appropriate and expected for this functionality.
Instruction Scope
Runtime instructions and examples only show HTTP calls to api.aisa.one using the AISA_API_KEY. The SKILL.md does not instruct the agent to read unrelated files or environment variables, nor to send data to unexpected endpoints. The code uses only the declared AISA_API_KEY and network calls to the advertised API.
Install Mechanism
This is instruction-only with one included Python client file and no install spec or third-party downloads. No archive extraction or remote installers are present, so the install surface is minimal.
Credentials
Only AISA_API_KEY is required and is declared as the primary credential. That key is proportional to the skill's needs (authorizing requests to the AIsa API). No unrelated secrets or system credentials are requested.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent system privileges. It does not modify other skills or system-wide settings. Autonomous invocation is allowed (platform default) but is not combined with other concerning privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install aisa-market-skill - After installation, invoke the skill by name or use
/aisa-market-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Version 1.0.2 of aisa-market-skill — No file changes detected.
- No changes were made in this version; all content and functionality remain unchanged.
v1.0.1
- Minor documentation cleanup in SKILL.md; removed extraneous trailing content for clarity.
- No changes to functional code or core API usage.
- Updated documentation for consistency and readability.
v1.0.0
Real-time financial data gateway for equities and crypto. Query prices, market moves, metrics, and trends for analysis, alerts, and reporting. Includes stock screener, SEC filings, and portfolio tracking.
Metadata
Frequently Asked Questions
What is MarketPulse Financial Data?
Query real-time and historical financial data across equities and crypto—prices, market moves, metrics, and trends for analysis, alerts, and reporting. It is an AI Agent Skill for Claude Code / OpenClaw, with 1041 downloads so far.
How do I install MarketPulse Financial Data?
Run "/install aisa-market-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is MarketPulse Financial Data free?
Yes, MarketPulse Financial Data is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does MarketPulse Financial Data support?
MarketPulse Financial Data is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created MarketPulse Financial Data?
It is built and maintained by bowen-dotcom (@bowen-dotcom); the current version is v1.0.2.
More Skills