MarketPulse

Real-time and historical equity market data for autonomous agents — prices, news, financial statements, metrics, analyst estimates, insider activity, SEC filings, stock screening, and macro interest rates.

View on GitHub →

Complete equity market data for autonomous agents. One AISA_API_KEY unlocks stocks, financials, filings, and macro data — everything an agent needs to research, screen, and analyze public companies.

Install

First, install the AIsa CLI if you have not already:

npm install -g @aisa-one/cli

Then install the skill:

aisa skills install marketpulse

What can agents do with it?

Investment research

“Full analysis: NVDA price trends, insider trades, analyst estimates, SEC filings.”

Earnings analysis

“Get Tesla earnings snapshots, 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.”

Financial statement analysis

“Compare Apple’s income statement, balance sheet, cash flow, and financial metrics.”

Macro context

“Pull the Fed funds rate history alongside bank earnings.”

Core capabilities

• Prices — historical OHLCV at second, minute, day, week, month, or year granularity
• News — ticker-filtered company news
• Financial statements — income, balance sheet, cash flow; annual, quarterly, or TTM
• Financial metrics — real-time snapshot or historical series
• Analyst estimates — EPS and growth estimates
• Insider trades — Form 4 filings by ticker
• SEC filings — filings index and parsed filing items (10-K, 10-Q, 8-K, etc.)
• Company facts — reference data by ticker or CIK
• Stock screener — POST body filters across the universe (P/E, growth, etc.)
• Line-item search — pull specific metrics across multiple tickers in one call
• Macro — current and historical central-bank interest rates

Quick start

export AISA_API_KEY="your-key"

Stock prices

# Historical daily data
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"

# Intraday 5-minute bars
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"

Required params: ticker, interval (second · minute · day · week · month · year), interval_multiplier, start_date, end_date.

Financial statements

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

# Or fetch them individually
-H "Authorization: Bearer $AISA_API_KEY"
-H "Authorization: Bearer $AISA_API_KEY"
-H "Authorization: Bearer $AISA_API_KEY"

period accepts annual, quarterly, or ttm.

Financial metrics

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

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

Insider trades

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

SEC filings

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

# Parsed 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"

Stock screener (POST)

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}}}'

Line-item search

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"}'

Macro interest rates

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

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

Python client

A bundled market_client.py wraps every endpoint for one-line usage:

# Prices (start/end are required)
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

# 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

# Analysis
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 trades
python3 scripts/market_client.py stock insider --ticker AAPL

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

# 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 --historical --bank fed

Endpoint reference

Endpoint	Method	Purpose
/financial/prices	GET	Historical prices
/financial/news	GET	Company news
/financial/financials	GET	All statements
/financial/financials/income-statements	GET	Income statements
/financial/financials/balance-sheets	GET	Balance sheets
/financial/financials/cash-flow-statements	GET	Cash flow
/financial/financial-metrics/snapshot	GET	Metrics snapshot
/financial/financial-metrics	GET	Historical metrics
/financial/analyst-estimates	GET	Analyst estimates
/financial/insider-trades	GET	Insider trades
/financial/filings	GET	SEC filings
/financial/filings/items	GET	Filing items
/financial/company/facts	GET	Company facts
/financial/financials/search/screener	POST	Stock screener
/financial/financials/search/line-items	POST	Line-item search
/financial/macro/interest-rates/snapshot	GET	Rates snapshot
/financial/macro/interest-rates	GET	Historical rates

Get started

1. Sign up at aisa.one (new accounts start with $2 free credit).
2. Generate an API key from the console.
3. export AISA_API_KEY="your-key" and install the skill:
   npm install -g @aisa-one/cli
   aisa skills install marketpulse
   
4. Start a new session in your agent — the skill loads automatically.

Related

Financial API reference

Every endpoint the MarketPulse skill wraps, with interactive playgrounds.

Error Codes

Handle 400/401/429 responses from Financial endpoints.

Rate Limits

Throughput caps per endpoint and tier.