Financial Data

Query real-time and historical financial data across equities and crypto—prices, market moves, metrics, and trends for analysis, alerts, and reporting.

Security Scan

The skill is internally consistent: it requests a single API key for a named market-data service and its code and instructions use that key to call that service; there are no unrelated credentials, installs, or wildcard privileges.

Purpose & Capability

Name/description (financial market data) matches the declared requirements and included code. Required binaries (curl, python3) are reasonable for the provided curl examples and the included Python client. The single required env var (AISA_API_KEY) is the API key used to authenticate to the documented api.aisa.one endpoints.

Instruction Scope

SKILL.md provides explicit curl examples and parameter lists and does not instruct the agent to read unrelated files, environment variables, or system state. The instructions send requests to api.aisa.one only, which matches the documented purpose.

Install Mechanism

This is an instruction-only skill with one readable Python client file; there is no install spec that downloads or extracts remote archives. No high-risk install mechanisms are present.

Credentials

Only one environment variable (AISA_API_KEY) is required and used by the client; no unrelated secrets, keys, or config paths are requested. The key is used solely to set the Authorization header for requests to api.aisa.one as expected.

Persistence & Privilege

The skill is not marked always:true and does not request system-wide configuration changes or elevated privileges. It can be invoked autonomously (default), which is normal for skills; this should be considered when granting the API key.

Assessment

This skill appears coherent, but before installing verify that you trust the AIsa provider and the domain api.aisa.one (and that your AISA_API_KEY is issued for that service). The skill will transmit whatever tickers and parameters you request along with your API key to api.aisa.one, so treat the API key like a secret and restrict its scope if possible. If you obtained the skill from an unknown source, consider rotating/revoking the key after testing and review the client code (scripts/market_client.py) yourself — it's readable and shows exactly which endpoints will be contacted.

OpenClaw Market 📊

Complete market data for autonomous agents. Powered by AIsa.

One API key. Stocks + Crypto + Financials. Everything you need.

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

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

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

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

# ==================== Crypto Data ====================
# Note: Use ticker format SYMBOL-USD (or just SYMBOL, auto-converted)
python3 {baseDir}/scripts/market_client.py crypto snapshot --ticker BTC-USD
python3 {baseDir}/scripts/market_client.py crypto snapshot --ticker ETH  # Auto-converts to ETH-USD
python3 {baseDir}/scripts/market_client.py crypto historical --ticker BTC-USD --start 2025-01-01 --end 2025-01-31
python3 {baseDir}/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

API	Cost
Stock prices	~$0.001
Company news	~$0.001
Financial statements	~$0.002
Analyst estimates	~$0.002
SEC filings	~$0.001
Crypto snapshot	~$0.0005
Crypto historical	~$0.001

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.