Query real-time and historical financial data of equity prices, market moves, metrics, and trends for analysis, alerts, and reporting

Query real-time and historical financial data for equities—prices, news, financial statements, metrics, analyst estimates, insider and institutional activity...

Security Scan

The skill's functionality (querying AIsa market APIs) is coherent, but metadata inconsistencies — the SKILL.md requires an AISA_API_KEY and certain binaries while the registry metadata lists no requirements — and the presence of an executable client script with no install spec warrant caution.

Purpose & Capability

The name/description, SKILL.md examples, README, and the included Python client all align: the skill queries https://api.aisa.one for equity prices, filings, news, etc. However, the registry-level 'Requirements' block in the package summary reports no required env vars or binaries while the SKILL.md metadata and README explicitly require AISA_API_KEY and tools (curl, python3). This mismatch is an incoherence in the package metadata that should be resolved.

Instruction Scope

Runtime instructions and examples are narrowly scoped to calling AIsa endpoints (curl examples) and running the included Python CLI. The SKILL.md instructs the agent to set AISA_API_KEY and only references the API host (api.aisa.one). There are no instructions to read unrelated files, other credentials, or to exfiltrate data to unexpected endpoints.

Install Mechanism

There is no install spec (instruction-only), so nothing is automatically downloaded or written at install time — lower install risk. That said, the repository includes an executable Python client (scripts/market_client.py). Because no installation steps are defined, an agent/user could still run that script locally; users should be aware an included script will make outbound network calls when executed.

Credentials

The only credential the SKILL.md and the Python client require is AISA_API_KEY, which is appropriate for a skill that calls a third-party market-data API. There are no other secrets or unrelated env vars requested. The primary proportionality concern is that the registry metadata omitted declaring this required env var.

Persistence & Privilege

The skill does not request persistent system privileges: always:false and no system config paths or modifications are requested. Autonomous model invocation is allowed by default (disable-model-invocation:false), which is normal and not by itself a red flag.

What to consider before installing

This skill appears to do what it says (calls AIsa market APIs) but has two things to check before installing: (1) metadata mismatch — SKILL.md requires AISA_API_KEY and binaries (curl, python3) but the registry summary lists no requirements; ask the publisher to clarify and fix the registry metadata. (2) Trust the API endpoint and the maintainer — the AISA_API_KEY you provide will be sent to https://api.aisa.one on every request, so only use a key you control and are willing to share with that provider. If you need extra caution, review scripts/market_client.py yourself, run the client in an isolated environment, and avoid exposing other credentials or secrets to the skill. If you cannot verify the publisher or the endpoint, treat the API key as sensitive and do not install/use the skill.

MarketPulse 📊

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

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

🔥 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 < 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 {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 --period annual
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type income --period quarterly
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type balance --period annual
python3 {baseDir}/scripts/market_client.py stock statements --ticker AAPL --type cash --period ttm

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

# ==================== Metrics & Analysis ====================
python3 {baseDir}/scripts/market_client.py stock metrics --ticker AAPL
python3 {baseDir}/scripts/market_client.py stock metrics --ticker AAPL --historical --period annual
python3 {baseDir}/scripts/market_client.py stock analyst --ticker AAPL
python3 {baseDir}/scripts/market_client.py stock earnings --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
python3 {baseDir}/scripts/market_client.py stock filings --ticker AAPL --items --filing-type 10-K --year 2024

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

# ==================== Interest Rates ====================
python3 {baseDir}/scripts/market_client.py stock rates
python3 {baseDir}/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

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.