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

opencode · Finance

How to Use SEC EDGAR financial concept history in opencode

Returns one company's reported XBRL values for a single financial concept. Use it to examine a metric across filings without collecting every financial tag.

Prompts to try with SEC EDGAR financial concept history in opencode

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

Use SEC EDGAR financial concept history to retrieve Microsoft's reported net income values and build a table in this project showing periods, units, and source accessions.

SEC EDGAR financial concept historyopencode
Try asking
  • Use SEC EDGAR financial concept history to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from SEC EDGAR financial concept history and tell me what changed since last week.

  • Check SEC EDGAR financial concept history and summarize what you find in three bullet points.

  • Pull the newest data from SEC EDGAR financial concept history and give me the result as a table.

How to set up SEC EDGAR financial concept history 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.

    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.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run SEC EDGAR financial concept history

    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": "sec-gov/filings/concept",
        "input": {
          "concept": "<concept>"
        }
      }'

Then paste one of the prompts above: opencode finds SEC EDGAR financial concept history on Spiral, shows the price and runs it.

SEC EDGAR financial concept history providers and prices

Spiral runs SEC EDGAR financial concept history through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
SEC EDGAR · Concept
sec-gov/filings/concept

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Cika number

SEC Central Index Key, with or without leading zeros.

Limit1 to 5000200

limit

Taxonomyus-gaap, dei, ifrs-full, or srtus-gaap

taxonomy

Every API field of SEC EDGAR · Concept is on its tool page: open its card above.

What can you do with SEC EDGAR financial concept history in opencode?

Build a corporate disclosure database that connects SEC company identities, filing records, and reported financial facts. A coding agent can add publication checks and focused retrieval to the project's research workflow.

Build an industrial peer comparison

Collect a company universe, select industrial peers, and confirm their reporting identities. Gather financial facts, inspect individual concepts, and connect the comparison to each company's filing history.

Monitor listed corporate borrowers

Build a borrower reference directory and establish a baseline of reported financial facts. Check published daily indexes, recover missed dates, inspect relevant filing records, and refresh selected metrics for credit review.

Maintain a financial research database

Populate company reference records and reported financial facts, then use daily filing records to identify refresh candidates. Support targeted company lookups, older filing-history retrieval, and single-metric checks for analysts.

Check figures in an earnings research note

Confirm the reporting company, gather its financial facts, and inspect the specific concepts behind a draft table. Use its filing history to locate the disclosures associated with the reported figures.

Create a financial disclosure review queue

Start with a company directory and a baseline of reported metrics. Use newly published filing records to select companies for review, then examine their histories and financial concepts for changes requiring an analyst's attention.

Questions about SEC EDGAR financial concept history in opencode

Can opencode use SEC EDGAR financial concept history?

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run SEC EDGAR financial concept history like any built-in tool.

How much does SEC EDGAR financial concept history cost in opencode?

$0.00873 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 SEC EDGAR financial concept history in opencode?

No. Spiral runs SEC EDGAR financial concept history on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up SEC EDGAR financial concept history in opencode?

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

Does opencode wait while SEC EDGAR financial concept history runs?

SEC EDGAR financial concept history runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

Does the SEC ticker directory cover every EDGAR filer?

The SEC does not guarantee the accuracy or scope of its ticker association files. EDGAR also contains filings from entities beyond publicly traded companies.

How fresh is SEC EDGAR data?

SEC submissions typically update in under a second and XBRL in under a minute. Daily indexes follow a separate nightly process starting around 10 p.m. Eastern.

How far back do SEC filing indexes go?

Public filing indexes extend from the third quarter of 1994 onward. That archive boundary does not promise financial facts for every indexed filing.

Do daily indexes reflect later filing removals?

Removals processed on subsequent business days are not reflected in earlier daily indexes. An old index entry can therefore remain after the underlying filing has been removed.

Do the financial facts include every figure in a filing?

The SEC's XBRL aggregation covers standard-taxonomy facts applying to the entire filing entity. Custom company tags and segment-specific figures fall outside that boundary.

Get started

Start using SEC EDGAR financial concept history in opencode

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

Paste this into opencode:

Set up opencode

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