{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } }, "schemas": { "Response0081E61F2639_CompanyFactsResponse": { "type": "object", "properties": { "company_facts": { "$ref": "#/components/schemas/Response0081E61F2639_CompanyFacts" } } }, "Response0081E61F2639_CompanyFacts": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol of the company." }, "name": { "type": "string", "description": "The name of the company." }, "cik": { "type": "string", "description": "The Central Index Key (CIK) of the company." }, "industry": { "type": "string", "description": "The industry of the company." }, "sector": { "type": "string", "description": "The sector of the company." }, "exchange": { "type": "string", "description": "The exchange of the company." }, "is_active": { "type": "boolean", "description": "Whether the company is currently active." }, "location": { "type": "string", "description": "The location of the company." }, "sec_filings_url": { "type": "string", "format": "uri", "description": "The URL of the company's SEC filings." }, "sic_code": { "type": "string", "description": "The Standard Industrial Classification (SIC) code of the company." }, "sic_industry": { "type": "string", "description": "The industry of the company based on the SIC code." }, "sic_sector": { "type": "string", "description": "The sector of the company based on the SIC code." } } }, "Response0081E61F2639_EarningsResponse": { "type": "object", "properties": { "earnings": { "type": "array", "description": "Flat list of SEC filings for the ticker, sorted by (report_period DESC, filing_date ASC). When `limit=N`, up to N report_periods worth of filings are returned; entry count may exceed N when a recent period has both an 8-K and a 10-Q/10-K.", "items": { "$ref": "#/components/schemas/Response0081E61F2639_EarningsRecord" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_EarningsRecord": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The requested ticker symbol." }, "report_period": { "type": "string", "format": "date", "description": "Report period this filing covers." }, "fiscal_period": { "type": "string", "description": "Fiscal period label (e.g. 2026-Q1 or 2025-FY)." }, "currency": { "type": "string", "description": "ISO currency code (e.g. USD)." }, "source_type": { "type": "string", "description": "The SEC form type backing this filing.", "enum": [ "8-K", "10-Q", "10-K", "20-F" ] }, "filing_date": { "type": "string", "format": "date", "description": "Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`." }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event)." }, "filing_window": { "type": [ "string", "null" ], "description": "Market session at the moment SEC accepted the filing, evaluated in Eastern Time. PRE_MARKET = weekday 04:00–09:30 ET. DURING_MARKET = weekday 09:30–16:00 ET. AFTER_HOURS = weekday outside regular trading hours. WEEKEND = Saturday or Sunday. Null when filing_datetime is unavailable.", "enum": [ "PRE_MARKET", "DURING_MARKET", "AFTER_HOURS", "WEEKEND" ] }, "signals": { "type": "array", "description": "Curated, market-moving insights distilled from this filing. Each item has a pre-rendered `headline`, structured `details`, and an `importance` ranking. Returned only when at least one signal fires for this entry; field is omitted otherwise. Capped at 8 per entry, ordered HIGH → MEDIUM → LOW.", "items": { "$ref": "#/components/schemas/Response0081E61F2639_Signal" } }, "filing_url": { "type": "string", "format": "uri", "description": "URL to the SEC filing." }, "accession_number": { "type": "string", "description": "SEC accession number identifying the filing." }, "quarterly": { "$ref": "#/components/schemas/Response0081E61F2639_EarningsTimeDimension" }, "annual": { "$ref": "#/components/schemas/Response0081E61F2639_EarningsTimeDimension" } }, "required": [ "ticker", "report_period", "source_type", "filing_date", "filing_url", "accession_number" ] }, "Response0081E61F2639_Signal": { "type": "object", "description": "A curated market-moving insight derived from this filing. Pre-rendered `headline` is suitable for direct display; `details` carries structured fields for filtering and programmatic use. Signals are returned in priority order (most material first); the `type` itself encodes magnitude (e.g. `STRONG_REVENUE_INCREASE` vs `REVENUE_INCREASE`).", "required": [ "type", "headline" ], "properties": { "type": { "type": "string", "description": "Signal category. MARGIN_EXPANSION/MARGIN_CONTRACTION: any of gross/operating/net margin moved year-over-year by ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: forward-looking guidance change reported in the filing. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: best- or worst-performing reportable segment by organic revenue growth. NON_GAAP_DIVERGENCE: an adjusted/non-GAAP figure differs materially from its GAAP counterpart on the same period. BACKLOG_SURGE/BACKLOG_DECLINE: backlog or remaining performance obligations moved year-over-year by ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE and DECLINE variants: tiered year-over-year revenue change (≥10% / ≥20% magnitude). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE and DECLINE variants: tiered year-over-year net income change (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE and DECLINE variants: tiered year-over-year EPS change (≥15% / ≥30%); independent from net income because share buybacks can amplify EPS movement. CAPEX_INCREASE/STRONG_CAPEX_INCREASE and DECLINE variants: tiered year-over-year capital expenditure change in spending magnitude (≥15% / ≥30%).", "enum": [ "MARGIN_EXPANSION", "MARGIN_CONTRACTION", "GUIDANCE_RAISED", "GUIDANCE_LOWERED", "GUIDANCE_REAFFIRMED", "GUIDANCE_INITIATED", "SEGMENT_OUTPERFORMANCE", "SEGMENT_UNDERPERFORMANCE", "NON_GAAP_DIVERGENCE", "BACKLOG_SURGE", "BACKLOG_DECLINE", "REVENUE_INCREASE", "REVENUE_DECLINE", "STRONG_REVENUE_INCREASE", "STRONG_REVENUE_DECLINE", "NET_INCOME_INCREASE", "NET_INCOME_DECLINE", "STRONG_NET_INCOME_INCREASE", "STRONG_NET_INCOME_DECLINE", "EPS_INCREASE", "EPS_DECLINE", "STRONG_EPS_INCREASE", "STRONG_EPS_DECLINE", "CAPEX_INCREASE", "CAPEX_DECLINE", "STRONG_CAPEX_INCREASE", "STRONG_CAPEX_DECLINE" ] }, "metric": { "type": [ "string", "null" ], "description": "The metric this signal references, when applicable (e.g. `revenue`, `earnings_per_share`, `operating_margin`, or a guidance/KPI metric name)." }, "period": { "type": [ "string", "null" ], "description": "The fiscal period the signal references (e.g. `2026-Q1`, `FY 2026`). Forward guidance signals reference the guided period; financial signals reference the reporting period of this filing." }, "headline": { "type": "string", "description": "Pre-rendered, human-readable summary suitable for direct display." }, "details": { "type": "object", "description": "Structured fields specific to the signal type. Contents vary: guidance signals carry `low`, `high`, `point_estimate`, `prior_value`, `revision_pct`; segment signals carry `best`, `worst`, `spread_pp`; non-GAAP signals carry `gaap_field`, `non_gaap_value`, `gaap_value`, `divergence_pct`; growth signals carry `current`, `yoy_chg`. Null values are omitted. Refer to type-specific examples.", "additionalProperties": true } } }, "Response0081E61F2639_EarningsTimeDimension": { "type": "object", "properties": { "revenue": { "type": [ "number", "null" ] }, "revenue_chg": { "type": "number", "description": "Percentage change in revenue versus the prior period as a decimal (e.g. 0.10 = +10%). Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "revenue_yoy_chg": { "type": "number", "description": "Year-over-year change in revenue versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "earnings_per_share": { "type": [ "number", "null" ] }, "earnings_per_share_chg": { "type": "number", "description": "Percentage change in EPS versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "earnings_per_share_yoy_chg": { "type": "number", "description": "Year-over-year change in EPS versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "gross_profit": { "type": [ "number", "null" ] }, "gross_profit_chg": { "type": "number", "description": "Percentage change in gross profit versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "gross_profit_yoy_chg": { "type": "number", "description": "Year-over-year change in gross profit versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "gross_margin": { "type": "number", "description": "Gross margin as a decimal (gross_profit / revenue). Returned only when calculable." }, "gross_margin_chg_bps": { "type": "number", "description": "Absolute change in gross margin versus the prior period in basis points (e.g. 200.0 = margin expanded 200 bps). Returned only when calculable." }, "gross_margin_chg_pct": { "type": "number", "description": "Percentage change in gross margin versus the prior period as a decimal. Returned only when calculable." }, "gross_margin_yoy_chg_bps": { "type": "number", "description": "Year-over-year change in gross margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable." }, "gross_margin_yoy_chg_pct": { "type": "number", "description": "Year-over-year percentage change in gross margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "operating_income": { "type": [ "number", "null" ] }, "operating_income_chg": { "type": "number", "description": "Percentage change in operating income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "operating_income_yoy_chg": { "type": "number", "description": "Year-over-year change in operating income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "operating_margin": { "type": "number", "description": "Operating margin as a decimal (operating_income / revenue). Returned only when calculable." }, "operating_margin_chg_bps": { "type": "number", "description": "Absolute change in operating margin versus the prior period in basis points. Returned only when calculable." }, "operating_margin_chg_pct": { "type": "number", "description": "Percentage change in operating margin versus the prior period as a decimal. Returned only when calculable." }, "operating_margin_yoy_chg_bps": { "type": "number", "description": "Year-over-year change in operating margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable." }, "operating_margin_yoy_chg_pct": { "type": "number", "description": "Year-over-year percentage change in operating margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "net_income": { "type": [ "number", "null" ] }, "net_income_chg": { "type": "number", "description": "Percentage change in net income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "net_income_yoy_chg": { "type": "number", "description": "Year-over-year change in net income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "net_margin": { "type": "number", "description": "Net margin as a decimal (net_income / revenue). Returned only when calculable." }, "net_margin_chg_bps": { "type": "number", "description": "Absolute change in net margin versus the prior period in basis points. Returned only when calculable." }, "net_margin_chg_pct": { "type": "number", "description": "Percentage change in net margin versus the prior period as a decimal. Returned only when calculable." }, "net_margin_yoy_chg_bps": { "type": "number", "description": "Year-over-year change in net margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable." }, "net_margin_yoy_chg_pct": { "type": "number", "description": "Year-over-year percentage change in net margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "weighted_average_shares": { "type": [ "number", "null" ] }, "weighted_average_shares_diluted": { "type": [ "number", "null" ] }, "cash_and_equivalents": { "type": [ "number", "null" ] }, "change_in_cash_and_equivalents": { "type": [ "number", "null" ] }, "total_debt": { "type": [ "number", "null" ] }, "total_assets": { "type": [ "number", "null" ] }, "total_liabilities": { "type": [ "number", "null" ] }, "shareholders_equity": { "type": [ "number", "null" ] }, "net_cash_flow_from_operations": { "type": [ "number", "null" ] }, "net_cash_flow_from_operations_chg": { "type": "number", "description": "Percentage change in net cash flow from operations versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "net_cash_flow_from_operations_yoy_chg": { "type": "number", "description": "Year-over-year change in net cash flow from operations versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "net_cash_flow_from_investing": { "type": [ "number", "null" ] }, "net_cash_flow_from_investing_chg": { "type": "number", "description": "Percentage change in net cash flow from investing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "net_cash_flow_from_investing_yoy_chg": { "type": "number", "description": "Year-over-year change in net cash flow from investing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "net_cash_flow_from_financing": { "type": [ "number", "null" ] }, "net_cash_flow_from_financing_chg": { "type": "number", "description": "Percentage change in net cash flow from financing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "net_cash_flow_from_financing_yoy_chg": { "type": "number", "description": "Year-over-year change in net cash flow from financing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "capital_expenditure": { "type": [ "number", "null" ] }, "capital_expenditure_chg": { "type": "number", "description": "Percentage change in capital expenditure versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "capital_expenditure_yoy_chg": { "type": "number", "description": "Year-over-year change in capital expenditure versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "free_cash_flow": { "type": [ "number", "null" ] }, "free_cash_flow_chg": { "type": "number", "description": "Percentage change in free cash flow versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "free_cash_flow_yoy_chg": { "type": "number", "description": "Year-over-year change in free cash flow versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." } } }, "Response0081E61F2639_FilingsResponse": { "type": "object", "properties": { "filings": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_Filing" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_Filing": { "type": "object", "properties": { "cik": { "type": "integer", "description": "The Central Index Key (CIK) of the company." }, "accession_number": { "type": "string", "description": "The accession number of the filing." }, "filing_type": { "type": "string", "description": "The type of the SEC filing (e.g., 10-Q, 8-K)." }, "report_date": { "type": "string", "format": "date", "description": "The date of the report." }, "filing_date": { "type": "string", "format": "date", "description": "The date the filing was submitted to the SEC." }, "ticker": { "type": "string", "description": "The ticker symbol." }, "url": { "type": "string", "format": "uri", "description": "The URL of the SEC filing." } } }, "Response0081E61F2639_FilingItemsResponse": { "type": "object", "properties": { "resource": { "type": "string", "description": "The resource type identifier." }, "ticker": { "type": "string", "description": "The ticker symbol of the company." }, "cik": { "type": "string", "description": "The Central Index Key (CIK) of the company." }, "filing_type": { "type": "string", "description": "The type of filing." }, "accession_number": { "type": "string", "description": "The accession number of the filing." }, "year": { "type": "integer", "description": "The year of the filing." }, "quarter": { "type": "integer", "description": "The quarter of the filing." }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_FilingItem" } } } }, "Response0081E61F2639_FilingItem": { "type": "object", "properties": { "number": { "type": "string", "description": "The item number." }, "name": { "type": "string", "description": "The item name." }, "text": { "type": "string", "description": "The item text." }, "exhibits": { "type": "array", "description": "An array of exhibits linked to this item. Only present for 8-K filings when exhibits exist.", "items": { "$ref": "#/components/schemas/Response0081E61F2639_Exhibit" } } } }, "Response0081E61F2639_Exhibit": { "type": "object", "properties": { "number": { "type": "string", "description": "The exhibit number (e.g., '99.1')." }, "description": { "type": "string", "description": "The description of the exhibit." }, "url": { "type": "string", "format": "uri", "description": "The URL to the exhibit document on the SEC website." }, "text": { "type": "string", "description": "The raw text content of the exhibit. Only included when 'include_exhibits' parameter is set to true." } } }, "Response0081E61F2639_FilingItemsAccepted": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "processing" ], "description": "Always 'processing' on a 202 response." }, "request_id": { "type": "string", "format": "uuid", "description": "Identifier for this request; useful when contacting support." }, "result_url": { "type": "string", "description": "The URL to poll for the result." }, "estimated_ready_at": { "type": "string", "format": "date-time", "description": "When the filing is expected to be ready." }, "accession_number": { "type": "string", "description": "The accession number of the filing being prepared." }, "message": { "type": "string", "description": "Human-readable description of what to do next." } } }, "Response0081E61F2639_FinancialMetricsResponse": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol of the company." }, "report_period": { "type": "string", "format": "date", "description": "The reporting period of the financial metrics." }, "fiscal_period": { "type": "string", "description": "The fiscal period of the financial metrics." }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "The time period of the financial metrics." }, "currency": { "type": "string", "description": "The currency in which the financial data is reported." }, "accession_number": { "type": [ "string", "null" ], "description": "The SEC accession number of the filing." }, "form_type": { "type": [ "string", "null" ], "description": "The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing." }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "URL to the SEC filing." }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row." }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event)." }, "enterprise_value": { "type": "number", "description": "The total value of the company (market cap + debt - cash)." }, "price_to_earnings_ratio": { "type": "number", "description": "Price to earnings ratio." }, "price_to_book_ratio": { "type": "number", "description": "Price to book ratio." }, "price_to_sales_ratio": { "type": "number", "description": "Price to sales ratio." }, "enterprise_value_to_ebitda_ratio": { "type": "number", "description": "Enterprise value to EBITDA ratio." }, "enterprise_value_to_revenue_ratio": { "type": "number", "description": "Enterprise value to revenue ratio." }, "free_cash_flow_yield": { "type": "number", "description": "Free cash flow yield." }, "peg_ratio": { "type": "number", "description": "Price to earnings growth ratio." }, "gross_margin": { "type": "number", "description": "Gross profit as a percentage of revenue." }, "operating_margin": { "type": "number", "description": "Operating income as a percentage of revenue." }, "net_margin": { "type": "number", "description": "Net income as a percentage of revenue." }, "return_on_equity": { "type": "number", "description": "Net income as a percentage of shareholders' equity." }, "return_on_assets": { "type": "number", "description": "Net income as a percentage of total assets." }, "return_on_invested_capital": { "type": "number", "description": "Net operating profit after taxes as a percentage of invested capital." }, "asset_turnover": { "type": "number", "description": "Revenue divided by average total assets." }, "inventory_turnover": { "type": "number", "description": "Cost of goods sold divided by average inventory." }, "receivables_turnover": { "type": "number", "description": "Revenue divided by average accounts receivable." }, "days_sales_outstanding": { "type": "number", "description": "Average accounts receivable divided by revenue over the period." }, "operating_cycle": { "type": "number", "description": "Inventory turnover + receivables turnover." }, "working_capital_turnover": { "type": "number", "description": "Revenue divided by average working capital." }, "current_ratio": { "type": "number", "description": "Current assets divided by current liabilities." }, "quick_ratio": { "type": "number", "description": "Quick assets divided by current liabilities." }, "cash_ratio": { "type": "number", "description": "Cash and cash equivalents divided by current liabilities." }, "operating_cash_flow_ratio": { "type": "number", "description": "Operating cash flow divided by current liabilities." }, "debt_to_equity": { "type": "number", "description": "Total debt divided by shareholders' equity." }, "debt_to_assets": { "type": "number", "description": "Total debt divided by total assets." }, "interest_coverage": { "type": "number", "description": "EBIT divided by interest expense." }, "revenue_growth": { "type": "number", "description": "Year-over-year growth in revenue." }, "earnings_growth": { "type": "number", "description": "Year-over-year growth in earnings." }, "book_value_growth": { "type": "number", "description": "Year-over-year growth in book value." }, "earnings_per_share_growth": { "type": "number", "description": "Growth in earnings per share over the period." }, "free_cash_flow_growth": { "type": "number", "description": "Growth in free cash flow over the period." }, "operating_income_growth": { "type": "number", "description": "Growth in operating income over the period." }, "ebitda_growth": { "type": "number", "description": "Growth in EBITDA over the period." }, "payout_ratio": { "type": "number", "description": "Dividends paid as a percentage of net income." }, "earnings_per_share": { "type": "number", "description": "Net income divided by weighted average shares outstanding." }, "book_value_per_share": { "type": "number", "description": "Shareholders' equity divided by shares outstanding." }, "free_cash_flow_per_share": { "type": "number", "description": "Free cash flow divided by shares outstanding." }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_FinancialMetricSnapshotResponse": { "type": "object", "properties": { "snapshot": { "$ref": "#/components/schemas/Response0081E61F2639_FinancialMetricSnapshot" } } }, "Response0081E61F2639_FinancialMetricSnapshot": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol of the company." }, "currency": { "type": [ "string", "null" ], "description": "The currency in which the financial data is reported." }, "market_cap": { "type": [ "number", "null" ], "description": "The total market capitalization (stock price × shares outstanding)." }, "enterprise_value": { "type": [ "number", "null" ], "description": "The total value of the company (market cap + debt - cash)." }, "price_to_earnings_ratio": { "type": [ "number", "null" ], "description": "Price to earnings ratio." }, "price_to_book_ratio": { "type": [ "number", "null" ], "description": "Price to book ratio." }, "price_to_sales_ratio": { "type": [ "number", "null" ], "description": "Price to sales ratio." }, "enterprise_value_to_ebitda_ratio": { "type": [ "number", "null" ], "description": "Enterprise value to EBITDA ratio." }, "enterprise_value_to_revenue_ratio": { "type": [ "number", "null" ], "description": "Enterprise value to revenue ratio." }, "free_cash_flow_yield": { "type": [ "number", "null" ], "description": "Free cash flow yield." }, "peg_ratio": { "type": [ "number", "null" ], "description": "Price to earnings growth ratio." }, "gross_margin": { "type": [ "number", "null" ], "description": "Gross profit as a percentage of revenue." }, "operating_margin": { "type": [ "number", "null" ], "description": "Operating income as a percentage of revenue." }, "net_margin": { "type": [ "number", "null" ], "description": "Net income as a percentage of revenue." }, "return_on_equity": { "type": [ "number", "null" ], "description": "Net income as a percentage of shareholders' equity." }, "return_on_assets": { "type": [ "number", "null" ], "description": "Net income as a percentage of total assets." }, "return_on_invested_capital": { "type": [ "number", "null" ], "description": "Net operating profit after taxes as a percentage of invested capital." }, "asset_turnover": { "type": [ "number", "null" ], "description": "Revenue divided by average total assets." }, "inventory_turnover": { "type": [ "number", "null" ], "description": "Cost of goods sold divided by average inventory." }, "receivables_turnover": { "type": [ "number", "null" ], "description": "Revenue divided by average accounts receivable." }, "days_sales_outstanding": { "type": [ "number", "null" ], "description": "Average accounts receivable divided by revenue over the period." }, "operating_cycle": { "type": [ "number", "null" ], "description": "Inventory turnover + receivables turnover." }, "working_capital_turnover": { "type": [ "number", "null" ], "description": "Revenue divided by average working capital." }, "current_ratio": { "type": [ "number", "null" ], "description": "Current assets divided by current liabilities." }, "quick_ratio": { "type": [ "number", "null" ], "description": "Quick assets divided by current liabilities." }, "cash_ratio": { "type": [ "number", "null" ], "description": "Cash and cash equivalents divided by current liabilities." }, "operating_cash_flow_ratio": { "type": [ "number", "null" ], "description": "Operating cash flow divided by current liabilities." }, "debt_to_equity": { "type": [ "number", "null" ], "description": "Total debt divided by shareholders' equity." }, "debt_to_assets": { "type": [ "number", "null" ], "description": "Total debt divided by total assets." }, "interest_coverage": { "type": [ "number", "null" ], "description": "EBIT divided by interest expense." }, "revenue_growth": { "type": [ "number", "null" ], "description": "Year-over-year growth in revenue." }, "earnings_growth": { "type": [ "number", "null" ], "description": "Year-over-year growth in earnings." }, "book_value_growth": { "type": [ "number", "null" ], "description": "Year-over-year growth in book value." }, "earnings_per_share_growth": { "type": [ "number", "null" ], "description": "Growth in earnings per share over the period." }, "free_cash_flow_growth": { "type": [ "number", "null" ], "description": "Growth in free cash flow over the period." }, "operating_income_growth": { "type": [ "number", "null" ], "description": "Growth in operating income over the period." }, "ebitda_growth": { "type": [ "number", "null" ], "description": "Growth in EBITDA over the period." }, "payout_ratio": { "type": [ "number", "null" ], "description": "Dividends paid as a percentage of net income." }, "earnings_per_share": { "type": [ "number", "null" ], "description": "Net income divided by weighted average shares outstanding." }, "book_value_per_share": { "type": [ "number", "null" ], "description": "Shareholders' equity divided by shares outstanding." }, "free_cash_flow_per_share": { "type": [ "number", "null" ], "description": "Free cash flow divided by shares outstanding." } } }, "Response0081E61F2639_FinancialsResponse": { "type": "object", "properties": { "financials": { "type": "object", "properties": { "income_statements": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_IncomeStatement" } }, "balance_sheets": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_BalanceSheet" } }, "cash_flow_statements": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_CashFlowStatement" } } } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_IncomeStatement": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol." }, "report_period": { "type": "string", "format": "date", "description": "The reporting period of the income statement." }, "fiscal_period": { "type": "string", "description": "The fiscal period of the income statement." }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "The time period of the income statement." }, "currency": { "type": "string", "description": "The currency in which the financial data is reported." }, "accession_number": { "type": [ "string", "null" ], "description": "The SEC accession number of the filing." }, "form_type": { "type": [ "string", "null" ], "description": "The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing." }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "URL to the SEC filing." }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row." }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event)." }, "revenue": { "type": "number", "description": "The total revenue of the company." }, "cost_of_revenue": { "type": "number", "description": "The cost of revenue of the company." }, "gross_profit": { "type": "number", "description": "The gross profit of the company." }, "operating_expense": { "type": "number", "description": "The operating expenses of the company." }, "selling_general_and_administrative_expenses": { "type": "number", "description": "The selling, general, and administrative expenses of the company." }, "research_and_development": { "type": "number", "description": "The research and development expenses of the company." }, "operating_income": { "type": "number", "description": "The operating income of the company." }, "interest_expense": { "type": "number", "description": "The interest expenses of the company." }, "ebit": { "type": "number", "description": "The earnings before interest and taxes of the company." }, "income_tax_expense": { "type": "number", "description": "The income tax expenses of the company." }, "net_income_discontinued_operations": { "type": "number", "description": "The net income from discontinued operations of the company." }, "net_income_non_controlling_interests": { "type": "number", "description": "The net income from non-controlling interests of the company." }, "net_income": { "type": "number", "description": "The net income of the company." }, "net_income_common_stock": { "type": "number", "description": "The net income available to common stockholders of the company." }, "preferred_dividends_impact": { "type": "number", "description": "The impact of preferred dividends on the net income of the company." }, "consolidated_income": { "type": "number", "description": "The consolidated income of the company." }, "earnings_per_share": { "type": "number", "description": "The earnings per share of the company." }, "earnings_per_share_diluted": { "type": "number", "description": "The diluted earnings per share of the company." }, "dividends_per_common_share": { "type": "number", "description": "The dividends per common share of the company." }, "weighted_average_shares": { "type": "number", "description": "The weighted average shares of the company." }, "weighted_average_shares_diluted": { "type": "number", "description": "The diluted weighted average shares of the company." } } }, "Response0081E61F2639_BalanceSheet": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol." }, "report_period": { "type": "string", "format": "date", "description": "The reporting period of the balance sheet." }, "fiscal_period": { "type": "string", "description": "The fiscal period of the balance sheet." }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "The time period of the balance sheet." }, "currency": { "type": "string", "description": "The currency in which the financial data is reported." }, "accession_number": { "type": [ "string", "null" ], "description": "The SEC accession number of the filing." }, "form_type": { "type": [ "string", "null" ], "description": "The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing." }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "URL to the SEC filing." }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row." }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event)." }, "total_assets": { "type": "number", "description": "The total assets of the company." }, "current_assets": { "type": "number", "description": "The current assets of the company." }, "cash_and_equivalents": { "type": "number", "description": "The cash and equivalents of the company." }, "inventory": { "type": "number", "description": "The inventory of the company." }, "current_investments": { "type": "number", "description": "The current investments of the company." }, "trade_and_non_trade_receivables": { "type": "number", "description": "The trade and non-trade receivables of the company." }, "non_current_assets": { "type": "number", "description": "The non-current assets of the company." }, "property_plant_and_equipment": { "type": "number", "description": "The property, plant, and equipment of the company." }, "goodwill_and_intangible_assets": { "type": "number", "description": "The goodwill and intangible assets of the company." }, "investments": { "type": "number", "description": "The investments of the company." }, "non_current_investments": { "type": "number", "description": "The non-current investments of the company." }, "outstanding_shares": { "type": "number", "description": "The outstanding shares of the company." }, "tax_assets": { "type": "number", "description": "The tax assets of the company." }, "total_liabilities": { "type": "number", "description": "The total liabilities of the company." }, "current_liabilities": { "type": "number", "description": "The current liabilities of the company." }, "current_debt": { "type": "number", "description": "The current debt of the company." }, "trade_and_non_trade_payables": { "type": "number", "description": "The trade and non-trade payables of the company." }, "deferred_revenue": { "type": "number", "description": "The deferred revenue of the company." }, "deposit_liabilities": { "type": "number", "description": "The deposit liabilities of the company." }, "non_current_liabilities": { "type": "number", "description": "The non-current liabilities of the company." }, "non_current_debt": { "type": "number", "description": "The non-current debt of the company." }, "tax_liabilities": { "type": "number", "description": "The tax liabilities of the company." }, "shareholders_equity": { "type": "number", "description": "The shareholders' equity of the company." }, "retained_earnings": { "type": "number", "description": "The retained earnings of the company." }, "accumulated_other_comprehensive_income": { "type": "number", "description": "The accumulated other comprehensive income of the company." }, "total_debt": { "type": "number", "description": "The total debt of the company." } } }, "Response0081E61F2639_CashFlowStatement": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol." }, "report_period": { "type": "string", "format": "date", "description": "The reporting period of the cash flow statement." }, "fiscal_period": { "type": "string", "description": "The fiscal period of the cash flow statement." }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "The time period of the cash flow statement." }, "currency": { "type": "string", "description": "The currency in which the financial data is reported." }, "accession_number": { "type": [ "string", "null" ], "description": "The SEC accession number of the filing." }, "form_type": { "type": [ "string", "null" ], "description": "The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing." }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "URL to the SEC filing." }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row." }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event)." }, "net_income": { "type": "number", "description": "The net income of the company." }, "depreciation_and_amortization": { "type": "number", "description": "The depreciation and amortization of the company." }, "share_based_compensation": { "type": "number", "description": "The share-based compensation of the company." }, "net_cash_flow_from_operations": { "type": "number", "description": "The net cash flow from operations of the company." }, "capital_expenditure": { "type": "number", "description": "The capital expenditure of the company." }, "business_acquisitions_and_disposals": { "type": "number", "description": "The business acquisitions and disposals of the company." }, "investment_acquisitions_and_disposals": { "type": "number", "description": "The investment acquisitions and disposals of the company." }, "net_cash_flow_from_investing": { "type": "number", "description": "The net cash flow from investing of the company." }, "issuance_or_repayment_of_debt_securities": { "type": "number", "description": "The issuance or repayment of debt securities of the company." }, "issuance_or_purchase_of_equity_shares": { "type": "number", "description": "The issuance or purchase of equity shares of the company." }, "dividends_and_other_cash_distributions": { "type": "number", "description": "The dividends and other cash distributions of the company." }, "net_cash_flow_from_financing": { "type": "number", "description": "The net cash flow from financing of the company." }, "change_in_cash_and_equivalents": { "type": "number", "description": "The change in cash and equivalents of the company." }, "effect_of_exchange_rate_changes": { "type": "number", "description": "The effect of exchange rate changes of the company." }, "ending_cash_balance": { "type": "number", "description": "The ending cash balance of the company." }, "free_cash_flow": { "type": "number", "description": "The free cash flow of the company." } } }, "Response0081E61F2639_BalanceSheetResponse": { "type": "object", "properties": { "balance_sheets": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_BalanceSheet" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_CashFlowStatementResponse": { "type": "object", "properties": { "cash_flow_statements": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_CashFlowStatement" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_IncomeStatementResponse": { "type": "object", "properties": { "income_statements": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_IncomeStatement" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Provider0081E61F2639_SearchLineItemsRequest": { "type": "object", "required": [ "line_items", "tickers" ], "properties": { "line_items": { "type": "array", "items": { "type": "string", "description": "The financial metric to search for." }, "minItems": 1, "description": "An array of line items to apply to the search." }, "tickers": { "type": "array", "items": { "type": "string", "description": "The tickers to search for." }, "minItems": 1, "description": "An array of tickers to apply to the search." }, "period": { "type": "string", "enum": [ "annual", "quarterly", "ttm" ], "default": "ttm", "description": "The time period for the financial data." }, "limit": { "type": "integer", "minimum": 1, "default": 1, "description": "The maximum number of results to return." } } }, "Response0081E61F2639_FinancialsSearchResponse": { "type": "object", "properties": { "search_results": { "type": "array", "items": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol of the company." }, "report_period": { "type": "string", "format": "date", "description": "The reporting period of the financial data." }, "period": { "type": "string", "enum": [ "annual", "quarterly", "ttm" ], "description": "The time period of the financial data." }, "currency": { "type": "string", "description": "The currency of the financial data." } }, "additionalProperties": { "type": "string", "description": "Additional financial metrics based on the search criteria." } } } } }, "Provider0081E61F2639_SearchFiltersRequest": { "type": "object", "required": [ "filters" ], "properties": { "limit": { "type": "integer", "minimum": 1, "default": 10, "description": "The maximum number of results to return." }, "filters": { "type": "array", "items": { "type": "object", "required": [ "field", "operator", "value" ], "properties": { "field": { "type": "string", "description": "The criteria to filter on. For financial metric fields, use 'gt', 'lt', 'gte', 'lte', 'eq' operators. For 'ticker' and 'cik' fields, use the 'in' operator to filter against multiple values." }, "operator": { "type": "string", "enum": [ "gt", "lt", "gte", "lte", "eq", "in" ], "description": "The comparison operator. The 'in' operator can only be used with a field value of 'ticker' or 'cik' and lets you filter against multiple values." }, "value": { "oneOf": [ { "type": "number", "description": "The value to compare against for single-value operators (gt, lt, gte, lte, eq)" }, { "type": "array", "items": { "type": "string" }, "description": "Array of ticker or cik values to compare against when using the 'in' operator" } ] } } }, "minItems": 1, "description": "An array of filter objects to apply to the search." } } }, "Response0081E61F2639_InsiderTradesResponse": { "type": "object", "properties": { "insider_trades": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_InsiderTrade" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_InsiderTrade": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol of the company." }, "issuer": { "type": "string", "description": "The name of the issuing company." }, "name": { "type": "string", "description": "The name of the insider." }, "title": { "type": "string", "description": "The title of the insider." }, "is_board_director": { "type": "boolean", "description": "Whether the insider is a board director." }, "form_type": { "type": "string", "description": "The SEC form type: 4 (trade report) or 5 (annual statement), or their amendments 4/A, 5/A." }, "filing_date": { "type": "string", "format": "date", "description": "The date the filing was accepted by the SEC." }, "report_period": { "type": "string", "format": "date", "description": "The reporting period declared on the filing. For Form 4 this is the date of the earliest transaction reported, and it may be earlier than the filing_date." }, "transaction_date": { "type": "string", "format": "date", "description": "The date of the transaction." }, "transaction_code": { "type": "string", "description": "The SEC Form 4 transaction code (for example, `P` for open market purchase, `S` for open market sale, `M` for exercise of derivative securities, `F` for shares withheld to cover taxes, `G` for gift). Distinguishes the individual legs of a multi-part filing." }, "transaction_type": { "type": "string", "description": "A human-readable description of the transaction, derived from the transaction_code." }, "transaction_shares": { "type": "number", "description": "The number of shares involved in the transaction." }, "transaction_price_per_share": { "type": "number", "description": "The price per share in the transaction." }, "transaction_value": { "type": "number", "description": "The total value of the transaction." }, "shares_owned_before_transaction": { "type": "number", "description": "The number of shares owned before the transaction." }, "shares_owned_after_transaction": { "type": "number", "description": "The number of shares owned after the transaction." }, "security_title": { "type": "string", "description": "The title of the security involved in the transaction." } } }, "Response0081E61F2639_KPIGuidanceResponse": { "type": "object", "properties": { "kpi_guidance": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_KPIGuidanceItem" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_KPIGuidanceItem": { "type": "object", "required": [ "ticker", "metric_name", "period", "period_type" ], "properties": { "ticker": { "type": "string", "example": "DAL" }, "metric_name": { "type": "string", "example": "Operating Margin" }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "example": "%" }, "period": { "type": "string", "example": "Q2 2026" }, "period_type": { "type": "string", "enum": [ "quarterly", "annual" ] }, "segment": { "type": [ "string", "null" ] }, "low": { "type": [ "number", "null" ], "description": "Low end of guidance range.", "example": 6.0 }, "high": { "type": [ "number", "null" ], "description": "High end of guidance range.", "example": 8.0 }, "point_estimate": { "type": [ "number", "null" ], "description": "Single-point guidance when no range is given." }, "prior_value": { "type": [ "number", "null" ], "description": "Prior guidance value for revisions." }, "raw_text": { "type": [ "string", "null" ], "description": "Original guidance text from the filing." }, "change_direction": { "type": [ "string", "null" ], "description": "Direction: raised, lowered, maintained, initiated, withdrawn.", "example": "initiated" }, "source_text": { "type": [ "string", "null" ] }, "source_url": { "type": [ "string", "null" ], "format": "uri" } } }, "Response0081E61F2639_KPIMetricsResponse": { "type": "object", "properties": { "kpi_metrics": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_KPIMetric" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_KPIMetric": { "type": "object", "required": [ "ticker", "metric_name", "value", "unit", "period", "period_type" ], "properties": { "ticker": { "type": "string", "description": "Stock ticker symbol.", "example": "DAL" }, "metric_name": { "type": "string", "description": "Canonical metric name.", "example": "load_factor" }, "value": { "type": [ "number", "null" ], "description": "Extracted numeric value.", "example": 82.0 }, "unit": { "type": "string", "description": "Unit of measure (e.g., %, cents, dollars, miles, count).", "example": "%" }, "period": { "type": "string", "description": "Reporting period (e.g., Q4 2025, FY 2025, or a date like 2025-04-30 for non-standard fiscal years).", "example": "Q4 2025" }, "period_type": { "type": "string", "enum": [ "quarterly", "annual" ], "description": "Whether this is a quarterly or annual figure.", "example": "quarterly" }, "segment": { "type": [ "string", "null" ], "description": "Business segment, geography, or sub-category. Only present when the metric is reported for a sub-unit rather than the consolidated entity.", "example": "Commercial Engines & Services" }, "yoy_value": { "type": [ "number", "null" ], "description": "Year-over-year comparison value from the prior period.", "example": 84.0 }, "yoy_change_pct": { "type": [ "number", "null" ], "description": "Year-over-year percentage change.", "example": -2.381 }, "source_text": { "type": [ "string", "null" ], "description": "The source text span from the filing where this value was found.", "example": "Passenger load factor" }, "source_url": { "type": "string", "format": "uri", "description": "Direct link to the SEC filing. When available, includes a text fragment that highlights the source in the browser.", "example": "https://www.sec.gov/Archives/edgar/data/27904/000002790426000008/deltaairlinesannouncesdece.htm" } } }, "Response0081E61F2639_KPINonGAAPResponse": { "type": "object", "properties": { "kpi_non_gaap": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_KPINonGAAPMetric" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_KPINonGAAPMetric": { "type": "object", "required": [ "ticker", "metric_name", "value", "unit", "period", "period_type" ], "properties": { "ticker": { "type": "string", "example": "DAL" }, "metric_name": { "type": "string", "example": "Adjusted Diluted EPS" }, "value": { "type": [ "number", "null" ], "example": 0.64 }, "unit": { "type": "string", "example": "USD per share" }, "period": { "type": "string", "example": "Q1 2026" }, "period_type": { "type": "string", "enum": [ "quarterly", "annual" ] }, "gaap_equivalent": { "type": [ "string", "null" ], "description": "The GAAP line item this metric adjusts.", "example": "Diluted earnings per share" }, "key_adjustments": { "type": [ "string", "null" ], "description": "Description of adjustments made.", "example": "Excludes restructuring charges of $150M" }, "source_text": { "type": [ "string", "null" ] }, "source_url": { "type": [ "string", "null" ], "format": "uri" } } }, "Response0081E61F2639_InterestRatesResponse": { "type": "object", "properties": { "interest_rates": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_InterestRate" } }, "next_page_url": { "type": "string", "description": "History only. Absolute URL of the next page of results. Present only when more rows remain; request it as-is to continue. Each page holds up to 10 rows." } } }, "Response0081E61F2639_InterestRate": { "type": "object", "properties": { "bank": { "type": "string", "description": "The symbol of the central bank." }, "name": { "type": "string", "description": "The name of the central bank." }, "rate": { "type": "number", "description": "The policy rate in percent on that day. For the Federal Reserve, the midpoint of the target range." }, "date": { "type": "string", "description": "The calendar day the rate is in effect, in YYYY-MM-DD format." } } }, "Response0081E61F2639_NewsResponse": { "type": "object", "properties": { "news": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_News" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } }, "Response0081E61F2639_News": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol." }, "title": { "type": "string", "description": "The title of the news article." }, "source": { "type": "string", "description": "The source of the news article." }, "date": { "type": "string", "format": "date", "description": "The date the news article was published." }, "url": { "type": "string", "format": "uri", "description": "The URL of the news article." } } }, "Response0081E61F2639_PricesResponse": { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol." }, "prices": { "type": "array", "items": { "$ref": "#/components/schemas/Response0081E61F2639_Price" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 100 records." } } }, "Response0081E61F2639_Price": { "type": "object", "properties": { "open": { "type": "number", "description": "The open price of the ticker in the given time period." }, "close": { "type": "number", "description": "The close price of the ticker in the given time period." }, "high": { "type": "number", "description": "The high price of the ticker in the given time period." }, "low": { "type": "number", "description": "The low price of the ticker in the given time period." }, "volume": { "type": [ "integer", "null" ], "description": "The trading volume of the ticker in the given time period." }, "time": { "type": "string", "description": "The human-readable time format of the price in UTC." } } }, "Response0081E61F2639_PriceSnapshotResponse": { "type": "object", "properties": { "snapshot": { "$ref": "#/components/schemas/Response0081E61F2639_PriceSnapshot" } } }, "Response0081E61F2639_PriceSnapshot": { "type": "object", "properties": { "price": { "type": "number", "description": "The current price of the stock." }, "ticker": { "type": "string", "description": "The ticker symbol." }, "day_change": { "type": "number", "description": "The price change since the previous trading day's close." }, "day_change_percent": { "type": "number", "description": "The percentage price change since the previous trading day's close." }, "time": { "type": "string", "description": "The timestamp of the price snapshot in human-readable format in UTC." }, "time_milliseconds": { "type": "number", "description": "The timestamp of the price snapshot in milliseconds since epoch." } } } }, "responses": {}, "parameters": {}, "examples": {}, "requestBodies": {}, "headers": {}, "links": {}, "callbacks": {}, "pathItems": {} }, "info": { "description": "", "title": "FinancialAPI", "version": "1", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-configured-paths": [ "/apis/v1/financial/analyst-estimates", "/apis/v1/financial/company/facts", "/apis/v1/financial/company/facts/ticker", "/apis/v1/financial/crypto/prices", "/apis/v1/financial/crypto/prices/snapshot", "/apis/v1/financial/earnings", "/apis/v1/financial/earnings/press-releases", "/apis/v1/financial/filings", "/apis/v1/financial/filings/items", "/apis/v1/financial/financial-metrics", "/apis/v1/financial/financial-metrics/snapshot", "/apis/v1/financial/financials", "/apis/v1/financial/financials/balance-sheets", "/apis/v1/financial/financials/cash-flow-statements", "/apis/v1/financial/financials/income-statements", "/apis/v1/financial/financials/search/line-items", "/apis/v1/financial/financials/search/screener", "/apis/v1/financial/financials/segmented-revenues", "/apis/v1/financial/insider-trades", "/apis/v1/financial/institutional-ownership", "/apis/v1/financial/kpi/guidance", "/apis/v1/financial/kpi/metrics", "/apis/v1/financial/kpi/non-gaap", "/apis/v1/financial/macro/interest-rates", "/apis/v1/financial/macro/interest-rates/snapshot", "/apis/v1/financial/news", "/apis/v1/financial/prices", "/apis/v1/financial/prices/snapshot" ], "x-aisa-document": { "facts_hash": "afe2e5d365275c032408a51b04030fb8f5be4f9d70a476d8735d89f06821a9b8", "generator_version": "3", "protocol_version": "1", "schema_version": "1", "composer_version": "20", "response_pending": [ { "operation_id": "get_financial_analyst_estimates", "path": "/apis/v1/financial/analyst-estimates", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" } ], "document_hash": "sha256:61ad10f29d878952017d5fb9761fb6652a8e8d984742cb2895c9849a4b29ae4b" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "financial", "x-aisa-catalogs": { "financial": { "title": "FinancialAPI", "description": "", "x-aisa-document": { "facts_hash": "afe2e5d365275c032408a51b04030fb8f5be4f9d70a476d8735d89f06821a9b8", "generator_version": "3", "protocol_version": "1", "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } } } } }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ], "paths": { "/apis/v1/financial/analyst-estimates": { "get": { "description": "\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_analyst_estimates", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "period", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Analyst Estimates", "tags": [ "Four" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "3", "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "2130d8a1355bad9603faf02608497d9c58e0a37541d990ffd7417a016b0b8cd4", "x-aisa-response-upstream-path-sha256": "bb8295b4db28c5f3220212b7062058c6cfe013292bb834f9b555f41cc65db794", "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "de77f6c2042d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_analyst_estimates", "method": "GET", "path": "/apis/v1/financial/analyst-estimates" }, "x-aisa-response-pending": { "operation_id": "get_financial_analyst_estimates", "path": "/apis/v1/financial/analyst-estimates", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_analyst-estimates" } }, "/apis/v1/financial/company/facts": { "get": { "description": "Get company facts for a ticker.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_company_facts", "parameters": [ { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Company facts response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_CompanyFactsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Company Facts", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "83953e6bae82" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/company/facts", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_company_facts", "method": "ANY", "path": "/apis/v1/financial/company/facts" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:b6364bf8dda2e8abd0bb96042f52d405a83011b611b1e95308f3798a08e645b2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_company-facts" } }, "/apis/v1/financial/company/facts/ticker": { "get": { "description": "Get company facts for a ticker.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "any_financial_apis_v1_financial_company_facts_ticker", "responses": { "200": { "description": "Company facts response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_CompanyFactsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Company Facts", "tags": [ "Zero" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2d23ecea1dab" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/company/facts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "any_financial_apis_v1_financial_company_facts_ticker", "method": "ANY", "path": "/apis/v1/financial/company/facts/ticker" }, "parameters": [ { "name": "cik", "in": "query", "description": "The CIK of the company.", "required": false, "schema": { "type": "string" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol.", "required": false, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:b6364bf8dda2e8abd0bb96042f52d405a83011b611b1e95308f3798a08e645b2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/any_financial_apis_v1_financial_company_facts_ticker" } }, "/apis/v1/financial/earnings": { "get": { "description": "Get the most recent earnings snapshot for a ticker. Optional change fields are returned only when available.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_earnings", "responses": { "200": { "description": "Earnings response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_EarningsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Earnings Data", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b2ebbfadde59" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/earnings", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_earnings", "method": "ANY", "path": "/apis/v1/financial/earnings" }, "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Number of most-recent **report periods** worth of filings to return, sorted by `(report_period DESC, filing_date ASC)`. The number of entries returned may exceed `limit` when a recent period has both an 8-K and a 10-Q / 10-K. Values above 40 are clamped to 40. Non-positive or non-integer values return 400. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 40, "default": 1 } }, { "name": "ticker", "in": "query", "description": "The ticker symbol (e.g. `AAPL`).", "required": true, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:113e10a1bb138c9519bcc7a82c9dd2f98342d40e192faed818d5f663ef53b734" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_earnings" } }, "/apis/v1/financial/filings": { "get": { "description": "Get SEC filings for a company.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_filings", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "SEC filings response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FilingsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Company SEC Filings", "tags": [ "Two" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bb4556e65994" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/filings", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_filings", "method": "ANY", "path": "/apis/v1/financial/filings" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:e130025cbe473f8d89d450c4adf6235fabcf11a4778b684714434f55c9960914" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_filings" } }, "/apis/v1/financial/filings/items": { "get": { "description": "Get the raw text Items from an SEC filing.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_filings_items", "responses": { "200": { "description": "SEC filing items response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FilingItemsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FilingItemsAccepted" } } }, "description": "The filing is still being prepared. Poll the result_url from the response body to retrieve the result. You are not billed for this response." } }, "summary": "Get SEC Filing Items", "tags": [ "Two" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1d74cb064768" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/filings/items", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_filings_items", "method": "ANY", "path": "/apis/v1/financial/filings/items" }, "parameters": [ { "name": "accession_number", "in": "query", "description": "The accession number of the filing if 8-K.", "required": false, "schema": { "type": "string" } }, { "name": "filing_type", "in": "query", "description": "The type of filing.", "required": true, "schema": { "type": "string", "enum": [ "10-K", "10-Q", "8-K" ] } }, { "name": "include_exhibits", "in": "query", "description": "Whether to include the raw text from linked exhibits. Only applicable for 8-K filings. When true, exhibit objects will include the 'text' field containing the full exhibit content.", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "item", "in": "query", "description": "The item to get.", "required": false, "schema": { "type": "string", "enum": [ "Item-1", "Item-1A", "Item-1B", "Item-2", "Item-3", "Item-4", "Item-5", "Item-6", "Item-7", "Item-7A", "Item-8", "Item-9", "Item-9A", "Item-9B", "Item-10", "Item-11", "Item-12", "Item-13", "Item-14", "Item-15", "Item-16", "Item-1.01", "Item-1.02", "Item-1.03", "Item-1.04", "Item-2.01", "Item-2.02", "Item-2.03", "Item-2.04", "Item-2.05", "Item-2.06", "Item-3.01", "Item-3.02", "Item-3.03", "Item-4.01", "Item-4.02", "Item-5.01", "Item-5.02", "Item-5.03", "Item-5.04", "Item-5.05", "Item-5.06", "Item-5.07", "Item-5.08", "Item-6.01", "Item-6.02", "Item-6.03", "Item-6.04", "Item-6.05", "Item-7.01", "Item-8.01", "Item-9.01" ] } }, { "name": "quarter", "in": "query", "description": "The quarter of the filing if 10-Q.", "required": false, "schema": { "type": "integer" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol.", "required": true, "schema": { "type": "string" } }, { "name": "year", "in": "query", "description": "The year of the filing.", "required": true, "schema": { "type": "integer" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:af9e98a2f69526d0b2d9e26f2cec926b0d60493a7e9e649105d2b187bc47d0e2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_filings-items" } }, "/apis/v1/financial/financial-metrics": { "get": { "description": "Get financial metrics for a ticker, including valuation, profitability, efficiency, liquidity, leverage, growth, and per share metrics.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_financial_metrics", "responses": { "200": { "description": "The historical financial metrics and ratios for a ticker", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FinancialMetricsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Financial Metrics", "tags": [ "Two" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "91e184ccdc44" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financial-metrics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_financial_metrics", "method": "ANY", "path": "/apis/v1/financial/financial-metrics" }, "parameters": [ { "name": "cik", "in": "query", "description": "The Central Index Key (CIK) of the company. Can be used instead of ticker.", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "filing_date", "in": "query", "description": "Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_gt", "in": "query", "description": "Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_gte", "in": "query", "description": "Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_lt", "in": "query", "description": "Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_lte", "in": "query", "description": "Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "description": "The maximum number of results to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.", "required": false, "schema": { "type": "integer" } }, { "name": "period", "in": "query", "description": "The time period for the financial data.", "required": true, "schema": { "type": "string", "enum": [ "annual", "quarterly", "ttm" ] } }, { "name": "report_period", "in": "query", "description": "Filter by exact report period date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_gt", "in": "query", "description": "Filter by report period greater than date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_gte", "in": "query", "description": "Filter by report period greater than or equal to date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lt", "in": "query", "description": "Filter by report period less than date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lte", "in": "query", "description": "Filter by report period less than or equal to date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol of the company. Required if cik is not provided.", "required": false, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:d6b7972d47f8ee94ce92702aa8d4994b73133b9e30d01177625ebaee930e5462" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_financial-metrics" } }, "/apis/v1/financial/financial-metrics/snapshot": { "get": { "description": "Get the real-time financial metrics snapshot for a stock, including valuation ratios, profitability, efficiency, liquidity, leverage, growth, and per share metrics.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_financial_metrics_snapshot", "parameters": [ { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Financial metrics snapshot response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FinancialMetricSnapshotResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Financial Metrics Snapshot", "tags": [ "Two" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "facbda9bd017" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financial-metrics/snapshot", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_financial_metrics_snapshot", "method": "ANY", "path": "/apis/v1/financial/financial-metrics/snapshot" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:b76d3a5c0e25f3d0d79cfcf1179ddd63a26ee849b0ac7dc62eb32265aec0b348" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_financial-metrics-snapshot" } }, "/apis/v1/financial/financials": { "get": { "description": "Get all financial statements for a ticker.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_financials", "responses": { "200": { "description": "Financial statements response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FinancialsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Financial Statements", "tags": [ "Ten" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "782901bb6a7a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financials", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_financials", "method": "ANY", "path": "/apis/v1/financial/financials" }, "parameters": [ { "name": "cik", "in": "query", "description": "The Central Index Key (CIK) of the company.", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "exchange", "in": "query", "description": "The exchange the ticker is listed on. Omit for US listings. Use `LSE` for the London Stock Exchange; any ticker of the company, including a second share class, returns the company's statements.", "required": false, "schema": { "type": "string", "enum": [ "LSE" ] } }, { "name": "filing_date", "in": "query", "description": "Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_gt", "in": "query", "description": "Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_gte", "in": "query", "description": "Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_lt", "in": "query", "description": "Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_lte", "in": "query", "description": "Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "isin", "in": "query", "description": "The ISIN (International Securities Identification Number) of a non-US listing. An alternative to `ticker` and `exchange`.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The maximum number of financial statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.", "schema": { "type": "integer", "format": "int32" } }, { "name": "period", "in": "query", "description": "The time period of the financial statements.", "required": true, "schema": { "type": "string", "enum": [ "annual", "quarterly", "ttm" ] } }, { "name": "report_period", "in": "query", "description": "Filter by exact report period date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_gt", "in": "query", "description": "Filter by report period greater than date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_gte", "in": "query", "description": "Filter by report period greater than or equal to date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lt", "in": "query", "description": "Filter by report period less than date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lte", "in": "query", "description": "Filter by report period less than or equal to date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol. Required if cik or isin is not provided.", "required": false, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:20142b1c9223d5c9891365ccd2d0d997e7be6971db1b1f0a1e172e7cadf8595b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_financials" } }, "/apis/v1/financial/financials/balance-sheets": { "get": { "description": "Get balance sheets for a ticker.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_financials_balance_sheets", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "period", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Balance sheets response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_BalanceSheetResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Balance Sheets", "tags": [ "Four" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0990921994e9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financials/balance-sheets", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_financials_balance_sheets", "method": "ANY", "path": "/apis/v1/financial/financials/balance-sheets" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:77545a0e22626b9c14cf1e04c82b76c8a923f3249002b8298e45d77ec70b4897" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_financials-balance-sheets" } }, "/apis/v1/financial/financials/cash-flow-statements": { "get": { "description": "Get cash flow statements for a ticker.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_financials_cash_flow_statements", "responses": { "200": { "description": "Cash flow statements response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_CashFlowStatementResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Cash Flow Statements", "tags": [ "Four" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5f6c3aba898c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financials/cash-flow-statements", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_financials_cash_flow_statements", "method": "ANY", "path": "/apis/v1/financial/financials/cash-flow-statements" }, "parameters": [ { "name": "cik", "in": "query", "description": "The Central Index Key (CIK) of the company.", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "exchange", "in": "query", "description": "The exchange the ticker is listed on. Omit for US listings. Use `LSE` for the London Stock Exchange; any ticker of the company, including a second share class, returns the company's statements.", "required": false, "schema": { "type": "string", "enum": [ "LSE" ] } }, { "name": "filing_date", "in": "query", "description": "Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_gt", "in": "query", "description": "Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_gte", "in": "query", "description": "Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_lt", "in": "query", "description": "Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "filing_date_lte", "in": "query", "description": "Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "isin", "in": "query", "description": "The ISIN (International Securities Identification Number) of a non-US listing. An alternative to `ticker` and `exchange`.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The maximum number of cash flow statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.", "schema": { "type": "integer", "format": "int32" } }, { "name": "period", "in": "query", "description": "The time period of the cash flow statements.", "required": true, "schema": { "type": "string", "enum": [ "annual", "quarterly", "ttm" ] } }, { "name": "report_period", "in": "query", "description": "Filter by exact report period date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_gt", "in": "query", "description": "Filter by report period greater than date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_gte", "in": "query", "description": "Filter by report period greater than or equal to date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lt", "in": "query", "description": "Filter by report period less than date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lte", "in": "query", "description": "Filter by report period less than or equal to date in YYYY-MM-DD format.", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol. Required if cik or isin is not provided.", "required": false, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:d160f563fcf378a9fd9d1467f63107b450bc9682eb9717bddbc728317b79c2cb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_financials-cash-flow-statements" } }, "/apis/v1/financial/financials/income-statements": { "get": { "description": "Get income statements for a ticker.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_financials_income_statements", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "period", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Income statements response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_IncomeStatementResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Income Statements", "tags": [ "Four" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1c05ac71d1b8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financials/income-statements", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_financials_income_statements", "method": "ANY", "path": "/apis/v1/financial/financials/income-statements" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:6f4c2efbc294dc6388a2f8583d2b7fc5cc1f811e12b3392f98b78871bdfc6c2e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_financials-income-statements" } }, "/apis/v1/financial/financials/search/line-items": { "post": { "description": "Search for specific financial metrics across income statements, balance sheets, and cash flow statements for a list of tickers.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_financial_financials_search_line_items", "responses": { "200": { "description": "Successful search response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FinancialsSearchResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Financial Line Items", "tags": [ "One" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "POST" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d01c3c0f048b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financials/search/line-items", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "post_financial_financials_search_line_items", "method": "ANY", "path": "/apis/v1/financial/financials/search/line-items" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "line_items", "tickers" ], "properties": { "line_items": { "type": "array", "items": { "type": "string", "description": "The financial metric to search for." }, "minItems": 1, "description": "An array of line items to apply to the search." }, "tickers": { "type": "array", "items": { "type": "string", "description": "The tickers to search for." }, "minItems": 1, "description": "An array of tickers to apply to the search." }, "period": { "type": "string", "enum": [ "annual", "quarterly", "ttm" ], "default": "ttm", "description": "The time period for the financial data." }, "limit": { "type": "integer", "minimum": 1, "default": 1, "description": "The maximum number of results to return." } } } } } }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:899f2dd281ebae3637b70f4164ccd4dc1ee97f2d3ea7c2a6b7f991d9a18d6b2a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/post_financials-search-line-items" } }, "/apis/v1/financial/financials/search/screener": { "post": { "description": "Search for stocks by filtering across financial metrics from income statements, balance sheets, and cash flow statements.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_financial_financials_search_screener", "responses": { "200": { "description": "Successful search response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_FinancialsSearchResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Stock Financials", "tags": [ "One" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "POST" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "59743ca6c9b0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/financials/search/screener", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "post_financial_financials_search_screener", "method": "ANY", "path": "/apis/v1/financial/financials/search/screener" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "filters" ], "properties": { "limit": { "type": "integer", "minimum": 1, "default": 10, "description": "The maximum number of results to return." }, "filters": { "type": "array", "items": { "type": "object", "required": [ "field", "operator", "value" ], "properties": { "field": { "type": "string", "description": "The criteria to filter on. For financial metric fields, use 'gt', 'lt', 'gte', 'lte', 'eq' operators. For 'ticker' and 'cik' fields, use the 'in' operator to filter against multiple values." }, "operator": { "type": "string", "enum": [ "gt", "lt", "gte", "lte", "eq", "in" ], "description": "The comparison operator. The 'in' operator can only be used with a field value of 'ticker' or 'cik' and lets you filter against multiple values." }, "value": { "oneOf": [ { "type": "number", "description": "The value to compare against for single-value operators (gt, lt, gte, lte, eq)" }, { "type": "array", "items": { "type": "string" }, "description": "Array of ticker or cik values to compare against when using the 'in' operator" } ] } } }, "minItems": 1, "description": "An array of filter objects to apply to the search." } } } } } }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:899f2dd281ebae3637b70f4164ccd4dc1ee97f2d3ea7c2a6b7f991d9a18d6b2a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/post_financials-search-screener" } }, "/apis/v1/financial/insider-trades": { "get": { "description": "Get insider trades like buys and sells for a ticker by a company insider.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_insider_trades", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Insider trades response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_InsiderTradesResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Insider Trades", "tags": [ "Two" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7e2ff91773b3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/insider-trades", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_insider_trades", "method": "ANY", "path": "/apis/v1/financial/insider-trades" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:0b54122bfa98a47860b9435231c796a93e0f2e4cb58bf93e713cb1bbf467e42e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_insider-trades" } }, "/apis/v1/financial/kpi/guidance": { "get": { "description": "Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "any_financial_apis_v1_financial_kpi_guidance", "responses": { "200": { "description": "Guidance response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_KPIGuidanceResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Guidance", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "408a90eef336" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/kpi/guidance", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "any_financial_apis_v1_financial_kpi_guidance", "method": "ANY", "path": "/apis/v1/financial/kpi/guidance" }, "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.", "required": false, "schema": { "type": "integer", "default": 4, "maximum": 50 } }, { "name": "metric_name", "in": "query", "description": "Filter to a specific metric.", "required": false, "schema": { "type": "string" } }, { "name": "period", "in": "query", "description": "Filter by period type: quarterly or annual.", "required": false, "schema": { "type": "string", "enum": [ "quarterly", "annual" ], "default": "quarterly" } }, { "name": "report_period_gte", "in": "query", "description": "Only return guidance on or after this date (YYYY-MM-DD).", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lte", "in": "query", "description": "Only return guidance on or before this date (YYYY-MM-DD).", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol.", "required": true, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:4f5127c207c3c7ef24bb337946e107c638f210ab89e46f3f07e95b9f6fd32bbd" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/any_financial_apis_v1_financial_kpi_guidance" } }, "/apis/v1/financial/kpi/metrics": { "get": { "description": "Get sector-specific operational KPIs for a ticker. Includes metrics like load factor, CET1 ratio, same-store sales, FFO per share, and more. Sourced from SEC 8-K earnings releases.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "any_financial_apis_v1_financial_kpi_metrics", "responses": { "200": { "description": "KPI metrics response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_KPIMetricsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Metrics", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3284baedafd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/kpi/metrics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "any_financial_apis_v1_financial_kpi_metrics", "method": "ANY", "path": "/apis/v1/financial/kpi/metrics" }, "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Number of periods to return. Returns all metrics for the N most recent periods. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.", "required": false, "schema": { "type": "integer", "default": 4, "maximum": 50 } }, { "name": "metric_name", "in": "query", "description": "Filter to a specific metric (e.g., load_factor, cet1_ratio).", "required": false, "schema": { "type": "string" } }, { "name": "period", "in": "query", "description": "Filter by period type: quarterly or annual.", "required": false, "schema": { "type": "string", "enum": [ "quarterly", "annual" ], "default": "quarterly" } }, { "name": "report_period_gte", "in": "query", "description": "Only return metrics on or after this date (YYYY-MM-DD).", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lte", "in": "query", "description": "Only return metrics on or before this date (YYYY-MM-DD).", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol.", "required": true, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:4bc2f0d67b1f8026616e2667a7f8b568dbd18f10607d11a4bbc6670e8fde6284" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/any_financial_apis_v1_financial_kpi_metrics" } }, "/apis/v1/financial/kpi/non-gaap": { "get": { "description": "Get non-GAAP financial metrics with GAAP equivalents and key adjustments.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "any_financial_apis_v1_financial_kpi_non_gaap", "responses": { "200": { "description": "Non-GAAP metrics response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_KPINonGAAPResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Non-GAAP Metrics", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "35c6d7606ae7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/kpi/non-gaap", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "any_financial_apis_v1_financial_kpi_non_gaap", "method": "ANY", "path": "/apis/v1/financial/kpi/non-gaap" }, "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.", "required": false, "schema": { "type": "integer", "default": 4, "maximum": 50 } }, { "name": "metric_name", "in": "query", "description": "Filter to a specific metric.", "required": false, "schema": { "type": "string" } }, { "name": "period", "in": "query", "description": "Filter by period type: quarterly or annual.", "required": false, "schema": { "type": "string", "enum": [ "quarterly", "annual" ], "default": "quarterly" } }, { "name": "report_period_gte", "in": "query", "description": "Only return metrics on or after this date (YYYY-MM-DD).", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "report_period_lte", "in": "query", "description": "Only return metrics on or before this date (YYYY-MM-DD).", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol.", "required": true, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:de4b7d1dd5fdeed9211a9a97f079a30affdbb8f8190d69497693464b007b15ef" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/any_financial_apis_v1_financial_kpi_non_gaap" } }, "/apis/v1/financial/macro/interest-rates": { "get": { "description": "The daily policy rate of one central bank: one row per calendar day, newest first, 10 rows per page. A rate change appears on the first day the new rate is in effect. For the Federal Reserve the rate is the midpoint of the target range.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_macro_interest_rates", "responses": { "200": { "description": "Interest rates response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_InterestRatesResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Historical Interest Rates", "tags": [ "Zero" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "580cb2e676ff" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/macro/interest-rates", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_macro_interest_rates", "method": "ANY", "path": "/apis/v1/financial/macro/interest-rates" }, "parameters": [ { "name": "bank", "in": "query", "description": "The central bank code, e.g. FED, ECB, BOJ. Use the /macro/interest-rates/banks endpoint to get the list of available banks.", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.", "required": false, "schema": { "type": "string" } }, { "name": "end_date", "in": "query", "description": "The last date to return, inclusive, in YYYY-MM-DD format. Defaults to today.", "required": false, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "description": "The first date to return, inclusive, in YYYY-MM-DD format. Defaults to five years before end_date when both dates are omitted; omit it with an end_date to get all available history through that date.", "required": false, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:ddc65f6cd4d06c76e15358c17396230ef2e5f496ceb4cea597aff9418b7b813e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_macro-interest-rates" } }, "/apis/v1/financial/macro/interest-rates/snapshot": { "get": { "description": "The newest published policy rate of every central bank we cover, one row per bank with the date it is in effect. Pass bank to get one bank only.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_macro_interest_rates_snapshot", "responses": { "200": { "description": "Interest rates snapshot response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_InterestRatesResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Latest Interest Rates", "tags": [ "Zero" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3dc388a59c3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/macro/interest-rates/snapshot", "x-aisa-validation": "provider", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_macro_interest_rates_snapshot", "method": "ANY", "path": "/apis/v1/financial/macro/interest-rates/snapshot" }, "parameters": [ { "name": "bank", "in": "query", "description": "Optional central bank code (e.g., FED, ECB, BOJ) to return one bank only. Use the /macro/interest-rates/banks endpoint to get a list of available banks.", "required": false, "schema": { "type": "string" } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:d44c7896c856ae3b11cde827e790890d113a8424fd47e327cf4c14e7aa7ee387" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_macro-interest-rates-snapshot" } }, "/apis/v1/financial/news": { "get": { "description": "Get recent news articles for a specific company or the broad market. Pass a ticker for company-specific news, or omit the ticker for general market news.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_news", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "News articles response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_NewsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Company News", "tags": [ "Two" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0f944649ae15" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/news", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_news", "method": "ANY", "path": "/apis/v1/financial/news" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:b0d1c072600f213321a781eb179ebf3dc99c589b772a10df8bc39269e63ffbff" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_news" } }, "/apis/v1/financial/prices": { "get": { "description": "Get end-of-day (EOD) historical price data for stocks.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_prices", "parameters": [ { "in": "query", "name": "end_date", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "interval", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "interval_multiplier", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "start_date", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Price data response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_PricesResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Historical Stock Prices", "tags": [ "One" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5f86df4fb424" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/prices", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_prices", "method": "ANY", "path": "/apis/v1/financial/prices" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:9ca72d98b2bb54a7b99cf48a61418ff2280e3e062524619c26a3b6a9eee8d639" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_prices" } }, "/apis/v1/financial/prices/snapshot": { "get": { "description": "Get the real-time price snapshot for a stock, including the current price, day change, and day change percent.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_financial_prices_snapshot", "parameters": [ { "in": "query", "name": "ticker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Price snapshot response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0081E61F2639_PriceSnapshotResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Stock Price Snapshot", "tags": [ "One" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "a202baa7ba09", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "149bb4229190" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/prices/snapshot", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "financial", "x-aisa-runtime-operation": { "operation_id": "get_financial_prices_snapshot", "method": "ANY", "path": "/apis/v1/financial/prices/snapshot" }, "x-aisa-source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://docs.financialdatasets.ai/api/openapi.json", "fetched_at": "2026-10-15T15:12:58.962084+00:00", "content_hash": "sha256:abe8b79a2a1f7e36922e983ae2402734e7305429a7ef7370d78ab7b437ec4a58", "converter": "scripts/import_upstream.py@3", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:d2930b47fb99d38981f09e0aa0f34179df38d8158ace8c70612afa508aacc82d" }, "content_hash": "sha256:dae5002cef7de9b3e722bfe526e42ae41fc7295063a2ac191dcc6c34b5727f44" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_prices-snapshot" } } } }