How to Use Finnhub company profile in opencode
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 opencode
Copy an example into opencode, 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 opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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: opencode 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 opencode?
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 opencode
Overview
Finnhub company profile in other agents
Questions about Finnhub company profile in opencode
Can opencode use Finnhub company profile?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Finnhub company profile like any built-in tool.
How much does Finnhub company profile cost in opencode?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need an Alexandria account to use Finnhub company profile in opencode?
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 opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Finnhub company profile runs?
Finnhub company profile runs in the background. opencode 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 opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


