← Back to Skills Marketplace
aisapay

Financial Data

by AIsaPay · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
1486
Downloads
0
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install financial-data
Description
Query real-time and historical financial data across equities and crypto—prices, market moves, metrics, and trends for analysis, alerts, and reporting.
README (SKILL.md)

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 \x3C 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.

Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: financial-data Version: 1.0.0 The OpenClaw AgentSkills skill bundle is a client for the AIsa financial data API. The `SKILL.md` and `scripts/market_client.py` clearly define its purpose: querying financial data from `https://api.aisa.one` using an `AISA_API_KEY`. All network requests are directed to this single, specified domain, and the API key is used for standard bearer token authentication. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, prompt injection attempts against the agent, or obfuscation. The code uses standard Python libraries and practices, aligning with its stated purpose.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install financial-data
  3. After installation, invoke the skill by name or use /financial-data
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — unified access to real-time and historical financial data for market analytics and reporting: - Added detailed README with full API and Python client examples for stocks and crypto - Introduced scripts/market_client.py for querying prices, fundamentals, news, and more - Supports equity and crypto data: prices, metrics, financials, earnings, insider trades, SEC filings, and analysis - Explains all endpoints, parameters, and usage for robust market research and portfolio tracking
Metadata
Slug financial-data
Version 1.0.0
License
All-time Installs 6
Active Installs 6
Total Versions 1
Frequently Asked Questions

What is Financial Data?

Query real-time and historical financial data across equities and crypto—prices, market moves, metrics, and trends for analysis, alerts, and reporting. It is an AI Agent Skill for Claude Code / OpenClaw, with 1486 downloads so far.

How do I install Financial Data?

Run "/install financial-data" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Financial Data free?

Yes, Financial Data is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Financial Data support?

Financial Data is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Financial Data?

It is built and maintained by AIsaPay (@aisapay); the current version is v1.0.0.

💬 Comments