{"skill":{"slug":"fin-intel-hub","displayName":"Fin Intel Hub","summary":"Access global financial data including SEC filings, Asian and US stock markets, crypto on-chain metrics, financial news sentiment, and macroeconomic indicators.","description":"---\nname: fin-intel-hub\ndescription: 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.\nauthor: xuan622\nsource: https://github.com/xuan622/fin-intel-hub\nlicense: MIT\nenvironment_variables:\n  - name: ALPHA_VANTAGE_API_KEY\n    description: Optional - Alpha Vantage API key for US stock data\n    required: false\n  - name: NEWS_API_KEY\n    description: Optional - NewsAPI key for news sentiment analysis\n    required: false\n  - name: FRED_API_KEY\n    description: Optional - FRED API key for macroeconomic data\n    required: false\n  - name: GLASSNODE_API_KEY\n    description: Optional - Glassnode API key for enhanced crypto exchange flow data\n    required: false\n  - name: ETHERSCAN_API_KEY\n    description: Optional - Etherscan API key for Ethereum gas price data\n    required: false\n  - name: WHALE_ALERT_API_KEY\n    description: Optional - Whale Alert API key for whale transaction monitoring\n    required: false\nrequirements: |\n  No pip packages required. Uses only Python standard library + requests.\n---\n\n# Fin Intel Hub\n\nFinancial intelligence hub for OpenClaw. Supports global markets including US, China, Hong Kong, Taiwan, Japan, and Korea.\n\n## Features\n\n- **SEC Filings**: Retrieve 10-K, 10-Q, 8-K filings from EDGAR\n- **Global Market Data**: US stocks (Alpha Vantage) + Asian markets (Yahoo Finance)\n- **Asian Markets**: Hong Kong, Tokyo, Taiwan, Korea, Shanghai, Shenzhen\n- **Crypto On-Chain**: Monitor wallet flows, exchange inflows/outflows\n- **News Sentiment**: Aggregate sentiment from financial news sources\n- **Macro Dashboard**: Fed rates, CPI, unemployment data\n\n## API Keys (Optional)\n\nAll API keys are **optional**. The skill works without any keys using Yahoo Finance for stock data.\nAdd keys to unlock additional features:\n\n| Service | Purpose | Free Tier | Required? |\n|---------|---------|-----------|-----------|\n| Yahoo Finance | Global/Asian stocks, indices, futures, commodities | Unlimited | **No** |\n| Alpha Vantage | US stocks, earnings | 25 calls/day | Optional |\n| NewsAPI | Financial news sentiment | 100 requests/day | Optional |\n| FRED API | Macroeconomic data | Unlimited | Optional |\n| DeFiLlama | Crypto on-chain data | Unlimited | **No** |\n\n## Quick Start\n\n### SEC Filings\n```python\nfrom scripts.sec_filings import get_recent_filings\n\n# Get last 5 10-K filings for Apple\nfilings = get_recent_filings(ticker=\"AAPL\", form=\"10-K\", limit=5)\n```\n\n### Stock Prices\n```python\nfrom scripts.market_data import get_price_history\n\n# Get 30-day price history\nprices = get_price_history(ticker=\"TSLA\", days=30)\n```\n\n### Crypto Data\n```python\nfrom scripts.crypto_onchain import get_exchange_flows\n\n# Monitor exchange inflows/outflows\nflows = get_exchange_flows(exchange=\"binance\", days=7)\n```\n\n## Scripts Reference\n\n- `scripts/sec_filings.py` - SEC EDGAR integration\n- `scripts/market_data.py` - US stock prices and earnings (Alpha Vantage)\n- `scripts/yahoo_finance.py` - Global/Asian stock prices (Yahoo Finance)\n- `scripts/crypto_onchain.py` - Blockchain data via DeFiLlama/CoinGecko\n- `scripts/sentiment_news.py` - News sentiment analysis\n- `scripts/macro_data.py` - FRED macroeconomic indicators\n\n### Asian Market Examples\n```python\nfrom scripts.yahoo_finance import get_hong_kong_stock, get_tokyo_stock, get_taiwan_stock\n\n# Hong Kong - Tencent\nprices = get_hong_kong_stock(\"0700\", period=\"1y\")\n\n# Tokyo - Toyota\nprices = get_tokyo_stock(\"7203\", period=\"1y\")\n\n# Taiwan - TSMC\nprices = get_taiwan_stock(\"2330\", period=\"1y\")\n```\n\n### Indices & Futures Examples\n```python\nfrom scripts.yahoo_finance import get_sp500, get_nikkei225, get_vix\nfrom scripts.yahoo_finance import get_crude_oil, get_gold, list_available_indices\n\n# Global indices (15+ available)\nsp500 = get_sp500(period=\"1y\")\nnasdaq = get_nasdaq(period=\"1y\")\nnikkei = get_nikkei225(period=\"1y\")\nhang_seng = get_hang_seng(period=\"1y\")\nvix = get_vix(period=\"1mo\")  # Fear index\n\n# Futures (15+ available)\noil_futures = get_crude_oil(period=\"6mo\")\ngold_futures = get_gold(period=\"6mo\")\nsp_futures = get_sp500_futures(period=\"1mo\")\nnatural_gas = get_natural_gas(period=\"6mo\")\n\n# List all available\nindices = list_available_indices()\nfutures = list_available_futures()\n```\n\nFor detailed API documentation and data schemas, see `references/`.\n","tags":{"latest":"1.0.2"},"stats":{"comments":0,"downloads":729,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":3},"createdAt":1772265526626,"updatedAt":1778491667475},"latestVersion":{"version":"1.0.2","createdAt":1772269435162,"changelog":"- Added new optional environment variables for crypto-related API keys: GLASSNODE_API_KEY, ETHERSCAN_API_KEY, and WHALE_ALERT_API_KEY.\n- Updated documentation in SKILL.md to reflect new API key options and their purposes.\n- No changes to core functionality; no new pip dependencies added.\n- Documentation improvements only (README, SAFETY, SKILL).","license":null},"metadata":null,"owner":{"handle":"xuan622","userId":"s172jdd5xgfnptrpn2febq5ex1884vra","displayName":"xuan622","image":"https://avatars.githubusercontent.com/u/34533348?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779967093528}}