Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Finance

How to Use Fiscal.ai insider transactions in Gemini CLI

Returns company insider transactions with dates, transaction types, share amounts, and filing sources. Use it to distinguish open-market activity from grants, exercises, and tax withholding.

Prompts to try with Fiscal.ai insider transactions in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use Fiscal.ai insider transactions for Broadcom on Nasdaq and add a report that separates open-market trades, grants, exercises, and tax withholding.

Fiscal.ai insider transactionsGemini CLI
Try asking
  • Use Fiscal.ai insider transactions 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 transactions and tell me what changed since last week.

  • Check Fiscal.ai insider transactions and summarize what you find in three bullet points.

  • Pull the newest data from Fiscal.ai insider transactions and give me the result as a table.

How to set up Fiscal.ai insider transactions 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    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 transactions

    One request; the result comes back by polling or a webhook.

    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-transactions",
        "input": {
          "fscl": "<fscl>"
        }
      }'

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

Fiscal.ai insider transactions providers and prices

Spiral runs Fiscal.ai insider transactions through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
Fiscal.ai · Insider transactions
fiscal-ai/ownership/insider-transactions

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page sizea number up to 250250

Rows per page, up to 250. Defaults to 250; page for more.

Page numbera number1

Page number, 1-indexed.

Include inactiveon or offfalse

Include holders marked inactive. Hidden by default; holders removed by an analyst override stay hidden either way.

Every API field of Fiscal.ai · Insider transactions is on its tool page: open its card above.

What can you do with Fiscal.ai insider transactions in Gemini CLI?

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.

Questions about Fiscal.ai insider transactions in Gemini CLI

Can Gemini CLI use Fiscal.ai insider transactions?

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

How much does Fiscal.ai insider transactions cost in Gemini CLI?

$0.026189 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 Fiscal.ai insider transactions in Gemini CLI?

No. Spiral runs Fiscal.ai insider transactions 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 transactions in Gemini CLI?

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

Does Gemini CLI wait while Fiscal.ai insider transactions runs?

Fiscal.ai insider transactions runs in the background. Gemini CLI 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.

Get started

Start using Fiscal.ai insider transactions in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options