← Back to Skills Marketplace
xuan622

Fin Intel Hub

by xuan622 · GitHub ↗ · v1.0.2
cross-platform ✓ Security Clean
399
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install fin-intel-hub
Description
Access global financial data including SEC filings, Asian and US stock markets, crypto on-chain metrics, financial news sentiment, and macroeconomic indicators.
README (SKILL.md)

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/.

Usage Guidance
This skill appears internally consistent for aggregating public financial data. Before installing: (1) Prefer cloning from the public GitHub repo URL in the README and inspect code yourself; (2) Only provide API keys you control and are comfortable being used by the local skill (keys are optional); (3) Be aware some modules fall back to public endpoints and some functions return empty results without optional keys; (4) Test the skill in a sandbox or non-production environment first — there are minor code quality issues (truncated/buggy returns in some files) but no signs of data exfiltration or unrelated credential access. If you need higher assurance, review the full code (the truncated files) or run a static scan locally.
Capability Analysis
Type: OpenClaw Skill Name: fin-intel-hub Version: 1.0.2 The OpenClaw skill 'fin-intel-hub' is classified as benign. It provides comprehensive financial intelligence by aggregating data from legitimate public APIs (Yahoo Finance, SEC EDGAR, DeFiLlama, CoinGecko) and optional APIs (Alpha Vantage, NewsAPI, FRED, Glassnode, Etherscan, Whale Alert). The skill demonstrates robust security practices, including extensive input validation, API rate limiting, secure logging with sensitive data redaction, and safe error handling, primarily implemented in `scripts/security_utils.py`. All API keys are handled via environment variables and are optional. There is no evidence of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection attempts in any of the analyzed files, including the `SKILL.md` and `README.md` instructions.
Capability Assessment
Purpose & Capability
The name/description promise SEC filings, market data, crypto on-chain metrics, news sentiment, and macro indicators; the repository contains modules for each (sec_filings.py, market_data.py, yahoo_finance.py, crypto_onchain.py, sentiment_news.py, macro_data.py). The optional environment variables (AlphaVantage, NewsAPI, FRED, Glassnode, Etherscan, WhaleAlert) directly map to the described external APIs and are marked optional, which is proportionate.
Instruction Scope
SKILL.md instructs the agent to import the included Python modules and call their functions; it does not ask the agent to read unrelated local files, system configuration, or cloud credentials. The runtime instructions and examples stay within the stated domain (fetching public financial data).
Install Mechanism
There is no install spec (instruction-only skill) and the code uses only Python and requests; nothing is downloaded from arbitrary URLs or extracted to disk during install. This minimal installation footprint is low risk.
Credentials
No required environment variables are declared; the listed env vars are optional API keys that match the services used in code. There are no unrelated secret names or unexpected credential requests. Logging utilities include redaction patterns (e.g., for API keys) — expected and reasonable for this skill.
Persistence & Privilege
The skill is not marked always:true and requests no elevated privileges or system-wide configuration changes. It does not modify other skills' configurations or require persistent installation steps beyond placing files in the skills directory (documented).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install fin-intel-hub
  3. After installation, invoke the skill by name or use /fin-intel-hub
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added new optional environment variables for crypto-related API keys: GLASSNODE_API_KEY, ETHERSCAN_API_KEY, and WHALE_ALERT_API_KEY. - Updated documentation in SKILL.md to reflect new API key options and their purposes. - No changes to core functionality; no new pip dependencies added. - Documentation improvements only (README, SAFETY, SKILL).
v1.0.1
fin-intel-hub v1.0.1 - Added SAFETY.md for improved documentation on safety practices. - Updated author, source, license, and environment variable info in SKILL.md. - Declared optional environment variables for API keys. - Clarified that no additional pip packages are required (standard library + requests only). - Minor documentation enhancements in README and related files.
v1.0.0
fin-intel-hub 1.0.0 - Initial release of a comprehensive financial intelligence hub. - Retrieve SEC EDGAR filings (10-K, 10-Q, 8-K). - Access US and major Asian stock market data, including Hong Kong, China, Taiwan, Japan, and Korea. - Monitor crypto on-chain metrics and whale alerts. - Analyze real-time news sentiment. - Fetch macroeconomic indicators such as Fed rates, CPI, and unemployment. - API keys are optional, with most features available out of the box.
Metadata
Slug fin-intel-hub
Version 1.0.2
License
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Fin Intel Hub?

Access global financial data including SEC filings, Asian and US stock markets, crypto on-chain metrics, financial news sentiment, and macroeconomic indicators. It is an AI Agent Skill for Claude Code / OpenClaw, with 399 downloads so far.

How do I install Fin Intel Hub?

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

Is Fin Intel Hub free?

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

Which platforms does Fin Intel Hub support?

Fin Intel Hub is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Fin Intel Hub?

It is built and maintained by xuan622 (@xuan622); the current version is v1.0.2.

💬 Comments