[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [FINRA bond search](https://spiral.ai/integrations/opencode/finra-bond-search)

# How to Use FINRA bond search in opencode

Returns matching bond records to help identify the issue you want to research. Use it to find a security before examining its terms, dated prices, or individual trades.

|  |  |
| --- | --- |
| Model | FINRA bond search |
| 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 FINRA bond search in opencode

- Use FINRA bond search to find Apple bond records using AAPL, then add a results table to my project that preserves the returned security identifiers.
- Use FINRA bond search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from FINRA bond search and tell me what changed since last week.
- Check FINRA bond search and summarize what you find in three bullet points.
- Pull the newest data from FINRA bond search and give me the result as a table.

## How to set up FINRA bond search 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 FINRA bond search**: 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": "finra-org/bond-quotes/bond_search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: opencode finds FINRA bond search on Spiral, shows the price and runs it.

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

## FINRA bond search tools and prices

- [FINRA fixed income data and BrokerCheck · Bond search](https://spiral.ai/tools/alexandria/finra-org/bond-quotes/bond_search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | 20 | Results per page (1-100). |
| offset | 0 to … | 0 | Zero-based offset into the result list. |

## What can you do with FINRA bond search in opencode?

Build a FINRA research view with bond observations and brokerage-firm lookup results. A coding agent can turn returned records into comparison tables and add the relevant views to your project.

### Build a bond research shortlist

Start with active corporate bonds, resolve the issues, and compare their terms, dated prices, and recent transactions to choose which securities deserve closer research.

### Review observed bond trading activity

Match each security, inspect its terms, and compare dated prices with individual transactions. Use the active-bond list as additional market context for the review.

### Compare an issuer’s bond issues

Resolve bonds from the same issuer and compare coupons, maturities, call features, price histories, and reported trades. Check which issues appear among the daily activity leaders.

### Prepare a bond review packet

Assemble identified securities, bond terms, dated price observations, transaction examples, and daily activity leaders into a research packet for a discussion with a financial professional.

## Overview

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

## FINRA bond search in other agents

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

## More opencode guides

- [FINRA bond price history](https://spiral.ai/integrations/opencode/finra-bond-price-history)
- [FINRA bond trades](https://spiral.ai/integrations/opencode/finra-bond-trades)
- [FINRA bond details](https://spiral.ai/integrations/opencode/finra-bond-details)
- [FINRA most active bonds](https://spiral.ai/integrations/opencode/finra-most-active-bonds)
- [FINRA BrokerCheck firm search](https://spiral.ai/integrations/opencode/finra-brokercheck-firm-search)
- [FRED Series metadata](https://spiral.ai/integrations/opencode/fred-series-metadata)

## Questions about FINRA bond search in opencode

**Can opencode use FINRA bond search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run FINRA bond search like any built-in tool.

**How much does FINRA bond search 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 FINRA bond search in opencode?**

No. Spiral runs FINRA bond search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up FINRA bond search in opencode?**

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

**Does opencode wait while FINRA bond search runs?**

FINRA bond search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Where does FINRA’s bond information come from?**

FINRA combines TRACE transaction reports with information from Refinitiv, S&P, Moody’s, and Black Knight Technologies. Security terms and transaction observations therefore come from multiple underlying sources.

**How far back does FINRA’s bond website go?**

FINRA documents up to 10 years of end-of-day corporate and agency bond data and three years of real-time trade history on individual security pages. Those website limits do not verify how much history a particular endpoint retrieves.

**Are FINRA bond prices executable quotes?**

FINRA disseminates executed transactions rather than bond quotes. A reported sale describes a completed trade and does not establish a price available for a new order.

**Does every bond transaction include a yield?**

No. FINRA says certain variable-rate securities and defaulted bonds trading without accrued interest display no yield.

**How broad is FINRA’s most-active bond list?**

FINRA publishes separate top-ten corporate-bond lists for investment-grade, high-yield, and convertible bonds on each market day. These lists are a shortlist of active issues rather than a complete bond inventory.

