finskills

v1.0.1

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

⭐ 0· 90·0 current·0 all-time

by@finskills

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for finskills/finskills.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "finskills" (finskills/finskills) from ClawHub.
Skill page: https://clawhub.ai/finskills/finskills
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install finskills

ClawHub CLI

Package manager switcher

npx clawhub@latest install finskills

Security Scan

Capability signals

CryptoCan make purchasesRequires sensitive credentials

These labels describe what authority the skill may exercise. They are separate from suspicious or malicious moderation verdicts.

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

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.

Assessment

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.

Like a lobster shell, security has layers — review code before you run it.

latestvk97erxsd240fjffyht1rkxm9zn850ws5

90downloads

0stars

2versions

Updated 1w ago

v1.0.1

MIT-0

Finskills — Stock Quantitative Investment

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

Comments

Loading comments...