AIsa Market

View on GitHub → Market data for agent workflows. Query equities, crypto, filings, analyst data, insider activity, and macro context through AIsa.

Install

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

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

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

What can agents do with it?

Stock research

Pull prices, news, fundamentals, and analyst context.

Crypto context

Retrieve token prices, charts, categories, and market movement.

Financial statements

Analyze income, balance sheet, and cash-flow data.

Macro overlays

Add interest-rate and market backdrop to research.

🔥 What Can You Do?

Cross-Asset Portfolio

"Get BTC, ETH prices alongside AAPL, NVDA stock data for my portfolio"

Investment Research

"Full analysis: NVDA price trends, insider trades, analyst estimates, SEC filings"

Crypto Tracking

"Real-time prices for BTC, ETH, SOL with 30-day historical charts"

Earnings Analysis

"Get Tesla earnings reports, 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"

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
curl "https://api.aisa.one/apis/v1/financial/financial_statements/all?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Income statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/income?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Balance sheets
curl "https://api.aisa.one/apis/v1/financial/financial_statements/balance?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Cash flow statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/cash?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

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
curl "https://api.aisa.one/apis/v1/financial/financial-metrics?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

Analyst Estimates

# Earnings per share estimates
curl "https://api.aisa.one/apis/v1/financial/analyst/eps?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

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
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/sec/filings?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get SEC filing items
curl "https://api.aisa.one/apis/v1/financial/sec/items?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

Company Facts

# Get company facts by 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/search/stock" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":{"pe_ratio":{"max":15},"revenue_growth":{"min":0.2}}}'

Interest Rates

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

# Historical interest rates
curl "https://api.aisa.one/apis/v1/financial/interest_rates/historical?bank=fed" \
  -H "Authorization: Bearer $AISA_API_KEY"

₿ Cryptocurrency

Real-Time Price Snapshot

# Get current BTC price (use ticker format: SYMBOL-USD)
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=BTC-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get current ETH price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=ETH-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get current SOL price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=SOL-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get TRUMP token price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=TRUMP-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"

Note: Crypto tickers use format SYMBOL-USD (e.g., BTC-USD, ETH-USD).

Historical Price Data

# Get BTC historical prices (daily)
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" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get ETH hourly data
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" \
  -H "Authorization: Bearer $AISA_API_KEY"

Supported Cryptocurrencies

Ticker	Name
BTC-USD	Bitcoin
ETH-USD	Ethereum
SOL-USD	Solana
BNB-USD	Binance Coin
XRP-USD	Ripple
DOGE-USD	Dogecoin
ADA-USD	Cardano
AVAX-USD	Avalanche
DOT-USD	Polkadot
MATIC-USD	Polygon
LINK-USD	Chainlink
UNI-USD	Uniswap
ATOM-USD	Cosmos
LTC-USD	Litecoin
TRUMP-USD	Trump Token
…	And many more

Python Client

# ==================== Stock Data ====================
# Note: start_date and end_date are REQUIRED for prices
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
python3 scripts/market_client.py stock news --ticker AAPL --count 10

# ==================== Financial Statements ====================
python3 scripts/market_client.py stock statements --ticker AAPL --type all
python3 scripts/market_client.py stock statements --ticker AAPL --type income
python3 scripts/market_client.py stock statements --ticker AAPL --type balance
python3 scripts/market_client.py stock statements --ticker AAPL --type cash

# ==================== Metrics & Analysis ====================
python3 scripts/market_client.py stock metrics --ticker AAPL
python3 scripts/market_client.py stock analyst --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

# ==================== Stock Screener ====================
python3 scripts/market_client.py stock screen --pe-max 15 --growth-min 0.2

# ==================== Interest Rates ====================
python3 scripts/market_client.py stock rates
python3 scripts/market_client.py stock rates --historical

# ==================== Crypto Data ====================
# Note: Use ticker format SYMBOL-USD (or just SYMBOL, auto-converted)
python3 scripts/market_client.py crypto snapshot --ticker BTC-USD
python3 scripts/market_client.py crypto snapshot --ticker ETH  # Auto-converts to ETH-USD
python3 scripts/market_client.py crypto historical --ticker BTC-USD --start 2025-01-01 --end 2025-01-31
python3 scripts/market_client.py crypto portfolio --tickers BTC-USD,ETH-USD,SOL-USD

API Endpoints Reference

Traditional Finance

Endpoint	Method	Description
`/financial/prices`	GET	Historical stock prices (requires interval params)
`/financial/news`	GET	Company news by ticker
`/financial/financial_statements/all`	GET	All financial statements
`/financial/financial_statements/income`	GET	Income statements
`/financial/financial_statements/balance`	GET	Balance sheets
`/financial/financial_statements/cash`	GET	Cash flow statements
`/financial/financial-metrics/snapshot`	GET	Real-time financial metrics
`/financial/financial-metrics`	GET	Historical metrics
`/financial/analyst/eps`	GET	EPS estimates
`/financial/insider/trades`	GET	Insider trades
`/financial/institutional/ownership`	GET	Institutional ownership
`/financial/sec/filings`	GET	SEC filings
`/financial/sec/items`	GET	SEC filing items
`/financial/company/facts`	GET	Company facts
`/financial/search/stock`	POST	Stock screener
`/financial/interest_rates/snapshot`	GET	Current interest rates
`/financial/interest_rates/historical`	GET	Historical rates

Cryptocurrency

Endpoint	Method	Description
`/financial/crypto/prices/snapshot`	GET	Real-time price snapshot
`/financial/crypto/prices`	GET	Historical OHLCV data

Pricing

Each API call is billed per request; current per-call prices are on aisa.one/api. Every response includes usage.cost and usage.credits_remaining.

Full API Reference

See API Reference for complete endpoint documentation.

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.

MarketPulse

Deep equity market data and financial statements.

Crypto Market Data

CoinGecko-powered crypto data.

Financial API reference

Explore financial endpoints.

​Install

​What can agents do with it?

Stock research

Crypto context

Financial statements

Macro overlays

​🔥 What Can You Do?

​Cross-Asset Portfolio

​Investment Research

​Crypto Tracking

​Earnings Analysis

​Market Screening

​Whale Watching

​Quick Start

​🏦 Traditional Finance

​Stock Prices

​Company News

​Financial Statements

​Financial Metrics

​Analyst Estimates

​Insider Trading

​Institutional Ownership

​SEC Filings

​Company Facts

​Stock Screener

​Interest Rates

​₿ Cryptocurrency

​Real-Time Price Snapshot

​Historical Price Data

​Supported Cryptocurrencies

​Python Client

​API Endpoints Reference

​Traditional Finance

​Cryptocurrency

​Pricing

​Full API Reference

​Get started

​Related