---
title: "Finnhub integration for LuumenAI"
url: "https://www.luumen.ai/integrations/finnhub/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Finnhub integration for LuumenAI

Quotes, filings, fundamentals, and market news, read from your terminal

## What LuumenAI can do with Finnhub

LuumenAI connects to Finnhub with an API token and exposes 11 tools (11 read-only). Every tool is read-only, so it can answer questions from Finnhub but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 11 tools (11 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About Finnhub with LuumenAI

Ask for a price snapshot, a company profile, or the last few earnings surprises and get the answer in the terminal. Luumen reads Finnhub through an API key: quotes for up to ten symbols at once, as-reported financials, SEC filing metadata, earnings and IPO calendars, exchange status, and news by company or category. All eleven tools are read-only, so nothing here changes anything on your side.

## Example tools

Read-only (11 in total):

- `FINNHUB_GET_COMPANY_FINANCIAL_METRICS` — Get Finnhub's current key ratios and annual or quarterly metric series for one company.
- `FINNHUB_GET_COMPANY_PROFILE` — Look up a company profile by exactly one ticker, ISIN, or CUSIP.
- `FINNHUB_GET_MARKET_STATUS` — Check whether an exchange is open now and identify its current session, timezone, or holiday.
- `FINNHUB_GET_QUOTE` — Get the latest price snapshot for one Finnhub symbol.
- `FINNHUB_GET_QUOTES` — Get price snapshots for 1-10 Finnhub symbols in one tool call.
- `FINNHUB_GET_REPORTED_FINANCIALS` — Retrieve as-reported balance-sheet, cash-flow, and income-statement data for a company or filing.
- `FINNHUB_LIST_CALENDAR_EVENTS` — List earnings releases or IPO events in an ordered date range.
- `FINNHUB_LIST_EARNINGS_RESULTS` — List a company's recent actual versus estimated earnings and surprise values.

## Frequently asked questions

### How does LuumenAI connect to Finnhub?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Finnhub on its own?

No. Every one of the 11 tools is read-only, so LuumenAI can answer questions from Finnhub but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to Finnhub is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/finnhub/