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

# How to Use FINRA bond search in Codex

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 Codex

- 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 Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

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

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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: Codex finds FINRA bond search on Spiral, shows the price and runs it.

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

## 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 Codex?

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 Codex guides](https://spiral.ai/integrations/codex)

## 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)
- [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)
- [opencode](https://spiral.ai/integrations/opencode/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 Codex guides

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

## Questions about FINRA bond search in Codex

**Can Codex use FINRA bond search?**

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

**How much does FINRA bond search cost in Codex?**

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

**Do I need an Alexandria account to use FINRA bond search in Codex?**

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 Codex?**

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

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

FINRA bond search runs in the background. Codex 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.

