[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Finnhub company profile](https://spiral.ai/integrations/gemini-cli/finnhub-company-profile)

# How to Use Finnhub company profile in Gemini CLI

Finnhub returns a company's name, exchange, headquarters country, filing currency, IPO date, market capitalization, shares outstanding, website, logo, and industry. Use it to identify a listed company and add context to a stock watchlist.

|  |  |
| --- | --- |
| Model | Finnhub company profile |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Finnhub company profile in Gemini CLI

- Use Finnhub company profile for AAPL and populate the company details component in this project with the returned name, exchange, website, and logo.
- Use Finnhub company profile for MSFT, GOOGL, and AMZN, then create a comparison table in this project showing headquarters country, filing currency, and Finnhub industry.
- Use Finnhub company profile for NVDA and add its returned IPO date, market capitalization, and shares outstanding to the stock details view.
- Use Finnhub company profile for KO and PEP, then replace the hardcoded company names and website links in the watchlist with the returned values.
- Use Finnhub company profile for JPM, BAC, and WFC, then group the project's watchlist entries by the returned Finnhub industry labels.

## How to set up Finnhub company profile in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Finnhub company profile**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "finnhub-gateway/companies/profile",
    "input": {
      "symbol": "<symbol>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Finnhub company profile on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Finnhub company profile tools and prices

- [Finnhub · Company profile](https://spiral.ai/tools/alexandria/finnhub-gateway/companies/profile) (Alexandria): $0.00873 per call.

## What can you do with Finnhub company profile in Gemini CLI?

Populate a stock watchlist with company names, exchanges, logos, and websites from Finnhub. A coding agent can use the returned profiles to replace hardcoded company details in your project.

### Add company names to a watchlist

Turn a list of stock tickers into readable entries with company names, exchanges, websites, and logos.

### Prepare a company reference brief

Collect a listed company's headquarters country, filing currency, IPO date, industry, market capitalization, and shares outstanding in one reference table.

### Organize companies by industry

Group a chosen stock list using the industry labels returned by Finnhub.

### Compare headquarters locations

Arrange a selected company list by headquarters country and show each listing exchange alongside it.

### Check filing currencies before a comparison

Build a company-by-company table of filing currencies before preparing a financial comparison.

### Review company reference changes

Recheck a watchlist's company names, exchanges, websites, and Finnhub industry labels, then flag differences from an earlier permitted snapshot.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Finnhub company profile in other agents

- [Amp](https://spiral.ai/integrations/amp/finnhub-company-profile)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/finnhub-company-profile)
- [Claude](https://spiral.ai/integrations/claude-desktop/finnhub-company-profile)
- [Claude Code](https://spiral.ai/integrations/claude-code/finnhub-company-profile)
- [Cline](https://spiral.ai/integrations/cline/finnhub-company-profile)
- [Codex](https://spiral.ai/integrations/codex/finnhub-company-profile)
- [Cursor](https://spiral.ai/integrations/cursor/finnhub-company-profile)
- [Devin](https://spiral.ai/integrations/devin/finnhub-company-profile)
- [dots](https://spiral.ai/integrations/dots/finnhub-company-profile)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/finnhub-company-profile)
- [Gemini](https://spiral.ai/integrations/gemini/finnhub-company-profile)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/finnhub-company-profile)
- [goose](https://spiral.ai/integrations/goose/finnhub-company-profile)
- [Grok](https://spiral.ai/integrations/grok/finnhub-company-profile)
- [Grok Build](https://spiral.ai/integrations/grok-build/finnhub-company-profile)
- [Hermes](https://spiral.ai/integrations/hermes/finnhub-company-profile)
- [Instinct](https://spiral.ai/integrations/instinct/finnhub-company-profile)
- [Manus](https://spiral.ai/integrations/manus/finnhub-company-profile)
- [Muse](https://spiral.ai/integrations/muse/finnhub-company-profile)
- [Muse Code](https://spiral.ai/integrations/muse-code/finnhub-company-profile)
- [n8n](https://spiral.ai/integrations/n8n/finnhub-company-profile)
- [Notion](https://spiral.ai/integrations/notion/finnhub-company-profile)
- [OpenClaw](https://spiral.ai/integrations/openclaw/finnhub-company-profile)
- [opencode](https://spiral.ai/integrations/opencode/finnhub-company-profile)
- [Perplexity](https://spiral.ai/integrations/perplexity/finnhub-company-profile)
- [Raycast](https://spiral.ai/integrations/raycast/finnhub-company-profile)
- [VS Code](https://spiral.ai/integrations/vscode/finnhub-company-profile)
- [Windsurf](https://spiral.ai/integrations/windsurf/finnhub-company-profile)
- [Zapier](https://spiral.ai/integrations/zapier/finnhub-company-profile)

## More Gemini CLI guides

- [Finnhub company news](https://spiral.ai/integrations/gemini-cli/finnhub-company-news)
- [Finnhub stock symbol lookup](https://spiral.ai/integrations/gemini-cli/finnhub-stock-symbol-lookup)
- [Federal Reserve statistical data](https://spiral.ai/integrations/gemini-cli/federal-reserve-statistical-data)
- [Fireround company funding profile](https://spiral.ai/integrations/gemini-cli/fireround-company-funding-profile)
- [Federal Reserve speech and testimony text](https://spiral.ai/integrations/gemini-cli/federal-reserve-speech-and-testimony-text)
- [Fireround company funding rounds](https://spiral.ai/integrations/gemini-cli/fireround-company-funding-rounds)

## Questions about Finnhub company profile in Gemini CLI

**Can Gemini CLI use Finnhub company profile?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Finnhub company profile like any built-in tool.

**How much does Finnhub company profile cost in Gemini CLI?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use Finnhub company profile in Gemini CLI?**

No. Spiral runs Finnhub company profile on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Finnhub company profile in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Finnhub company profile runs?**

Finnhub company profile runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**What company information does Finnhub return?**

The profile includes company identity, listing details, IPO date, market capitalization, shares outstanding, website, logo, and Finnhub industry classification. It provides company reference information for a stock research brief.

**Does the country describe where the stock trades?**

Finnhub defines country as the company's headquarters country. The listing exchange appears separately, so use headquarters country when organizing companies geographically.

**What does the profile's currency mean?**

Finnhub defines it as the currency used in company filings. Label it as filing currency when comparing company profiles.

**Which industry classification does Finnhub use?**

The profile returns Finnhub's own industry classification. Keep that label when grouping companies so readers know which classification the comparison uses.

**Will every company have a complete, verified profile?**

Every property in Finnhub's documented response model is optional, including IPO date, market capitalization, and industry. Finnhub's terms also decline to guarantee data accuracy or completeness.

