[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [FINRA bond trades](https://spiral.ai/integrations/instinct/finra-bond-trades)

# How to Use FINRA bond trades in Instinct

Returns individual reported bond transactions, including execution information, price, quantity, and yield where available. Use it to examine trading activity behind a dated price series.

|  |  |
| --- | --- |
| Model | FINRA bond trades |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with FINRA bond trades in Instinct

- Each market day, use FINRA bond trades for CUSIP 594918BB9 over the preceding seven days and summarize newly returned transactions.
- Every Monday at 9am: use FINRA bond trades to look this up and give me the result as a table.
- Pull the latest numbers from FINRA bond trades and tell me what changed since last week.
- Check FINRA bond trades and summarize what you find in three bullet points.
- Pull the newest data from FINRA bond trades and give me the result as a table.

## How to set up FINRA bond trades in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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 trades**: 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_trades",
    "input": {
      "cusip": "<cusip>"
    }
  }'
```

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

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

## FINRA bond trades tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cusip |  | — | 9-character CUSIP; resolved to its TRACE symbol through the securities master first. Pattern: ^[A-Za-z0-9]{9}$. |
| limit | 1 to 500 | 50 | limit |
| offset | 0 to … | 0 | offset |
| symbol |  | — | FINRA TRACE symbol (e.g. AAPL4880748). Pattern: ^[A-Za-z0-9.]+$. |
| end_date |  | — | YYYY-MM-DD; default today (UTC). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| start_date |  | — | YYYY-MM-DD; default 7 days before end_date. FINRA serves roughly one year of intraday history. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |

## What can you do with FINRA bond trades in Instinct?

Prepare recurring FINRA research reviews when your data-use rights permit scheduled collection. An always-on agent can compare new lookup results with earlier reviews and flag observations that need attention.

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

## FINRA bond trades in other agents

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

## More Instinct guides

- [FINRA bond search](https://spiral.ai/integrations/instinct/finra-bond-search)
- [FINRA most active bonds](https://spiral.ai/integrations/instinct/finra-most-active-bonds)
- [FINRA bond price history](https://spiral.ai/integrations/instinct/finra-bond-price-history)
- [FRED Series metadata](https://spiral.ai/integrations/instinct/fred-series-metadata)
- [FINRA bond details](https://spiral.ai/integrations/instinct/finra-bond-details)
- [FRED category details](https://spiral.ai/integrations/instinct/fred-category-details)

## Questions about FINRA bond trades in Instinct

**Can Instinct use FINRA bond trades?**

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

**How much does FINRA bond trades cost in Instinct?**

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

**Do I need an Alexandria account to use FINRA bond trades in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs FINRA bond trades on its own Alexandria account.

**How long does it take to set up FINRA bond trades in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while FINRA bond trades runs?**

FINRA bond trades runs in the background. Instinct 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.

