Skip to content

himself65/finance-skills / plugins/data-providers/skills/fintel-data

fintel-data

Verified

Query Fintel (fintel.io) institutional market data through its REST API or official MCP server. Use this skill whenever the user mentions Fintel or asks about short interest, short interest ratio or days to cover, short squeeze data, borrow rate or cost to borrow, shares available to borrow, daily short volume, fails-to-deliver (FTD), 13F institutional owners ("who owns X"), insider buying or selling from SEC Form 3/4/5, analyst price targets, ratings and forecasts, dividend or earnings history and calendars, EOD or last prices, security lookup by ticker, CUSIP, ISIN, or FIGI, Fintel leaderboards, or their Fintel watchlists and alerts. Read-only: GET endpoints only.

FileKindSize
README.mdmarkdown2.4 KB
SKILL.mdskill md8.7 KB
references/api-reference.mdmarkdown9.3 KB
# Fintel Data

Query [Fintel](https://fintel.io) institutional market intelligence:

- **REST API** at `https://api.fintel.io/v1` — `X-API-KEY` header auth. Default surface; works from any CLI agent via curl.
- **MCP server** at `https://mcp.fintel.io/mcp` — same tools, same data contract, same key; for MCP-native clients.

Fintel's signature datasets are the ones most other providers lack: short interest, borrow rates and shares available to borrow, daily short volume, fails-to-deliver (FTD), 13F institutional ownership, and insider transactions.

## Triggers

- Short interest, days to cover, short interest ratio, short squeeze data
- Borrow rate / cost to borrow / rebate rate / shares available to borrow
- Daily short volume, short-exempt volume
- Fails-to-deliver (FTD) records
- Institutional owners, 13F holders, "who owns X"
- Insider buying/selling, Form 3/4/5 transactions
- Analyst price targets, buy/hold/sell ratings, revenue/EPS forecasts
- Dividend and earnings history, earnings/dividend calendars
- EOD price bars, last trade price with 52-week stats
- Security lookup by ticker, CUSIP, ISIN, or FIGI
- Leaderboards, user watchlists (stock lists), alerts
- Any mention of "fintel" or "fintel.io"

## Read-Only

This skill only calls GET endpoints. The Fintel API also exposes write operations (stock lists, alert subscriptions, teams) — the skill never invokes them, per this repo's read-only policy.

## Platform

**CLI only** — requires shell access for curl (Claude Code or similar). Does not work on Claude.ai's sandbox.

## Setup

> **Paid service** — a Fintel API plan is required. Some datasets (notably short interest) must additionally be enabled per account; the API returns 403 for unentitled datasets.

Get an API key from [Fintel](https://fintel.io) (docs: [api.fintel.io/docs](https://api.fintel.io/docs)), then either:

```bash
export FINTEL_API_KEY="your-api-key-here"
```

…or add `FINTEL_API_KEY=...` to `.env` at the repo root (preferred when working across worktrees — the skill resolves the key from env, local `.env`, then the repo-root `.env`).

Optional MCP registration instead of REST:

```bash
claude mcp add --transport http fintel https://mcp.fintel.io/mcp --header "X-API-KEY: your_key_here"
```

## Reference Files

| File | Description |
|---|---|
| `references/api-reference.md` | Full REST endpoint reference — all GET endpoints with parameters, defaults, limits, error semantics, MCP tool-name mapping, and curl examples |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall