How to Use Finnhub company profile in Claude Code
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.
Prompts to try with Finnhub company profile in Claude Code
Copy an example into Claude Code, or ask in your own words.
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 Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Finnhub company profile
One request; the result comes back by polling or a webhook.
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: Claude Code finds Finnhub company profile on Spiral, shows the price and runs it.
Finnhub company profile providers and prices
Spiral runs Finnhub company profile through Alexandria. Open a card for today's price, with every fee included.
What can you do with Finnhub company profile in Claude Code?
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.
More on Finnhub company profile and Claude Code
Overview
Finnhub company profile in other agents
Questions about Finnhub company profile in Claude Code
Can Claude Code use Finnhub company profile?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Finnhub company profile like any built-in tool.
How much does Finnhub company profile cost in Claude Code?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use Finnhub company profile in Claude Code?
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 Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Finnhub company profile runs?
Finnhub company profile runs in the background. Claude Code 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.
Start using Finnhub company profile in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


