> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Financial Datasets

> Access company fundamentals, financial statements, market data, SEC filings, ownership data, macroeconomic series, and financial analytics.

![Financial Datasets logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/financial_datasets_ai.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=a4829b66f5c308a4fe2085aae3ddcf14)

* **Category:** analytics
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 30
* **Triggers:** 0
* **Slug:** `FINANCIAL_DATASETS_AI`
* **Version:** 00000000\_00

## Tools

> [accordion] Get As-Reported Financials
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_AS_REPORTED_FINANCIALS`
>
> Return one page of issuer-reported financial statement fields without normalization for one statement family or all statements.
>
> #### Input Parameters
>
> **cik** `string`
>
> Company SEC CIK. Provide exactly one of cik or ticker on the first page.
>
> **limit** `integer`
>
> Total statement records requested across all pages. Provider pages contain at most 10 records.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a prior call. Pass it back unchanged, and omit statement\_type and every query filter.
>
> **period** `string ("annual" | "quarterly")`
>
> Reporting period type. Required on the first page; omit when continuing with cursor. As-reported routes do not support ttm.
>
> **ticker** `string`
>
> Company ticker. Provide exactly one of ticker or cik on the first page.
>
> **report\_period** `string`
>
> Require this exact report period in YYYY-MM-DD format.
>
> **statement\_type** `string ("income" | "balance_sheet" | "cash_flow" | "all")`
>
> As-reported statement family to return. A continuation cursor retains the original family.
>
> **report\_period\_gt** `string`
>
> Return report periods strictly after this YYYY-MM-DD date.
>
> **report\_period\_lt** `string`
>
> Return report periods strictly before this YYYY-MM-DD date.
>
> **report\_period\_gte** `string`
>
> Return report periods on or after this YYYY-MM-DD date.
>
> **report\_period\_lte** `string`
>
> Return report periods on or before this YYYY-MM-DD date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Beneficial Ownership
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_BENEFICIAL_OWNERSHIP`
>
> Return one page of current or historical SEC Schedule 13D and 13G stakes by subject ticker or beneficial-owner CIK.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Total ownership rows requested across all pages. Each provider page contains up to 10 rows.
>
> **cursor** `string`
>
> Opaque next\_cursor returned by a prior call. When set, omit every other field because it retains the original filters.
>
> **ticker** `string`
>
> Subject company ticker. Provide exactly one of ticker or filer\_cik for the first page.
>
> **history** `boolean`
>
> Return the full amendment history of each stake instead of only its current state.
>
> **filer\_cik** `string`
>
> SEC CIK of the beneficial owner. Provide exactly one of filer\_cik or ticker for the first page.
>
> **filing\_date** `string`
>
> Require an exact SEC filing date in YYYY-MM-DD format.
>
> **filing\_date\_gt** `string`
>
> Return filings strictly after this date in YYYY-MM-DD format.
>
> **filing\_date\_lt** `string`
>
> Return filings strictly before this date in YYYY-MM-DD format.
>
> **ownership\_type** `string ("activist" | "passive")`
>
> Restrict results to activist Schedule 13D or passive Schedule 13G stakes.
>
> **filing\_date\_gte** `string`
>
> Return filings on or after this date in YYYY-MM-DD format.
>
> **filing\_date\_lte** `string`
>
> Return filings on or before this date in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Facts
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_COMPANY_FACTS`
>
> Return a company's identity, classification, exchange, and active-status facts by ticker or SEC CIK.
>
> #### Input Parameters
>
> **cik** `string`
>
> Company SEC Central Index Key (CIK). Provide exactly one of cik or ticker.
>
> **ticker** `string`
>
> Company ticker symbol. Provide exactly one of ticker or cik.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company KPIs
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_COMPANY_KPIS`
>
> Return one page of reported operating KPIs, forward guidance, or non-GAAP metrics for a company, including source provenance.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Total periods requested across provider pages (1-50).
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a prior call. Pass it back unchanged and omit every other field; it retains the KPI family and filters.
>
> **period** `string ("quarterly" | "annual")`
>
> Reporting period type.
>
> **ticker** `string`
>
> Company ticker symbol. Required on the first page; omit with cursor.
>
> **data\_type** `string ("reported" | "guidance" | "non_gaap")`
>
> KPI family to return: reported operating metrics, forward guidance, or non-GAAP metrics.
>
> **metric\_name** `string`
>
> Restrict results to one provider-defined metric name.
>
> **report\_period\_gte** `string`
>
> Return records on or after this date in YYYY-MM-DD format.
>
> **report\_period\_lte** `string`
>
> Return records on or before this date in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Earnings
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_EARNINGS`
>
> Return one page of recent company earnings filings with quarterly and annual financial metrics, detected signals, and a continuation cursor.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Total report periods requested across pages (1-40; defaults to 1). A period can contain multiple filings, so the provider may return more earnings records than this value.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a prior call. Pass it back unchanged and omit ticker and limit; it retains the original request filters.
>
> **ticker** `string`
>
> Company ticker symbol. Required on the first page; omit with cursor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Financial Metrics
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_FINANCIAL_METRICS`
>
> Return a company's current metrics snapshot or one historical page of valuation, profitability, efficiency, liquidity, leverage, growth, and per-share metrics by ticker or SEC CIK.
>
> #### Input Parameters
>
> **cik** `string`
>
> Company SEC CIK. Provide exactly one of cik or ticker unless continuing with cursor.
>
> **view** `string ("current" | "historical")`
>
> Return the latest metrics snapshot or one page of historical metric records. Historical-only filters are rejected for current view.
>
> **limit** `integer`
>
> Total metric records requested across all pages. Provider pages contain up to 10 records.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a prior call. Pass it back unchanged and omit view, ticker, cik, period, limit, and all date filters. A cursor-only request continues historical results.
>
> **period** `string ("annual" | "quarterly" | "ttm")`
>
> Historical reporting period type. Required for an initial historical request.
>
> **ticker** `string`
>
> Company ticker. Provide exactly one of ticker or cik unless continuing with cursor.
>
> **filing\_date** `string`
>
> Require this exact SEC filing date. Rows without a known filing date are excluded.
>
> **report\_period** `string`
>
> Require this exact report period in YYYY-MM-DD format.
>
> **filing\_date\_gt** `string`
>
> Return rows filed strictly after this date; rows without a known filing date are excluded.
>
> **filing\_date\_lt** `string`
>
> Return rows filed strictly before this date; rows without a known filing date are excluded.
>
> **filing\_date\_gte** `string`
>
> Return rows filed on or after this date; rows without a known filing date are excluded.
>
> **filing\_date\_lte** `string`
>
> Return rows filed on or before this date for point-in-time research; rows without a known filing date are excluded.
>
> **report\_period\_gt** `string`
>
> Return report periods strictly after this date.
>
> **report\_period\_lt** `string`
>
> Return report periods strictly before this date.
>
> **report\_period\_gte** `string`
>
> Return report periods on or after this date.
>
> **report\_period\_lte** `string`
>
> Return report periods on or before this date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Financial Statements
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_FINANCIAL_STATEMENTS`
>
> Return one provider page of normalized income statements, balance sheets, cash-flow statements, or all three for a company.
>
> #### Input Parameters
>
> **cik** `string`
>
> Company SEC CIK. Provide exactly one of cik or ticker for the first page.
>
> **limit** `integer`
>
> Total statement records requested across all pages. Provider pages contain up to 10 records.
>
> **cursor** `string`
>
> Opaque next\_cursor returned by a prior call. When set, omit every other field because the cursor retains the original route and filters.
>
> **period** `string ("annual" | "quarterly" | "ttm")`
>
> Reporting period type. Required for the first page.
>
> **ticker** `string`
>
> Company ticker. Provide exactly one of ticker or cik for the first page.
>
> **filing\_date** `string`
>
> Require this exact SEC filing date. Rows without a known filing date are excluded.
>
> **report\_period** `string`
>
> Require this exact report period in YYYY-MM-DD format.
>
> **filing\_date\_gt** `string`
>
> Return rows filed strictly after this date; rows without a known filing date are excluded.
>
> **filing\_date\_lt** `string`
>
> Return rows filed strictly before this date; rows without a known filing date are excluded.
>
> **statement\_type** `string ("income" | "balance_sheet" | "cash_flow" | "all")`
>
> Normalized statement family to return.
>
> **filing\_date\_gte** `string`
>
> Return rows filed on or after this date; rows without a known filing date are excluded.
>
> **filing\_date\_lte** `string`
>
> Return rows filed on or before this date for point-in-time research; rows without a known filing date are excluded.
>
> **report\_period\_gt** `string`
>
> Return report periods strictly after this date.
>
> **report\_period\_lt** `string`
>
> Return report periods strictly before this date.
>
> **report\_period\_gte** `string`
>
> Return report periods on or after this date.
>
> **report\_period\_lte** `string`
>
> Return report periods on or before this date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get GPU Prices
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_GPU_PRICES`
>
> Return today's GPU rental price index or one page of historical daily prices for a GPU model, including provider spread, changes, and source attribution.
>
> #### Input Parameters
>
> **view** `string ("current" | "historical")`
>
> Return today's GPU prices or one page of historical daily prices.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a historical call. Pass it back unchanged and omit view, series, start\_date, and end\_date.
>
> **series** `string`
>
> GPU model series ID, such as h100. Required for an initial historical request and optional for current prices. Use List Macro Options with option\_type='gpu\_price\_series' to discover IDs.
>
> **end\_date** `string`
>
> Last historical UTC day to include, in YYYY-MM-DD format.
>
> **start\_date** `string`
>
> First historical UTC day to include, in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Index Fund Holdings
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_INDEX_FUND_HOLDINGS`
>
> Return one page of a fund's constituents by fund ticker, or one page of funds containing a security by holding ticker.
>
> #### Input Parameters
>
> **as\_of** `string`
>
> For ticker searches only, return the fund composition in effect on or before this YYYY-MM-DD date.
>
> **limit** `integer`
>
> Total rows requested across all provider pages. Each page contains at most 10 rows; the provider documents no maximum total.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a prior call. Pass it back unchanged and omit every other field; it retains the original direction and filters.
>
> **offset** `integer`
>
> Rows to skip on the initial request. Prefer cursor for continuation.
>
> **ticker** `string`
>
> Fund ticker whose constituents to return. Provide exactly one of ticker or holding on the first page.
>
> **holding** `string`
>
> Held-security ticker used to find funds containing it. Provide exactly one of holding or ticker on the first page.
>
> **asset\_class** `string ("equity" | "bond")`
>
> For ticker searches only, restrict constituents to equity or bond holdings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Inflation
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_INFLATION`
>
> Return the latest CPI values for all or one inflation series, or monthly history for one series.
>
> #### Input Parameters
>
> **view** `string ("historical" | "current")`
>
> Return the latest CPI values or monthly history.
>
> **cursor** `string`
>
> Opaque continuation returned as next\_cursor; pass it alone without view, series, or date filters.
>
> **series** `string`
>
> Inflation series ID such as cpi\_all\_sa; required for historical view and optional for current view.
>
> **end\_date** `string`
>
> Last historical month to include, expressed as YYYY-MM-DD.
>
> **start\_date** `string`
>
> First historical month to include, expressed as YYYY-MM-DD.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Insider Ownership
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_INSIDER_OWNERSHIP`
>
> Return one page of company insider holdings reported on SEC Forms 3 and 5, including common and derivative positions.
>
> #### Input Parameters
>
> **name** `string`
>
> Case-insensitive substring of the insider's name.
>
> **limit** `integer`
>
> Total holding rows requested across all pages. The provider defaults to 10 and documents no maximum.
>
> **cursor** `string`
>
> Continuation URL returned as next\_cursor. Pass it back unchanged and omit ticker, filters, and limit.
>
> **ticker** `string`
>
> Company ticker symbol. Required for the first page; omit with cursor.
>
> **form\_type** `string ("3" | "3/A" | "5" | "5/A")`
>
> SEC ownership form: 3, 3/A, 5, or 5/A.
>
> **filing\_date** `string`
>
> Exact SEC filing date in YYYY-MM-DD format.
>
> **filing\_date\_gt** `string`
>
> Include filings accepted strictly after this YYYY-MM-DD date.
>
> **filing\_date\_lt** `string`
>
> Include filings accepted strictly before this YYYY-MM-DD date.
>
> **filing\_date\_gte** `string`
>
> Include filings accepted on or after this YYYY-MM-DD date.
>
> **filing\_date\_lte** `string`
>
> Include filings accepted on or before this YYYY-MM-DD date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Institutional Holdings
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_INSTITUTIONAL_HOLDINGS`
>
> Return one page of SEC 13F holdings by institution CIK or held-company ticker.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Total holdings requested across all provider pages.
>
> **cursor** `string`
>
> Continuation cursor returned as next\_cursor by a prior call. Pass it alone to continue; the cursor retains the original selector and filters.
>
> **ticker** `string`
>
> Ticker of the held company. Provide exactly one of ticker or filer\_cik for the first page.
>
> **filer\_cik** `string`
>
> Institutional filer's 10-digit zero-padded SEC CIK. Provide exactly one of filer\_cik or ticker for the first page.
>
> **report\_period** `string`
>
> Require this exact 13F report period in YYYY-MM-DD format.
>
> **report\_period\_gt** `string`
>
> Include report periods strictly after this YYYY-MM-DD date.
>
> **report\_period\_lt** `string`
>
> Include report periods strictly before this YYYY-MM-DD date.
>
> **report\_period\_gte** `string`
>
> Include report periods on or after this YYYY-MM-DD date.
>
> **report\_period\_lte** `string`
>
> Include report periods on or before this YYYY-MM-DD date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Interest Rates
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_INTEREST_RATES`
>
> Return a central bank's current policy rate or one newest-first page of historical daily rates for a date range. Historical pages contain up to 10 rows; use next\_cursor to continue.
>
> #### Input Parameters
>
> **bank** `string`
>
> Central bank code, such as FED, ECB, or BOJ. Required unless cursor is provided. Use List Macro Options to discover supported codes.
>
> **view** `string ("historical" | "current")`
>
> Return the current policy rate or historical rate observations.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a historical call. Pass it back unchanged and omit bank, view, start\_date, and end\_date.
>
> **end\_date** `string`
>
> Last historical date to include, in YYYY-MM-DD format. Historical results default to today when omitted.
>
> **start\_date** `string`
>
> First historical date to include, in YYYY-MM-DD format. Historical results default to five years before end\_date when both dates are omitted; omit start\_date with an end\_date for all available history.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Labor Market
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_LABOR_MARKET`
>
> Return the latest print for all or one US labor series, or one page of historical monthly or weekly observations for one series.
>
> #### Input Parameters
>
> **view** `string ("current" | "historical")`
>
> Return the latest labor prints or one page of historical observations.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a historical call. Pass it back unchanged and omit view, series, start\_date, and end\_date.
>
> **series** `string`
>
> Labor series ID, such as payrolls\_sa. Required for an initial historical request and optional for current data. Use List Macro Options with option\_type='labor\_series' to discover IDs.
>
> **end\_date** `string`
>
> Last historical period to include, in YYYY-MM-DD format.
>
> **start\_date** `string`
>
> First historical period to include, in YYYY-MM-DD format. Any day in a month selects that month for monthly series.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Price History
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_PRICE_HISTORY`
>
> Return one page of historical OHLCV stock prices for an inclusive date range at a daily, weekly, monthly, or yearly interval.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a prior call. Pass it back unchanged and omit ticker, interval, start\_date, and end\_date.
>
> **ticker** `string`
>
> Company ticker symbol. Required on the first page.
>
> **end\_date** `string`
>
> Last date to include, in YYYY-MM-DD format. Required on the first page.
>
> **interval** `string ("day" | "week" | "month" | "year")`
>
> Price aggregation interval. Required on the first page.
>
> **start\_date** `string`
>
> First date to include, in YYYY-MM-DD format. Required on the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Price Snapshot
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_PRICE_SNAPSHOT`
>
> Return a real-time price snapshot for one ticker or snapshots for the broad market.
>
> #### Input Parameters
>
> **scope** `string ("ticker" | "market")`
>
> Return one ticker snapshot or the broad market snapshot set.
>
> **ticker** `string`
>
> Company ticker symbol. Required when scope is ticker; omit for market.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get SEC Filing Items
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_SEC_FILING_ITEMS`
>
> Extract selected sections from a 10-K, 10-Q, or 8-K, optionally including 8-K exhibits, and wait for asynchronous preparation when needed.
>
> #### Input Parameters
>
> **item** `string`
>
> Machine section selector. Use Item-1 style for 10-K filings and Part-1,Item-1 style for 10-Q filings. Use List Filing Options to discover other documented selectors.
>
> **year** `integer` *required*
>
> Calendar year of the filing.
>
> **ticker** `string` *required*
>
> Company ticker symbol.
>
> **quarter** `integer`
>
> Fiscal quarter, normally needed to identify a 10-Q filing.
>
> **filing\_type** `string ("10-K" | "10-Q" | "8-K")` *required*
>
> SEC filing type to extract.
>
> **accession\_number** `string`
>
> Exact SEC accession number when the year and filing type are ambiguous.
>
> **include\_exhibits** `boolean`
>
> Include linked exhibit text for an 8-K filing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Segmented Financials
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_SEGMENTED_FINANCIALS`
>
> Return one page of company-reported business or product segments for one statement family or all statements.
>
> #### Input Parameters
>
> **cik** `string`
>
> Company SEC Central Index Key. Provide exactly one of cik or ticker on the first page.
>
> **limit** `integer`
>
> Total segmented-financial records requested across provider pages.
>
> **cursor** `string`
>
> Exact next\_cursor URL returned by a prior call. Pass it back unchanged and omit every other field; it retains the original route and filters.
>
> **period** `string ("annual" | "quarterly")`
>
> Reporting period type. Required on the first page; segmented financials do not support TTM.
>
> **ticker** `string`
>
> Company ticker symbol. Provide exactly one of ticker or cik on the first page.
>
> **report\_period** `string`
>
> Require this exact report period in YYYY-MM-DD format.
>
> **statement\_type** `string ("income" | "balance_sheet" | "cash_flow" | "all")`
>
> Statement family whose reported segments to return.
>
> **report\_period\_gt** `string`
>
> Include report periods strictly after this YYYY-MM-DD date.
>
> **report\_period\_lt** `string`
>
> Include report periods strictly before this YYYY-MM-DD date.
>
> **report\_period\_gte** `string`
>
> Include report periods on or after this YYYY-MM-DD date.
>
> **report\_period\_lte** `string`
>
> Include report periods on or before this YYYY-MM-DD date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Treasury Yield Curve
>
> **Slug:** `FINANCIAL_DATASETS_AI_GET_TREASURY_YIELD_CURVE`
>
> Return the latest US Treasury par yield curve or historical daily curves for a date range. Historical results are newest first and return one provider page.
>
> #### Input Parameters
>
> **view** `string ("current" | "historical")`
>
> Return the latest curve or historical daily curves.
>
> **cursor** `string`
>
> Opaque continuation returned as next\_cursor. Pass it alone without view, start\_date, or end\_date; a cursor-only request continues historical results.
>
> **end\_date** `string`
>
> Last historical date to include, in YYYY-MM-DD format.
>
> **start\_date** `string`
>
> First historical date to include, in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Dataset Identifiers
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_DATASET_IDENTIFIERS`
>
> List every ticker, CIK, or sector returned by one selected Financial Datasets data-family catalog.
>
> #### Input Parameters
>
> **dataset** `string ("institutional_holdings_tickers" | "index_fund_tickers" | "price_snapshot_tickers" | "financial_metric_snapshot_tickers" | "company_fact_tickers" | "company_fact_ciks" | "earnings_tickers" | "filing_tickers" | "filing_ciks" | "price_history_tickers" | "kpi_tickers" | "kpi_sectors")` *required*
>
> Data family and identifier type whose accepted values to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Filing Options
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_FILING_OPTIONS`
>
> List supported SEC filing types or the documented section-selector catalog for filing extraction. The item catalog is not exhaustive: live 10-Q extraction accepted Part-1,Item-1 even though discovery omitted it.
>
> #### Input Parameters
>
> **filing\_type** `string`
>
> Optional filing type whose item-selector catalog to return, such as 10-K or 10-Q. Valid only when option\_type is item\_types.
>
> **option\_type** `string ("filing_types" | "item_types")` *required*
>
> Return filing types or filing section/item selectors.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Insider Trades
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_INSIDER_TRADES`
>
> Return one page of reported insider purchases, sales, gifts, awards, and other transactions for a company.
>
> #### Input Parameters
>
> **name** `string`
>
> Insider name to filter by.
>
> **limit** `integer`
>
> Total transaction rows requested across pages; provider default is 10.
>
> **cursor** `string`
>
> Opaque continuation returned as next\_cursor. When set, omit ticker and all filters, including limit.
>
> **ticker** `string`
>
> Company ticker symbol. Required for the first page; omit when continuing with cursor.
>
> **form\_type** `string ("4" | "4/A" | "5" | "5/A")`
>
> SEC transaction form type: 4, 4/A, 5, or 5/A.
>
> **filing\_date** `string`
>
> Require this exact filing date in YYYY-MM-DD format.
>
> **filing\_date\_gt** `string`
>
> Only include filings strictly after this date in YYYY-MM-DD format.
>
> **filing\_date\_lt** `string`
>
> Only include filings strictly before this date in YYYY-MM-DD format.
>
> **filing\_date\_gte** `string`
>
> Only include filings on or after this date in YYYY-MM-DD format.
>
> **filing\_date\_lte** `string`
>
> Only include filings on or before this date in YYYY-MM-DD format.
>
> **transaction\_type** `string`
>
> Provider transaction label, such as Open market sale or Gift.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List IPO Filings
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_IPOS`
>
> Return one page of IPO, SPAC, shell-company, resale, or other SEC offering filings with optional company and filing-date filters.
>
> #### Input Parameters
>
> **cik** `string`
>
> Company SEC Central Index Key, with or without leading zeros.
>
> **limit** `integer`
>
> Total IPO rows requested across pages; provider default is 10.
>
> **cursor** `string`
>
> Opaque continuation returned as next\_cursor. When set, omit all other filters, including limit.
>
> **ticker** `string`
>
> Proposed company ticker from the filing cover page.
>
> **filing\_date** `string`
>
> Require this exact SEC filing date in YYYY-MM-DD format.
>
> **classification** `string ("ipo" | "shell_company" | "spac" | "resale" | "other")`
>
> Offering classification to return.
>
> **filing\_date\_gt** `string`
>
> Only include filings strictly after this date in YYYY-MM-DD format.
>
> **filing\_date\_lt** `string`
>
> Only include filings strictly before this date in YYYY-MM-DD format.
>
> **filing\_date\_gte** `string`
>
> Only include filings on or after this date in YYYY-MM-DD format.
>
> **filing\_date\_lte** `string`
>
> Only include filings on or before this date in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Macro Options
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_MACRO_OPTIONS`
>
> List valid central-bank codes or inflation, GPU price, and labor series IDs and metadata for macroeconomic queries.
>
> #### Input Parameters
>
> **option\_type** `string ("inflation_series" | "central_banks" | "gpu_price_series" | "labor_series")` *required*
>
> The macro selector catalog to return.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List News
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_NEWS`
>
> Return one page of recent company-specific or broad-market news articles.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Total number of articles requested across pages (1-10).
>
> **cursor** `string`
>
> Continuation cursor returned by a prior call. When provided, the provider retains the original ticker and limit; omit those fields.
>
> **ticker** `string`
>
> Company ticker symbol; omit to return broad-market news.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Screener Filters
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_SCREENER_FILTERS`
>
> List all financial fields, company classifications, and comparison operators currently accepted by the company screener.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List SEC Filings
>
> **Slug:** `FINANCIAL_DATASETS_AI_LIST_SEC_FILINGS`
>
> Return one page of SEC filing metadata and source URLs with optional company and form filters.
>
> #### Input Parameters
>
> **cik** `string`
>
> Company SEC Central Index Key (CIK) to filter filings.
>
> **limit** `integer`
>
> Total filing rows requested across all provider pages.
>
> **cursor** `string`
>
> Opaque continuation returned as next\_cursor. When set, omit ticker, CIK, filing\_types, and limit because the cursor retains those filters.
>
> **ticker** `string`
>
> Company ticker symbol to filter filings.
>
> **filing\_types** `array`
>
> SEC filing types to include. Each value is sent as a repeated filing\_type query parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Screen Companies
>
> **Slug:** `FINANCIAL_DATASETS_AI_SCREEN_COMPANIES`
>
> Find companies whose financial fields, ticker, CIK, sector, or industry satisfy structured comparison filters.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of matching companies to return (minimum 1).
>
> **filters** `array` *required*
>
> One or more structured company-screening filters; all filters are applied together.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Financial Line Items
>
> **Slug:** `FINANCIAL_DATASETS_AI_SEARCH_FINANCIAL_LINE_ITEMS`
>
> Return selected financial line items for one or more company tickers and a reporting period type.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of matching records to return (minimum 1).
>
> **period** `string ("annual" | "quarterly" | "ttm")`
>
> Reporting period type for the financial data.
>
> **tickers** `array` *required*
>
> Company ticker symbols to query; provide at least one.
>
> **line\_items** `array` *required*
>
> Financial metric names to return, such as revenue or net\_income; provide at least one.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Institutional Investors
>
> **Slug:** `FINANCIAL_DATASETS_AI_SEARCH_INSTITUTIONAL_INVESTORS`
>
> Find institutional investor names and SEC CIKs by a case-insensitive name prefix, or omit name to return the provider's discovery list.
>
> #### Input Parameters
>
> **name** `string`
>
> Case-insensitive investor-name prefix to search for; omit to return the provider's discovery list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
