Finnhub Market Data

Quotes, price history, company fundamentals, ETF holdings, earnings, analyst ratings, insider transactions, dividends, splits and news — from Finnhub.

Built from Finnhub's own OpenAPI document (finnhub.io/static/swagger.json, 116 paths, fetched 2026-08-17). Every operation and every required parameter below is transcribed from that spec.

Get a key

1. Sign up at https://finnhub.io/dashboard — the free tier allows 60 calls/minute.
2. Store it once: Credentials → New → API Key, name it (e.g. Finnhub), paste the key.
3. Name that credential on the task: "credentialName": "Finnhub".

There is no apiKey input. The key lives in the vault and is sent as the X-Finnhub-Token header, so it never appears in a URL, a workflow, an export or the activity log.

Operations

candles takes UNIX timestamps for from/to; the news and corporate-action operations take YYYY-MM-DD. That difference is Finnhub's, not this tool's.

Examples

What an ETF holds:

{"name":"holdings","tool":"finnhub","credentialName":"Finnhub",
 "properties":{"operation":"etf_holdings","symbol":"SPY"}}

A quote, and a year of daily candles:

{"properties":{"operation":"quote","symbol":"AAPL"}}
{"properties":{"operation":"candles","symbol":"AAPL","resolution":"D","from":"1754006400","to":"1785542400"}}

Output

• result — Finnhub's JSON response, verbatim
• status — the HTTP status code

401 means the key is wrong, 403 means the endpoint is not in your plan, 429 means you passed 60 calls/minute. Finnhub's own message is passed through, not swallowed.

Notes

• Intraday resolutions, institutional data and several international exchanges are paid tiers.
• Free-tier fundamentals cover US listings; for European and Asian symbols use the eodhd tool.
• Verified: validation and auth wiring tested live (a bogus key returns 401 Invalid API key.). No 200-level response has been recorded — that needs a real key.

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.