Description

Real-time financial data API for systematic stock analysis and quantitative investment research. Access stock quotes, historical OHLCV, batch screening, comp...

README (SKILL.md)

Finskills — Stock Quantitative Investment

Name: finskills
Author: finskills

Use the Finskills REST API at https://finskills.net to perform systematic stock analysis and quantitative investment research in real time.

Authentication

All requests require the X-API-Key header. Ask the user for their key if not provided. Get a key at: https://finskills.net/register

X-API-Key: YOUR_API_KEY_HERE

Base URL: https://finskills.net

Quick Start

Ask the user for their Finskills API key if not provided.
Make HTTP requests to https://finskills.net/v1/... with the X-API-Key header.
Use /v1/free/... endpoints when available — they work with any valid API key.
For universe-level analysis, always start with the batch quote endpoint to minimize API calls.

Stock Data

Endpoint	Description	Key Params
`GET /v1/stocks/quote/{symbol}`	Real-time price, change%, volume, market cap, P/E, 52-week range	symbol e.g. `AAPL`
`GET /v1/stocks/quotes?symbols=`	Batch quotes for a stock universe	`symbols=AAPL,MSFT,GOOGL` (CSV)
`GET /v1/stocks/history/{symbol}`	Historical OHLCV candlestick data	`interval`: 1d/1wk/1mo · `from`/`to`: YYYY-MM-DD
`GET /v1/stocks/search?q=`	Find stocks by company name or ticker	`q=apple`
`GET /v1/stocks/profile/{symbol}`	Company description, sector, industry, country	—
`GET /v1/stocks/financials/{symbol}`	Income statement, balance sheet, cash flow	`freq`: yearly / quarterly
`GET /v1/stocks/earnings/{symbol}`	EPS history, actuals vs. estimates, surprise%	—
`GET /v1/stocks/dividends/{symbol}`	Dividend payment history and yield	—
`GET /v1/stocks/recommendations/{symbol}`	Analyst buy/hold/sell counts with trend history	—
`GET /v1/stocks/holders/{symbol}`	Top institutional holders, insider ownership %	—
`GET /v1/stocks/options/{symbol}`	Options chain: IV, open interest, Greeks	`date`: YYYY-MM-DD

Market Overview

Endpoint	Description
`GET /v1/market/summary`	Major indices (S&P 500, Dow, Nasdaq), trending tickers, top movers
`GET /v1/market/sectors`	S&P 500 sector performance — all 11 GICS sectors

Macroeconomics & Risk

Endpoint	Description	Key Params
`GET /v1/macro/inflation`	US CPI monthly inflation series	—
`GET /v1/macro/interest-rates`	US Federal Funds rate history	—
`GET /v1/macro/indicator/{series}`	Any FRED series by ID	`series`: CPIAUCSL, FEDFUNDS, UNRATE, T10Y2Y, VIXCLS
`GET /v1/free/macro/treasury-rates`	Full US Treasury yield curve (1-month to 30-year)	—
`GET /v1/free/macro/gdp`	World Bank GDP by country	`countryCode`: US/CN/JP/DE
`GET /v1/free/macro/indicator/{indicator}`	World Bank macro indicator	`indicator`: CPI/GDP/UNEMPLOYMENT · `country`: US
`GET /v1/free/forex/rates`	Live exchange rates (150+ currencies)	`base`: USD/EUR/CNY
`GET /v1/free/forex/history`	Historical forex rates	`base`, `target`, `startDate`, `endDate`

Commodities

Endpoint	Description	Key Params
`GET /v1/free/commodity/prices`	Real-time prices for all or one category	`category`: energy/metals_precious/agriculture
`GET /v1/free/commodity/price/{symbol}`	Single commodity real-time quote	`CL=F` (WTI), `GC=F` (Gold), `HG=F` (Copper)
`GET /v1/free/commodity/history/{symbol}`	Commodity OHLCV history	`range`: 1y · `interval`: 1d/1wk/1mo
`GET /v1/free/commodity/fred/{seriesId}`	FRED daily commodity series	`DCOILWTICO`, `GOLDAMGBD228NLBM`
`GET /v1/free/commodity/imf/batch`	IMF monthly data for multiple commodities	`indicators`: POILAPSP,PGOLD,PCOPP

News & SEC Filings

Endpoint	Description
`GET /v1/news/by-symbol/{symbol}`	News articles for a specific stock
`GET /v1/free/news/finance`	Latest financial news headlines
`GET /v1/free/sec/filings/{cik}`	SEC filings: 10-K, 10-Q, 8-K
`GET /v1/free/sec/company-facts/{cik}`	XBRL-structured financial facts from SEC EDGAR

Common CIK numbers: Apple 0000320193 · Microsoft 0000789019 · Tesla 0001318605 · Nvidia 0001045810

Usage Guidelines

Batch first: For >3 stocks, use /v1/stocks/quotes?symbols= rather than individual calls.
Use /v1/free/... endpoints whenever available — no additional external API keys required.
For crypto, use CoinGecko IDs (bitcoin, ethereum) not ticker symbols (BTC, ETH).
Always include units (USD, %, bps, ×) and cite data freshness ("as of [date]").
Format large numbers as $1.23B, $456.7M — never raw 9-digit values.
No investment advice: Present data factually. Say "the data shows…" not "you should buy/sell".

Example Interactions

Batch screening:

"Screen the Magnificent 7 stocks for momentum and valuation" → GET /v1/stocks/quotes?symbols=AAPL,MSFT,GOOGL,META,NVDA,AMZN,TSLA, then history per stock

Fundamental analysis:

"Analyze Apple's profitability and financial health" → GET /v1/stocks/financials/AAPL?freq=yearly — compute ROE, margins, FCF yield

Earnings trend:

"Has Microsoft been consistently beating earnings estimates?" → GET /v1/stocks/earnings/MSFT

Analyst sentiment:

"What is the analyst consensus on Nvidia?" → GET /v1/stocks/recommendations/NVDA

Yield curve:

"Is the yield curve inverted right now?" → GET /v1/free/macro/treasury-rates, then GET /v1/macro/indicator/T10Y2Y

Sector rotation:

"Which sectors are outperforming? What does the macro backdrop say?" → GET /v1/market/sectors + GET /v1/macro/interest-rates + GET /v1/macro/inflation

Options volatility:

"What is the implied volatility on NVIDIA options before earnings?" → GET /v1/stocks/options/NVDA

Commodity macro signal:

"Is copper trending up or down? What does it signal for the economy?" → GET /v1/free/commodity/history/HG=F?range=1y&interval=1wk

SEC filing:

"Find Tesla's latest 10-K annual report" → GET /v1/free/sec/filings/0001318605 (filter form: 10-K)

Risk environment:

"Show me the macro risk dashboard: VIX, credit spreads, yield curve" → GET /v1/macro/indicator/VIXCLS + GET /v1/macro/indicator/T10Y2Y + GET /v1/free/macro/treasury-rates

Usage Guidance

This skill appears to be a straightforward client for the Finskills API and only needs your Finskills API key to function. Before providing a key, verify you trust https://finskills.net (review their documentation and account page). If you follow README installation suggestions: avoid blindly running npx or curl commands from unknown sources — inspect the npm package and the downloaded SKILL.md first. If you prefer, use the skill in instruction-only mode and paste an API key when prompted rather than storing it in environment variables or running remote installers.

Capability Analysis

Type: OpenClaw Skill Name: finskills Version: 1.0.1 The 'finskills' skill bundle provides a comprehensive interface for a financial data API (finskills.net), enabling AI agents to perform stock analysis, macroeconomic research, and fundamental screening. The skill requires an API key from the user and communicates exclusively with the stated domain to fetch financial data. No indicators of data exfiltration, malicious execution, or harmful prompt injection were found; the instructions are well-structured and align entirely with the stated purpose of quantitative investment research.

Capability Tags

cryptocan-make-purchasesrequires-sensitive-credentials

Capability Assessment

✓ Purpose & Capability

Name, description, and endpoints all describe a financial data REST API. The listed endpoints, usage patterns (batch quotes first, /v1/free/*), and examples align with a stock/market-data service. There are no unrelated credentials, binaries, or config paths required.

✓ Instruction Scope

SKILL.md instructs the agent to ask the user for an API key and to make HTTPS calls to https://finskills.net/v1/.... It does not instruct reading unrelated files, scanning system state, or exfiltrating arbitrary data. Formatting and usage guidelines are limited to presenting returned data.

ℹ Install Mechanism

The skill itself has no install spec and is instruction-only (lowest risk). However, README suggests optional installation/ingestion methods that involve network actions (npx skills add ..., curl https://finskills.net/SKILL.md). Those recommendations could fetch/execute remote code via npx or write files with curl if followed — a user should verify the npm package and the download URL before running those commands. The skill bundle provided here does not include any install-time binaries or archives.

✓ Credentials

No environment variables or secrets are declared as required. The runtime instructions do require an X-API-Key header (user-supplied API key) which is appropriate and proportionate for an API client. There are no other credential requests or unrelated secret accesses.

✓ Persistence & Privilege

Skill flags show always: false and normal autonomous invocation allowed. The skill does not request persistent system privileges or access to other skills' configuration. There is no installation step that writes persistent privileged files in the provided bundle.

Version History

v1.0.1

- Added open source LICENSE file to the repository. - Expanded SKILL.md to cover new endpoints for commodities, macroeconomic indicators, and batch stock analysis. - Updated documentation with more detailed real-world use cases and best practices for quantitative research. - Clarified API request formats, parameter usage, data presentation, and compliance with fact-based responses. - Refined the description and display name to emphasize systematic and quantitative investment analysis.

v1.0.0

- Initial release of finskills skill providing real-time access to financial data. - Supports stock quotes, crypto prices, forex rates, macroeconomic indicators, financial news, analyst ratings, insider trades, and SEC filings. - Includes extensive REST API endpoints for market data, alternative data, macro research, and news. - Utilizes free endpoints for broad accessibility; requires user-supplied API key. - Offers example queries and clear usage guidelines for financial information requests.

Metadata

Slug finskills

Version 1.0.1

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 2

Frequently Asked Questions

What is finskills?

Real-time financial data API for systematic stock analysis and quantitative investment research. Access stock quotes, historical OHLCV, batch screening, comp... It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.

How do I install finskills?

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

Is finskills free?

Yes, finskills is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does finskills support?

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

Who created finskills?

It is built and maintained by finskills (@finskills); the current version is v1.0.1.

More Skills

finskills