Tools/sec-filings

Company Filings & Fundamentals (US)

Active

Your agent recalls fuzzy financials from training data; this returns exact figures from SEC EDGAR filings.

5 tools

US public-company disclosures from SEC EDGAR: a company's filing history, reported financial facts (XBRL), single line-item concepts, and cross-company comparisons for one metric and period. Public-domain regulatory data.

Finance & Marketssecedgarfilingsfundamentalsfinancials

Tools (5)

▶company_filings

A company's filing history (10-K, 10-Q, 8-K, and more) with dates and document links.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Show Apple's recent SEC filings”
“When did Tesla last file a 10-K?”
“List the latest 8-K filings for CIK 0000320193”
“Find Microsoft's most recent quarterly report”

Parameters

cikstringrequired

10-digit zero-padded SEC CIK (e.g. 0000320193). Resolve from a ticker with lookup_cik.

API Usage

curl -X POST "https://skill.askfaro.com/skills/sec-filings/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Show Apple's recent SEC filings"
  }
}'

CLI Usage

askfaro describe sec-filings/company_filings

Install pip install askfaro-cli, then askfaro auth login.

▶company_facts

A company's reported financials summarized — every concept with its latest reported value.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Get Apple's reported financials”
“Show all XBRL facts for CIK 0000320193”
“Pull Tesla's financial statement data”

Parameters

cikstringrequired

10-digit zero-padded SEC CIK (e.g. 0000320193). Resolve from a ticker with lookup_cik.

API Usage

curl -X POST "https://skill.askfaro.com/skills/sec-filings/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get Apple's reported financials"
  }
}'

CLI Usage

askfaro describe sec-filings/sec-filings.company_facts

Install pip install askfaro-cli, then askfaro auth login.

▶company_concept

One financial line item for a company over time (e.g. Revenues), with all reported values.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Show Apple's revenue over time”
“Get net income history for CIK 0000320193”
“Track Tesla's cash and cash equivalents by quarter”

Parameters

cikstringrequired

10-digit zero-padded SEC CIK (e.g. 0000320193).

tagstringrequired

XBRL concept tag, e.g. Revenues, NetIncomeLoss, AccountsPayableCurrent.

taxonomystringrequireddefault: "us-gaap"

XBRL taxonomy, usually "us-gaap" (also "dei", "ifrs-full").

API Usage

curl -X POST "https://skill.askfaro.com/skills/sec-filings/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Show Apple's revenue over time"
  }
}'

CLI Usage

askfaro describe sec-filings/company_concept

Install pip install askfaro-cli, then askfaro auth login.

▶frames

One financial metric reported by every company for a single period, for cross-company comparison.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Compare accounts payable across companies for Q1 2019”
“Which companies reported the most revenue in 2023?”
“Get the AccountsPayableCurrent frame for CY2019Q1I”

Parameters

tagstringrequired

XBRL concept tag, e.g. Revenues, AccountsPayableCurrent.

unitstringrequireddefault: "USD"

Unit of measure, e.g. USD. Ratios use forms like USD-per-shares.

periodstringrequired

SEC frame period: CY#### (year), CY####Q# (quarter), trailing I for instantaneous, e.g. CY2019Q1I.

taxonomystringrequireddefault: "us-gaap"

XBRL taxonomy, usually "us-gaap".

API Usage

curl -X POST "https://skill.askfaro.com/skills/sec-filings/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Compare accounts payable across companies for Q1 2019"
  }
}'

CLI Usage

askfaro describe sec-filings/frames

Install pip install askfaro-cli, then askfaro auth login.

▶lookup_cik

Resolve a stock ticker or company name to its SEC CIK number.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“What is Apple's CIK number?”
“Find the SEC CIK for ticker NVDA”
“Look up the central index key for Microsoft”

Parameters

limitintegeroptionaldefault: 10

Maximum candidate matches to return.

querystringrequired

A stock ticker (e.g. AAPL) or company name (e.g. Apple) to resolve.

API Usage

curl -X POST "https://skill.askfaro.com/skills/sec-filings/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What is Apple's CIK number?"
  }
}'

CLI Usage

askfaro describe sec-filings/sec-filings.lookup_cik

Install pip install askfaro-cli, then askfaro auth login.