Skip to main content
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

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 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.”

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
  • Segmented revenues — revenue broken down by business segment and geography
  • Financial metrics — real-time snapshot or historical series
  • Analyst estimates — EPS and growth estimates
  • Earnings press releases — for ~2,776 supported tickers
  • Insider trades — Form 4 filings by ticker
  • Institutional ownership — 13F holdings by ticker or investor
  • 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
curl ".../financials/income-statements?ticker=AAPL&period=quarterly" -H "Authorization: Bearer $AISA_API_KEY"
curl ".../financials/balance-sheets?ticker=AAPL&period=annual"      -H "Authorization: Bearer $AISA_API_KEY"
curl ".../financials/cash-flow-statements?ticker=AAPL&period=ttm"   -H "Authorization: Bearer $AISA_API_KEY"
period accepts annual, quarterly, or ttm.

​
Segmented revenues

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

​
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 & institutional ownership

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

curl "https://api.aisa.one/apis/v1/financial/institutional-ownership?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}}}'

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 & 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 --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

EndpointMethodPurpose
/financial/pricesGETHistorical prices
/financial/newsGETCompany news
/financial/financialsGETAll statements
/financial/financials/income-statementsGETIncome statements
/financial/financials/balance-sheetsGETBalance sheets
/financial/financials/cash-flow-statementsGETCash flow
/financial/financials/segmented-revenuesGETSegmented revenues
/financial/financial-metrics/snapshotGETMetrics snapshot
/financial/financial-metricsGETHistorical metrics
/financial/analyst-estimatesGETAnalyst estimates
/financial/earnings/press-releasesGETEarnings press releases
/financial/insider-tradesGETInsider trades
/financial/institutional-ownershipGETInstitutional ownership
/financial/filingsGETSEC filings
/financial/filings/itemsGETFiling items
/financial/company/factsGETCompany facts
/financial/financials/search/screenerPOSTStock screener
/financial/financials/search/line-itemsPOSTLine-item search
/financial/macro/interest-rates/snapshotGETRates snapshot
/financial/macro/interest-ratesGETHistorical 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: 
    aisa skills install marketpulse
  4. Start a new session in your agent — the skill loads automatically.

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.