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 integrationscripts/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/CoinGeckoscripts/sentiment_news.py - News sentiment analysisscripts/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/.
1---2name: fin-intel-hub3description: Comprehensive financial intelligence hub for SEC filings, crypto on-chain data, news sentiment, macro indicators, and global stock markets (US, China, Hong Kong, Taiwan, Japan, Korea). Use when users need to: (1) Retrieve SEC EDGAR filings (10-K, 10-Q, 8-K), (2) Monitor crypto on-chain metrics and whale alerts, (3) Analyze financial news sentiment, (4) Access macroeconomic indicators (Fed rates, CPI, unemployment), (5) Get global stock prices including Asian markets (HKEX, Tokyo, Taiwan, Korea, Shanghai, Shenzhen), or any financial data research and analysis tasks.4---5
6
7# Fin Intel Hub
8
9Financial intelligence hub for OpenClaw. Supports global markets including US, China, Hong Kong, Taiwan, Japan, and Korea.
10
11## Features
12
13- **SEC Filings**: Retrieve 10-K, 10-Q, 8-K filings from EDGAR
14- **Global Market Data**: US stocks (Alpha Vantage) + Asian markets (Yahoo Finance)
15- **Asian Markets**: Hong Kong, Tokyo, Taiwan, Korea, Shanghai, Shenzhen
16- **Crypto On-Chain**: Monitor wallet flows, exchange inflows/outflows
17- **News Sentiment**: Aggregate sentiment from financial news sources
18- **Macro Dashboard**: Fed rates, CPI, unemployment data
19
20## API Keys (Optional)
21
22All API keys are **optional**. The skill works without any keys using Yahoo Finance for stock data.
23Add keys to unlock additional features:
24
25| Service | Purpose | Free Tier | Required? |
26|---------|---------|-----------|-----------|
27| Yahoo Finance | Global/Asian stocks, indices, futures, commodities | Unlimited | **No** |
28| Alpha Vantage | US stocks, earnings | 25 calls/day | Optional |
29| NewsAPI | Financial news sentiment | 100 requests/day | Optional |
30| FRED API | Macroeconomic data | Unlimited | Optional |
31| DeFiLlama | Crypto on-chain data | Unlimited | **No** |
32
33## Quick Start
34
35### SEC Filings
36```python
37from scripts.sec_filings import get_recent_filings
38
39# Get last 5 10-K filings for Apple
40filings = get_recent_filings(ticker="AAPL", form="10-K", limit=5)
41```
42
43### Stock Prices
44```python
45from scripts.market_data import get_price_history
46
47# Get 30-day price history
48prices = get_price_history(ticker="TSLA", days=30)
49```
50
51### Crypto Data
52```python
53from scripts.crypto_onchain import get_exchange_flows
54
55# Monitor exchange inflows/outflows
56flows = get_exchange_flows(exchange="binance", days=7)
57```
58
59## Scripts Reference
60
61- `scripts/sec_filings.py` - SEC EDGAR integration
62- `scripts/market_data.py` - US stock prices and earnings (Alpha Vantage)
63- `scripts/yahoo_finance.py` - Global/Asian stock prices (Yahoo Finance)
64- `scripts/crypto_onchain.py` - Blockchain data via DeFiLlama/CoinGecko
65- `scripts/sentiment_news.py` - News sentiment analysis
66- `scripts/macro_data.py` - FRED macroeconomic indicators
67
68### Asian Market Examples
69```python
70from scripts.yahoo_finance import get_hong_kong_stock, get_tokyo_stock, get_taiwan_stock
71
72# Hong Kong - Tencent
73prices = get_hong_kong_stock("0700", period="1y")
74
75# Tokyo - Toyota
76prices = get_tokyo_stock("7203", period="1y")
77
78# Taiwan - TSMC
79prices = get_taiwan_stock("2330", period="1y")
80```
81
82### Indices & Futures Examples
83```python
84from scripts.yahoo_finance import get_sp500, get_nikkei225, get_vix
85from scripts.yahoo_finance import get_crude_oil, get_gold, list_available_indices
86
87# Global indices (15+ available)
88sp500 = get_sp500(period="1y")
89nasdaq = get_nasdaq(period="1y")
90nikkei = get_nikkei225(period="1y")
91hang_seng = get_hang_seng(period="1y")
92vix = get_vix(period="1mo") # Fear index
93
94# Futures (15+ available)
95oil_futures = get_crude_oil(period="6mo")
96gold_futures = get_gold(period="6mo")
97sp_futures = get_sp500_futures(period="1mo")
98natural_gas = get_natural_gas(period="6mo")
99
100# List all available
101indices = list_available_indices()
102futures = list_available_futures()
103```
104
105For detailed API documentation and data schemas, see `references/`.
modbender