Fin Intel Hub

Financial intelligence hub for OpenClaw. Supports global markets including US, China, Hong Kong, Taiwan, Japan, and Korea.

Features

• SEC Filings: Retrieve 10-K, 10-Q, 8-K filings from EDGAR
• Global Market Data: US stocks (Alpha Vantage) + Asian markets (Yahoo Finance)
• Asian Markets: Hong Kong, Tokyo, Taiwan, Korea, Shanghai, Shenzhen
• Crypto On-Chain: Monitor wallet flows, exchange inflows/outflows
• News Sentiment: Aggregate sentiment from financial news sources
• Macro Dashboard: Fed rates, CPI, unemployment data

API Keys (Optional)

All API keys are optional. The skill works without any keys using Yahoo Finance for stock data. Add keys to unlock additional features:

| Service | Purpose | Free Tier | Required? | |---------|---------|-----------|-----------| | Yahoo Finance | Global/Asian stocks, indices, futures, commodities | Unlimited | No | | Alpha Vantage | US stocks, earnings | 25 calls/day | Optional | | NewsAPI | Financial news sentiment | 100 requests/day | Optional | | FRED API | Macroeconomic data | Unlimited | Optional | | DeFiLlama | Crypto on-chain data | Unlimited | No |

Quick Start

SEC Filings

from scripts.sec_filings import get_recent_filings

# Get last 5 10-K filings for Apple
filings = get_recent_filings(ticker="AAPL", form="10-K", limit=5)

Stock Prices

from scripts.market_data import get_price_history

# Get 30-day price history
prices = get_price_history(ticker="TSLA", days=30)

Crypto Data

from scripts.crypto_onchain import get_exchange_flows

# Monitor exchange inflows/outflows
flows = get_exchange_flows(exchange="binance", days=7)

Scripts Reference

• scripts/sec_filings.py - SEC EDGAR integration
• scripts/market_data.py - US stock prices and earnings (Alpha Vantage)
• scripts/yahoo_finance.py - Global/Asian stock prices (Yahoo Finance)
• scripts/crypto_onchain.py - Blockchain data via DeFiLlama/CoinGecko
• scripts/sentiment_news.py - News sentiment analysis
• scripts/macro_data.py - FRED macroeconomic indicators

Asian Market Examples

from scripts.yahoo_finance import get_hong_kong_stock, get_tokyo_stock, get_taiwan_stock

# Hong Kong - Tencent
prices = get_hong_kong_stock("0700", period="1y")

# Tokyo - Toyota
prices = get_tokyo_stock("7203", period="1y")

# Taiwan - TSMC
prices = get_taiwan_stock("2330", period="1y")

Indices & Futures Examples

from scripts.yahoo_finance import get_sp500, get_nikkei225, get_vix
from scripts.yahoo_finance import get_crude_oil, get_gold, list_available_indices

# Global indices (15+ available)
sp500 = get_sp500(period="1y")
nasdaq = get_nasdaq(period="1y")
nikkei = get_nikkei225(period="1y")
hang_seng = get_hang_seng(period="1y")
vix = get_vix(period="1mo")  # Fear index

# Futures (15+ available)
oil_futures = get_crude_oil(period="6mo")
gold_futures = get_gold(period="6mo")
sp_futures = get_sp500_futures(period="1mo")
natural_gas = get_natural_gas(period="6mo")

# List all available
indices = list_available_indices()
futures = list_available_futures()

For detailed API documentation and data schemas, see references/.