[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Finnhub stock symbol lookup](https://spiral.ai/integrations/opencode/finnhub-stock-symbol-lookup)

# How to Use Finnhub stock symbol lookup in opencode

Finnhub stock symbol lookup returns matching securities with descriptions, display tickers, Finnhub symbols, and security types. Use it to resolve a company or security identifier before researching the selected symbol.

|  |  |
| --- | --- |
| Model | Finnhub stock symbol lookup |
| 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 stock symbol lookup in opencode

- Use Finnhub stock symbol lookup to search Microsoft, then add a candidate picker to this project's watchlist form using the returned descriptions and tickers.
- Use Finnhub stock symbol lookup for US0378331005 and show the returned candidates in this project's holdings import preview.
- Use Finnhub stock symbol lookup for Berkshire Hathaway and add a review screen that keeps returned security types visible while choosing a symbol.
- Use Finnhub stock symbol lookup for Toyota and render the returned descriptions, display tickers, and Finnhub symbols in this project's research page.
- Use Finnhub stock symbol lookup for NVIDIA and update this project's security selector to retain the chosen Finnhub symbol separately from its display ticker.

## How to set up Finnhub stock symbol lookup in opencode

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

### Use Spiral's MCP server

1. **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.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **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.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 stock symbol lookup**: 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/symbols/search",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Finnhub stock symbol lookup on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Finnhub stock symbol lookup tools and prices

- [Finnhub · Symbol search](https://spiral.ai/tools/alexandria/finnhub-gateway/symbols/search) (Alexandria): $0.00873 per call.

## What can you do with Finnhub stock symbol lookup in opencode?

Build a security picker that shows Finnhub descriptions, tickers, and security types beside each candidate. A coding agent can also add identifier matching to a holdings importer and retain the selected Finnhub symbol.

### Resolve company names in a watchlist

Turn names such as Microsoft and Toyota into candidate Finnhub symbols, with descriptions available for review before selecting a security.

### Match security identifiers during an import

Look up an ISIN or CUSIP from a holdings import and present the matching securities for confirmation.

### Build a security selection screen

Show returned descriptions, tickers, and security types so users can choose a candidate before continuing their research.

### Review ambiguous company references

Search a name from a market research brief and compare the returned candidates before attaching a symbol to the brief.

### Prepare symbols for downstream research

Resolve the intended security and retain its returned Finnhub symbol for subsequent data requests.

### Review changes in saved search results

Repeat selected searches and compare candidate symbols, descriptions, and security types with an earlier response to produce a review queue.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Finnhub stock symbol lookup in other agents

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

## More opencode guides

- [Finnhub company profile](https://spiral.ai/integrations/opencode/finnhub-company-profile)
- [Fireround company funding profile](https://spiral.ai/integrations/opencode/fireround-company-funding-profile)
- [Finnhub company news](https://spiral.ai/integrations/opencode/finnhub-company-news)
- [Fireround company funding rounds](https://spiral.ai/integrations/opencode/fireround-company-funding-rounds)
- [Federal Reserve statistical data](https://spiral.ai/integrations/opencode/federal-reserve-statistical-data)
- [Fireround funded company search](https://spiral.ai/integrations/opencode/fireround-funded-company-search)

## Questions about Finnhub stock symbol lookup in opencode

**Can opencode use Finnhub stock symbol lookup?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Finnhub stock symbol lookup like any built-in tool.

**How much does Finnhub stock symbol lookup 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 stock symbol lookup in opencode?**

No. Spiral runs Finnhub stock symbol lookup 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 stock symbol lookup in opencode?**

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

**Does opencode wait while Finnhub stock symbol lookup runs?**

Finnhub stock symbol lookup runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**What information does Finnhub return for a matching security?**

Each match has four documented properties: a security description, a display ticker, a Finnhub symbol, and a security type.

**Does the result count cover every security that could match?**

Finnhub describes the search as returning best-matching symbols. The count reports the number of results; the documentation does not establish it as a complete inventory of matching securities.

**Which returned ticker should I use for another Finnhub request?**

Use the returned symbol. Finnhub documents it as the unique identifier used by its candle endpoint, while displaySymbol is the display name.

**Does Finnhub guarantee that its security data is complete and accurate?**

No. Finnhub's terms explicitly disclaim guarantees about both accuracy and completeness of data accessed through the service.

**Can I publish Finnhub search results or share a derived symbol directory?**

Finnhub's published terms require written approval before sharing its data or derived results with third parties. That restriction covers derived results as well as the original data.

