MarketPulse

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

npx skills add AIsa-team/agent-skills --skill marketpulse

npm install -g @aisa-one/cli
aisa skills install marketpulse

Start a new agent session after installing so the skill loads.

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

Sign up at aisa.one and create an API key in the console.
Set it in your shell: export AISA_API_KEY="your-key".
Install the skill with one of the commands under Install, then start a new agent session.

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.

Overview

Financial & Markets

Search & Research

Social Media

AI Models

Marketing

Creative

MarketPulse

Install

What can agents do with it?

Investment research

Earnings analysis

Market screening

Whale watching

Financial statement analysis

Macro context

Core capabilities

Quick start

Stock prices

Financial statements

Financial metrics

Insider trades

SEC filings

Stock screener (POST)

Line-item search

Macro interest rates

Python client

Endpoint reference

Get started

Financial API reference

Error Codes

Rate Limits

​Install

​What can agents do with it?

Investment research

Earnings analysis

Market screening

Whale watching

Financial statement analysis

Macro context

​Core capabilities

​Quick start

​Stock prices

​Financial statements

​Financial metrics

​Insider trades

​SEC filings

​Stock screener (POST)

​Line-item search

​Macro interest rates

​Python client

​Endpoint reference

​Get started

​Related

Financial API reference

Error Codes

Rate Limits

Install

What can agents do with it?

Core capabilities

Quick start

Stock prices

Financial statements

Financial metrics

Insider trades

SEC filings

Stock screener (POST)

Line-item search

Macro interest rates

Python client

Endpoint reference

Get started

Related