Agent skill

Finnhub

by gauss314 in gauss314/skills

API de datos financieros completa: stocks US/global, forex, crypto, fundamentales, noticias, earnings, recomendaciones, WebSocket.

MITAuto-check passedBackend & APIs

Install Finnhub

skills CLI
$ npx skills add gauss314/skills --skill finnhub -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gauss314/skills finnhub --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/finnhub .claude/skills/finnhub && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
finnhub
GitHub stars
248
Token cost
~2k tokens
SKILL.md length
603 words
Files
5 (incl. scripts, references)
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

API de datos financieros completa: stocks US/global, forex, crypto, fundamentales, noticias, earnings, recomendaciones, WebSocket.

  • Works in 5 steps: Cotización en tiempo real → Perfil de empresa → Noticias de una empresa → …
  • Tasks that involve Realtime and WebSockets
  • SKILL.md covers ⚠️ IMPORTANTE: Endpoints Free…, Autenticación, Rate Limits and Uso Rápido, plus 4 more sections
  • Runs Python scripts from its folder; reaches finnhub.io; needs API_KEY and FINNHUB_API_KEY

What it does

Finnhub is an agent skill from gauss314/skills. API de datos financieros completa: stocks US/global, forex, crypto, fundamentales, noticias, earnings, recomendaciones, WebSocket. 60 calls/min gratis.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/ENDPOINTS.md`, `scripts/download_multiple.py` and `scripts/finnhub_cli.py`).

It sits in Backend & APIs, covering Realtime and WebSockets. The repository describes itself as: Financial market data consumption skills for claude code and AI agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Realtime and WebSockets

Example prompts

  • “/finnhub”

Requirements

  • Python 3
  • A credential in API_KEY
  • A credential in FINNHUB_API_KEY

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Cotización en tiempo real
  2. Perfil de empresa
  3. Noticias de una empresa
  4. Velas OHLCV diarias
  5. Búsqueda de símbolos

What it can do on your machine

Read from SKILL.md and the folder at commit 5156f81. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • finnhub.io

    Also links to:

    • github.com
    • status.finnhub.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY
    • FINNHUB_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Finnhub loads about 2k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 40 tokens; SKILL.md has 603 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from gauss314/skills at commit 5156f81, republished under its MIT licence (© gauss314). 603 words, ~2,016 tokens.

Download SKILL.mdSave it as .claude/skills/finnhub/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
finnhub
description
API de datos financieros completa: stocks US/global, forex, crypto, fundamentales, noticias, earnings, recomendaciones, WebSocket. 60 calls/min gratis.
license
MIT
metadata.category
finanzas, api, stocks, forex, crypto, noticias, eeUU, global
metadata.language
es
metadata.source
https://finnhub.io/docs/api

Finnhub API — Datos Financieros en Tiempo Real

API REST con 32 endpoints gratuitos que cubre: cotizaciones en vivo, velas OHLCV, perfiles de empresa, fundamentales, noticias, forex, crypto, datos económicos, calendario de earnings y WebSocket.

Base URL: https://finnhub.io/api/v1 Documentación oficial: finnhub.io/docs/api Pricing: finnhub.io/pricing


⚠️ IMPORTANTE: Endpoints Free vs Premium

Este skill documenta todos los endpoints, pero marca claramente cuáles son:

  • ✅ FREE — Funcionan con el plan gratuito (60 calls/min, sin tarjeta)
  • 🔒 PREMIUM — Requieren plan pago (Starter $11.99/mes+, Professional $49.99/mes o Enterprise)

NOTA CRÍTICA: El plan gratuito de Finnhub es mucho más limitado de lo que su documentación sugiere. Según pruebas con una API key gratuita real (2026), solo los siguientes endpoints funcionan:

  • /quote (cotización), /stock/profile2 (perfil empresa), /stock/peers (pares), /stock/earnings (earnings)
  • /stock/recommendation (recomendaciones), /stock/metric (métricas), /news (noticias mercado)
  • /company-news (noticias empresa), /search (búsqueda), /stock/market-status (estado mercado)

Endpoints como stock/candle (velas OHLCV), stock/financials, stock/price-target, stock/dividend, forex/rates, crypto/candle requieren plan pago.

Ver la tabla completa en references/ENDPOINTS.md.


Autenticación

Obtener API Key (GRATIS, sin tarjeta de crédito)
  1. Ir a: https://finnhub.io/register
  2. Crear cuenta (email + contraseña)
  3. Copiar la API Key del dashboard: https://finnhub.io/dashboard
  4. Plan gratuito: 60 calls/minuto, 30 calls/segundo máximo
Usar la API Key
python
import os
API_KEY = os.getenv("FINNHUB_API_KEY")  # Recomendado (variable de entorno)
# O directamente en tests:
# API_KEY = "tu_api_key_aqui"
bash
# Header (recomendado)
X-Finnhub-Token: tu_api_key

# O query param
?token=tu_api_key

⚠️ NUNCA hardcodear la API key en código compartido.


Rate Limits

LímitePlan FreeStarter ($11.99/mes)Professional ($49.99/mes)Enterprise ($3500/mes)
Calls/minuto60300+300+900 (market), 300 (fund)
Calls/segundo30 (global)30 (global)30 (global)30 (global)
WebSocket símbolos50IlimitadoIlimitadoIlimitado
Historia OHLCVLimitada30+ años30+ años30+ años
Noticias1 año20 años20 años20 años
Cobertura fundamentalUSGlobalGlobalGlobal

Tip: si recibís HTTP 429, esperá 1-2 segundos antes de reintentar.


Uso Rápido

1. Cotización en tiempo real
python
import requests

API_KEY = "tu_api_key"
BASE = "https://finnhub.io/api/v1"

r = requests.get(f"{BASE}/quote", params={"symbol": "AAPL", "token": API_KEY})
quote = r.json()
print(f"AAPL: ${quote['c']:.2f} ({quote['dp']:+.2f}%)")
2. Perfil de empresa
python
r = requests.get(f"{BASE}/stock/profile2", params={"symbol": "AAPL", "token": API_KEY})
profile = r.json()
print(f"{profile['name']} | {profile['finnhubIndustry']} | Market Cap: ${profile['marketCapitalization']/1000:.2f}B")
3. Noticias de una empresa
python
r = requests.get(f"{BASE}/company-news", params={
    "symbol": "AAPL", "from": "2025-01-01", "to": "2025-01-15", "token": API_KEY
})
for article in r.json()[:3]:
    print(f"  {article['headline'][:80]}...")
4. Velas OHLCV diarias
python
import time
end = int(time.time())
start = end - (90 * 86400)  # 90 días
r = requests.get(f"{BASE}/stock/candle", params={
    "symbol": "AAPL", "resolution": "D",
    "from": start, "to": end, "token": API_KEY
})
candles = r.json()
print(f"Status: {candles['s']}, velas: {len(candles['c'])}")
5. Búsqueda de símbolos
python
r = requests.get(f"{BASE}/search", params={"q": "microsoft", "token": API_KEY})
for result in r.json()["result"]:
    print(f"{result['symbol']}: {result['description']} ({result['type']})")

Scripts Disponibles

ScriptDescripciónEndpoints que usa
finnhub_client.pyCliente Python completo con todos los endpoints gratuitosquote, candle, profile2, peers, metric, financials, earnings, recommendation, price-target, company-news, news, forex, crypto, search, economic, market-status, dividends, splits, calendar
finnhub_cli.pyInterfaz de línea de comandos para consultas rápidasquote, profile2, search, news, peers, earnings, market-status
download_multiple.pyDescarga batches de datos por categoríasquote, candle, metric, financials, earnings, recommendation, company-news

Show full SKILL.md (247 more words)Show less

Cobertura de la API (según pruebas con key gratuita real)

CategoríaEndpointsFreePremium
Cotizacionesquote✅—
Perfil empresaprofile2, peers✅—
Earningsearnings (4 quarters free)✅—
Recomendacionesrecommendation (~8 meses)✅—
Métricas (133)metric (sin historia, solo último valor)✅—
Noticiascompany-news, news✅—
Búsquedasearch✅—
Estado mercadomarket-status✅—
Velas OHLCVcandle—🔒 Premium
Estados financierosfinancials, financials-reported, price-target—🔒 Premium
Dividendos/Splitsdividend, split—🔒 Premium
Forexrates, candle, exchange, symbol—🔒 Premium
Cryptocandle, exchange, symbol—🔒 Premium
Económicoeconomic/code, economic, country—🔒 Premium
Símbolosstock/symbol, market-holiday, ipo-calendar—🔒 Premium
WebSocketTrades (50 símbolos)—🔒 Premium
Insider, Ownershipinsider-transactions, ownership, etc.—🔒 Premium
Estimateseps-estimate, revenue-estimate, etc.—🔒 Premium
ETFs, Índices, Bonosetf/profile, etf/holdings, index/constituents, bond/price, etc.—🔒 Premium
Alternativossocial-sentiment, covid-19, esg-score, etc.—🔒 Premium

⚠️ Esta tabla está basada en pruebas reales con una API key gratuita en junio 2026. Finnhub cambia su política de acceso periódicamente. Verificar siempre en la documentación oficial.


Buenas Prácticas

  1. Usar variable de entorno FINNHUB_API_KEY en vez de hardcodear
  2. Cachear resultados: los datos fundamentales cambian poco (especialmente company profile, financials)
  3. Rate limiting: 60 calls/min gratis = 1 call por segundo como mínimo
  4. Evitar endpoints premium con key gratuita — recibirás error "You don't have access to this resource."
  5. WebSocket: solo 1 conexión por API key, 50 símbolos en free
  6. Reutilizar sesión HTTP para mejor performance (requests.Session())
  7. No usar para trading de alta frecuencia: API pública, sin garantía de latencia ultra-baja

Recursos

© gauss314, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/finnhub of gauss314/skills.

  • SKILL.md
  • references/ENDPOINTS.md
  • scripts/download_multiple.py
  • scripts/finnhub_cli.py
  • scripts/finnhub_client.py

Open the folder on GitHubat commit 5156f81

Compare with similar skills

Finnhub next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Finnhub compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Finnhub this skillgauss314/skills248—~2kAutomated safety check: PassMIT
Binance Datatoollostleaf/binance-datatool148—~2.5kAutomated safety check: NotesBSD-3-Clause
Polymarket2025Emma/vibe-coding-cn23k1 repos~1.6kAutomated safety check: PassMIT
Binance Wallet Trackerbinance/binance-skills-hub1.1k—~5.3kAutomated safety check: PassNone
Crypto ExecutorLeoYeAI/openclaw-master-skills2.2k—~4kAutomated safety check: PassMIT
AI-Trader Heartbeat PollingHKUDS/AI-Trader23k—~1.6kAutomated safety check: PassNone

Similar skills

  • Binance Datatool

    lostleaf/binance-datatool

    Manage Binance historical market data from data.binance.vision using the binance-datatool CLI.

    148 GitHub stars~2.5k tokensUpdated 5 mo ago
    Backend & APIsAuto-check: notes
  • Polymarket

    2025Emma/vibe-coding-cn

    Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real-time WebSocket data streaming.

    23k GitHub starsUsed in 1 repo~1.6k tokens
    Backend & APIsAuto-check passed
  • Binance Wallet Tracker

    binance/binance-skills-hub

    Wallet tracking and monitoring on Binance Web3. An agent skill from binance/binance-skills-hub.

    1.1k GitHub stars~5.3k tokensUpdated 29 days ago
    Backend & APIsAuto-check passed
  • Crypto Executor

    LeoYeAI/openclaw-master-skills

    Complete autonomous trading engine for Binance with WebSocket real-time, OCO orders, Kelly Criterion position sizing, trailing stops, circuit breakers, daily performance reports, AND NOW adaptive…

    2.2k GitHub stars~4k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Polls the AI-Trader heartbeat API on a regular interval to reliably receive messages and tasks, treating the optional WebSocket feed as a non-guaranteed supplement.

    23k GitHub stars~1.6k tokensUpdated 4 mo ago
    Backend & APIsAuto-check passed
  • Web3 Polymarket

    Polymarket/agent-skills

    Polymarket integration for prediction market trading on Polygon.

    192 GitHub starsUsed in 1 repo~2k tokens
    Backend & APIsAuto-check passed

More from gauss314/skills

All 32 skills in this repo
  • Backtesting

    gauss314/skills

    Academic backtesting framework for quantitative research. An agent skill from gauss314/skills.

    248 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Google Finance

    gauss314/skills

    Datos de Google Finance via batchexecute (API RPC interna sin auth ni API key).

    248 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Historyofmarket

    gauss314/skills

    History of Market (historyofmarket.com) — API publica con 88 datasets historicos de indices US desde 1871.

    248 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Indec

    gauss314/skills

    Datos macro y sociales de Argentina via la API oficial Series de Tiempo del Estado (apis.datos.gob.ar/series).

    248 GitHub stars~3k tokensUpdated 3 mo ago
    Auto-check passed
  • Morningstar

    gauss314/skills

    Morningstar Screener via API JSON publica: descarga masiva de 53 universes (102K+ listings, 39 paises, NYSE/Nasdaq/BCBA/etc) con 33 campos (precio, market cap, ratios, retornos…

    248 GitHub stars~2.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Option Pricing

    gauss314/skills

    Pricing completo de opciones europeas y americanas. An agent skill from gauss314/skills.

    248 GitHub stars~4.7k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Finnhub

What does Finnhub do?

API de datos financieros completa: stocks US/global, forex, crypto, fundamentales, noticias, earnings, recomendaciones, WebSocket. Finnhub is an agent skill from gauss314/skills. API de datos financieros completa: stocks US/global, forex, crypto, fundamentales, noticias, earnings, recomendaciones, WebSocket.

When should I use Finnhub?

Finnhub fits situations like: tasks that involve Realtime and WebSockets.

How do I install Finnhub in Claude Code?

Run `npx skills add gauss314/skills --skill finnhub -a claude-code`. Or copy the skill folder (skills/finnhub in gauss314/skills) into .claude/skills/finnhub in your project. Claude Code loads it when a task matches its description.

How do I install Finnhub in Codex?

Run `npx skills add gauss314/skills --skill finnhub -a codex`. Or copy the skill folder (skills/finnhub in gauss314/skills) into .agents/skills/finnhub in your project. Codex loads it when a task matches its description.

Can I use Finnhub in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gauss314/skills --skill finnhub -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/finnhub, .gemini/skills/finnhub, .github/skills/finnhub and .opencode/skills/finnhub in your project.

What does Finnhub need to run?

Going by SKILL.md and its folder, Finnhub needs Python for the scripts in its folder and credentials named API_KEY and FINNHUB_API_KEY. Our summary lists: Python 3; A credential in API_KEY; A credential in FINNHUB_API_KEY.

Does Finnhub access the network?

SKILL.md names 3 domains. In commands or code: finnhub.io; the agent is likely to contact it when it follows the instructions. As links in the text: github.com and status.finnhub.io. This is read from the text; nothing was executed.

Is Finnhub safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Finnhub use?

Finnhub is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Finnhub use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.5k tokens, read only when the agent opens those files.

What are the alternatives to Finnhub?

Skills that share tags, products or a category with Finnhub: Binance Datatool (lostleaf/binance-datatool, 148 stars), Polymarket (2025Emma/vibe-coding-cn, 23k stars), Binance Wallet Tracker (binance/binance-skills-hub, 1.1k stars) and Crypto Executor (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Finnhub?

gauss314 (a GitHub user) maintains it in gauss314/skills, which has 248 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on June 14, 2026.

Source: gauss314/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.