[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [FINRA bond trades](https://spiral.ai/integrations/gemini-cli/finra-bond-trades)

# How to Use FINRA bond trades in Gemini CLI

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, no API key |

## Prompts to try with FINRA bond trades in Gemini CLI

- Use FINRA bond trades for CUSIP 594918BB9 over the last seven days and build a table of returned execution information, quantities, prices, and available yields.
- Use FINRA bond trades to look this up and give me the result as a table. Save the result in ./assets.
- 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 Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## 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 Gemini CLI?

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 Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

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

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

## Questions about FINRA bond trades in Gemini CLI

**Can Gemini CLI use FINRA bond trades?**

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

**How much does FINRA bond trades cost in Gemini CLI?**

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

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

No. Spiral runs FINRA bond trades 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 trades in Gemini CLI?**

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

**Does Gemini CLI wait while FINRA bond trades runs?**

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

