[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Fiscal.ai insider holdings](https://spiral.ai/integrations/opencode/fiscal-ai-insider-holdings)

# How to Use Fiscal.ai insider holdings in opencode

Returns company insiders' holdings with direct and indirect ownership detail and security classes. Use it to examine reported equity stakes rather than recent transactions.

|  |  |
| --- | --- |
| Model | Fiscal.ai insider holdings |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.026189 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Fiscal.ai insider holdings in opencode

- Use Fiscal.ai insider holdings for Apple on Nasdaq and build an internal table that separates direct and indirect holdings by security class.
- Use Fiscal.ai insider holdings to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Fiscal.ai insider holdings and tell me what changed since last week.
- Check Fiscal.ai insider holdings and summarize what you find in three bullet points.
- Pull the newest data from Fiscal.ai insider holdings and give me the result as a table.

## How to set up Fiscal.ai insider holdings 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 Fiscal.ai insider holdings**: 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": "fiscal-ai/ownership/insider-holders",
    "input": {
      "fscl": "<fscl>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Fiscal.ai insider holdings on Spiral, shows the price and runs it.

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

## Fiscal.ai insider holdings tools and prices

- [Fiscal.ai · Insider holders](https://spiral.ai/tools/alexandria/fiscal-ai/ownership/insider-holders) (Alexandria): $0.026189 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cik |  | — | SEC Central Index Key. Use when a company has no ticker, or after a rename. |
| figi |  | — | OpenFIGI identifier of the security. Licensed identifier. |
| fscl |  | — | Fiscal.ai's stable company identifier, the `companyFiscalIdentifier` field. The only identifier that survives a ticker change or a relisting, so prefer it when carrying a company between calls. |
| isin |  | — | ISIN of the security. Licensed identifier. |
| cusip |  | — | CUSIP of the security. Licensed identifier. |
| ticker |  | — | Ticker symbol, for example MSFT. Only unique within an exchange, so pass `exchange` with it. |

## What can you do with Fiscal.ai insider holdings in opencode?

Build an internal ownership view for US-listed companies with institutional positions and insider disclosures. Use Fiscal.ai's institutional identities and reporting dates to make comparisons easier to inspect.

### Investment committee ownership brief

Prepare an internal ownership appendix for Microsoft: identify institutional investors, examine their reported portfolios, and summarize insider stakes and transactions.

### Watchlist ownership review

Review Apple, Microsoft, and Nvidia for changes in institutional positions and insider activity. Resolve investment-manager identities and inspect their portfolios when a position warrants closer research.

### Acquisition diligence appendix

For a US-listed acquisition candidate, assemble institutional ownership, manager portfolio exposure, insider stakes, and recent insider transactions for the deal team's internal review.

### Ownership report quality review

Check manager identities, compare company and manager views of reported positions, inspect reporting dates, and review insider holdings alongside transaction balances before approving an internal report.

### Management equity exposure review

Examine reported insider stakes at Broadcom alongside transaction activity, separating open-market trades from grants, exercises, and tax withholding.

### Peer ownership comparison

Compare insider stakes, insider transaction types, and institutional ownership across Microsoft, Oracle, and Salesforce for an internal peer research note.

## Overview

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

## Fiscal.ai insider holdings in other agents

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

## More opencode guides

- [Fiscal.ai fund letter index](https://spiral.ai/integrations/opencode/fiscal-ai-fund-letter-index)
- [Fiscal.ai insider transactions](https://spiral.ai/integrations/opencode/fiscal-ai-insider-transactions)
- [Fiscal.ai fund letter details](https://spiral.ai/integrations/opencode/fiscal-ai-fund-letter-details)
- [Fiscal.ai institution directory](https://spiral.ai/integrations/opencode/fiscal-ai-institution-directory)
- [Fiscal.ai financial ratios by period](https://spiral.ai/integrations/opencode/fiscal-ai-financial-ratios-by-period)
- [Fiscal.ai institutional portfolio](https://spiral.ai/integrations/opencode/fiscal-ai-institutional-portfolio)

## Questions about Fiscal.ai insider holdings in opencode

**Can opencode use Fiscal.ai insider holdings?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Fiscal.ai insider holdings like any built-in tool.

**How much does Fiscal.ai insider holdings cost in opencode?**

$0.026189 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 Fiscal.ai insider holdings in opencode?**

No. Spiral runs Fiscal.ai insider holdings on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Fiscal.ai insider holdings in opencode?**

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

**Does opencode wait while Fiscal.ai insider holdings runs?**

Fiscal.ai insider holdings runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Which markets and historical periods does Fiscal.ai ownership cover?**

Fiscal.ai documents ownership coverage for US-listed companies and approximately three years of history.

**Where does the ownership data come from?**

Fiscal.ai identifies Form 4 filings as the basis for insider holdings and transactions, and Form 13F filings for institutional holdings.

**Do the latest institutional results all describe the same quarter?**

They can mix quarters. Fiscal.ai retains a previous-quarter position when a filer has not submitted the latest quarter, and returns the report date for each position.

**Does Fiscal.ai include every historical insider transaction?**

The transaction endpoint excludes holders removed from the company's insider list. It also hides inactive insiders by default.

**Does every insider share disposal represent an open-market sale?**

Fiscal.ai distinguishes open-market sales from grants, exercises, and tax withholding. Read the transaction type before counting activity as buying or selling.

