> ## Documentation Index
> Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Company profile

> Company profile: identity, sector, latest filing, quote, key metrics, corporate lineage. `dividendYield` is the platform's trailing-12-month dividends per share (this security's dividend record, split-adjusted) ÷ latest quote, in %; `statistics.dps` is that same trailing DPS and `statistics.payout` is DPS × listed-share equivalents ÷ TTM net income (not cash-flow dividends paid). Operands in `statistics.calc.dividendYield` / `.dps` / `.payout`.



## OpenAPI

````yaml /openapi.json get /api/v1/companies/{id}
openapi: 3.1.0
info:
  title: Astreus API
  version: 1.0.0
  description: >-
    Astreus is a financial data terminal that turns the world's unstructured
    financial disclosure into structured, traceable data. It reads what
    companies, exchanges and central banks publish — annual and interim reports,
    SEC filings, results announcements, investor presentations, earnings calls,
    8-Ks, regulator notices and policy text — across the United States, the Gulf
    (Tadawul, DFM, ADX, Boursa Kuwait, QSE), Japan, Taiwan, Korea, the UK and
    Europe, and serves it as data a program can trust: standardized financial
    statements (annual, quarterly, semiannual), segments and KPIs, the tables
    inside the notes, filing sections as text, investor decks page by page,
    earnings-call transcripts and audio, span-anchored observations, management
    guidance scored against outcomes, typed 8-K events, an attributed intraday
    news tape, insider and 13F ownership, a people registry, point-in-time macro
    series and central-bank text, benchmark, commodity and compute-price series,
    and a validated causal claim graph with scenario simulation. Every number
    carries the filing, page or passage it came from (`fact-source`), and
    nothing is served until it passes per-company validation gates.


    Coverage is published live: `GET /api/v1/landing/coverage` (no key) returns
    every market served with company counts, history depth, completeness and
    periods held per data type — ask it before answering "what do you cover?".
    `{id}` is a ticker, a numeric SEC CIK, or a platform key for a non-SEC
    issuer (XSAU000001) — the `cik` field of the company payload. Human-readable
    guides: https://doc.astreus.ai (coverage at /coverage, data catalog at
    /data-catalog).


    Tiers: `public` endpoints need no credentials. Everything else takes an
    **API key** — create one on the Developers page in the terminal
    (https://astreus.ai/developers) and send it as `X-API-KEY: pk_live_...` (or
    `Authorization: Bearer pk_live_...`). Signed-in terminal sessions may use
    their Cognito ID token instead.


    Rate limits and quotas are per plan (fixed UTC windows): Free — 30 req/min,
    250 req/day; Build — 300 req/min, 100,000 req/month; Scale — custom. Build,
    Scale and prepaid credits are set up with sales
    (https://astreus.ai/contact), not self-serve. Responses carry RateLimit-*,
    X-Quota-* and, when credits pay, X-Billing-Source/X-Credits-Remaining-USD
    headers; a 429 carries `Retry-After` and a machine `code` of rate_limited or
    quota_exceeded (with sales_email).


    Not investment advice. See /terms.
  contact:
    email: saif@astreus.ai
  termsOfService: https://astreus.ai/terms
servers:
  - url: https://astreus.ai
security: []
tags:
  - name: Search & Meta
    description: Entity resolution and platform metadata.
  - name: Company Data
    description: Profiles, structure, leadership, calendars.
  - name: Financial Statements
    description: >-
      Standardized XBRL-derived statements — every line traceable to its filing
      via fact provenance.
  - name: SEC Filings
    description: >-
      The filing index and documents (SEC and exchange-published), parsed
      section text, and the tables inside the notes as gated grids and series.
  - name: 8-K Events
    description: Material events, typed by family, with extracted item text.
  - name: News
    description: >-
      The intraday news tape: filings, releases and licensed wires with source
      attribution, storylines and topics.
  - name: Transcripts & Calls
    description: Earnings-call transcripts, span-anchored observations, IR decks.
  - name: Guidance & Scorecards
    description: What management promised vs. what happened.
  - name: Ownership & Insiders
    description: 13F holders, Forms 3/4/5, the people registry.
  - name: Macro
    description: Point-in-time economic series and central-bank text.
  - name: Market Data
    description: Daily bars for stocks, benchmarks, commodities and compute.
  - name: Intelligence
    description: Narratives, the validated claim graph, scenario simulation.
  - name: Analytics
    description: Correlation and charting over any catalog series.
paths:
  /api/v1/companies/{id}:
    get:
      tags:
        - Company Data
      summary: Company profile
      description: >-
        Company profile: identity, sector, latest filing, quote, key metrics,
        corporate lineage. `dividendYield` is the platform's trailing-12-month
        dividends per share (this security's dividend record, split-adjusted) ÷
        latest quote, in %; `statistics.dps` is that same trailing DPS and
        `statistics.payout` is DPS × listed-share equivalents ÷ TTM net income
        (not cash-flow dividends paid). Operands in
        `statistics.calc.dividendYield` / `.dps` / `.payout`.
      operationId: get-company-profile
      parameters:
        - name: id
          in: path
          required: true
          description: >-
            Ticker symbol (e.g. NVDA), numeric SEC CIK (zero-padding optional),
            or the platform key of a non-SEC issuer (e.g. XSAU000001 — the `cik`
            field of the company payload). A bare ticker always resolves to the
            SEC registrant.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                company:
                  id: 69d1debf-37a7-4959-b4e5-6030b5ac1a84
                  name: NVIDIA CORP
                  legal_name: NVIDIA CORP
                  symbol: NVDA
                  ticker: NVDA
                  cik: '0001045810'
                  country_code: US
                  logoUrl: /api/v1/companies/NVDA/logo
                  brandMark: >-
                    https://cdn.brandfetch.io/nvidia.com/icon?c=1idQJ_8ukVnXwK_PLYs&fallback=404
                  domain: https://www.nvidia.com
                  secondary_offerings: []
                  subsidiaries: []
                  parent_registrant: null
                  lineage_events: []
                  price: 214.72
                  change: -2.13
                  changePercent: -0.982248
                  afterHoursPrice: 215.38
                  afterHoursChange: 0.660004
                  afterHoursChangePercent: 0.307379
                  prevClose: 216.85
                  open: 218.42
                  dayHigh: 218.74
                  dayLow: 214.5
                  marketCap: $5.20T
                  marketCapFull: 5,200,733,011,968
                  volume: 91.59M
                  avgVolume: 141.32M
                  range52w: 164.07 – 236.54
                  sector: Technology
                  industry: Semiconductors
                  country: US
                  exchange: N/A
                  description: >-
                    NVIDIA Corporation operates as a data center scale AI
                    infrastructure company in …
                  ipoDate: Jan 22, 1999
                  ceo: Jen-Hsun Huang
                  employees: 42,000
                  float: 23.23B shares
                  peRatio: 32.8821
                  dividendYield: 0.128
                  beta: 2.215
                  eps: 6.53
                  revenue: 81615000000
                  statistics:
                    fundamentalsAsOf: '2026-04-26'
                    enterpriseValue: 5158868120000
                    sharesOutstanding: 24221000000
                    ttmRevenue: 253491000000
                    grossMargin: 74.1454
                    ebitdaMargin: 65.2938
                    operatingMargin: 64.02
                    preTaxMargin: 74.7336
                    netMargin: 62.9659
                    fcfMargin: 46.9744
                    roa: 61.5141
                    roe: 81.6543
                    roce: 75.2748
                    roic: 89.0126
                    peTtm: 32.8821
                    pb: 26.6058
                    evSales: 20.3513
                    evEbitda: 31.1688
                    pFcf: 43.6757
                    evGrossProfit: 27.4478
                    priceTarget: 304.1207
                    peNtm: 16.4823
                    peg: 0.5973
                    cash: 50335000000
                    netDebt: -41865000000
                    debtEquity: 0.0433
                    ebitInterest: 544.5805
                    revGrowthYoY: 70.6838
                    epsGrowthYoY: 109.9678
                    revCagr3y: 100.0451
                    epsCagr3y: 204.2395
                    payout: 3.3802
                    dps: 0.27
                    calc:
                      peTtm:
                        formula: Price ÷ EPS (TTM, diluted)
                        inputs:
                          - label: Price
                            value: 214.72
                            format: price
                            qualifier: >-
                              primary listing; fresher of latest close vs live
                              quote
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      ev:
                        formula: Market Cap + Total Debt − Cash & ST Investments
                        inputs:
                          - label: Market Cap
                            value: 5200733120000
                            format: currency
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      ttmRevenue:
                        formula: Sum of the last 4 fiscal quarters' revenue
                        inputs:
                          - label: Revenue (TTM)
                            value: 253491000000
                            format: currency
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      grossMargin:
                        formula: Gross Profit (TTM) ÷ Revenue (TTM)
                        inputs:
                          - label: Gross Profit (TTM)
                            value: 187952000000
                            format: currency
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      ebitdaMargin:
                        formula: EBITDA (TTM) ÷ Revenue (TTM)
                        inputs:
                          - label: EBITDA (TTM)
                            value: 165514000000
                            format: currency
                        note: >-
                          EBITDA = operating income + depreciation &
                          amortization. TTM = sum of the last 4…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      operatingMargin:
                        formula: Operating Income (TTM) ÷ Revenue (TTM)
                        inputs:
                          - label: Operating Income (TTM)
                            value: 162285000000
                            format: currency
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      preTaxMargin:
                        formula: Pre-Tax Income (TTM) ÷ Revenue (TTM)
                        inputs:
                          - label: Pre-Tax Income (TTM)
                            value: 189443000000
                            format: currency
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      netMargin:
                        formula: Net Income (TTM) ÷ Revenue (TTM)
                        inputs:
                          - label: Net Income (TTM)
                            value: 159613000000
                            format: currency
                        note: >-
                          Net income attributable to shareholders (ties out to
                          diluted EPS). TTM = sum of …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      fcfMargin:
                        formula: Free Cash Flow (TTM) ÷ Revenue (TTM)
                        inputs:
                          - label: Free Cash Flow (TTM)
                            value: 119076000000
                            format: currency
                        note: >-
                          FCF = operating cash flow − capital expenditures. TTM
                          = sum of the last 4 distin…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      roa:
                        formula: Net Income (TTM) ÷ Total Assets
                        inputs:
                          - label: Net Income (TTM)
                            value: 159613000000
                            format: currency
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      roe:
                        formula: Net Income (TTM) ÷ Shareholders' Equity
                        inputs:
                          - label: Net Income (TTM)
                            value: 159613000000
                            format: currency
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      roce:
                        formula: >-
                          Operating Income (TTM) ÷ (Total Assets − Current
                          Liabilities)
                        inputs:
                          - label: Operating Income (TTM)
                            value: 162285000000
                            format: currency
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      roic:
                        formula: NOPAT ÷ (Total Debt + Equity − Cash & ST Inv)
                        inputs:
                          - label: Operating Income (TTM)
                            value: 162285000000
                            format: currency
                            qualifier: NOPAT before tax
                        note: >-
                          NOPAT = operating income × (1 − TTM effective tax
                          rate, clamped to 0–50%); effec…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      pb:
                        formula: Market Cap ÷ Shareholders' Equity
                        inputs:
                          - label: Market Cap
                            value: 5200733120000
                            format: currency
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      evSales:
                        formula: Enterprise Value ÷ Revenue (TTM)
                        inputs:
                          - label: Enterprise Value
                            value: 5158868120000
                            format: currency
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      evEbitda:
                        formula: Enterprise Value ÷ EBITDA (TTM)
                        inputs:
                          - label: Enterprise Value
                            value: 5158868120000
                            format: currency
                        note: >-
                          EBITDA = operating income + depreciation &
                          amortization. Shown only when EBITDA …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      pFcf:
                        formula: Market Cap ÷ Free Cash Flow (TTM)
                        inputs:
                          - label: Market Cap
                            value: 5200733120000
                            format: currency
                        note: >-
                          Shown only when FCF is positive. TTM = sum of the last
                          4 distinct fiscal quarter…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      evGrossProfit:
                        formula: Enterprise Value ÷ Gross Profit (TTM)
                        inputs:
                          - label: Enterprise Value
                            value: 5158868120000
                            format: currency
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      cash:
                        formula: Cash & Equivalents + Short-Term Investments
                        inputs:
                          - label: Cash & ST Investments
                            value: 50335000000
                            format: currency
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      netDebt:
                        formula: Total Debt − Cash & ST Investments
                        inputs:
                          - label: Total Debt
                            value: 8470000000
                            format: currency
                            qualifier: long-term debt incl. current portion
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      debtEquity:
                        formula: Total Debt ÷ Shareholders' Equity
                        inputs:
                          - label: Total Debt
                            value: 8470000000
                            format: currency
                        note: >-
                          Balance-sheet figures are from the latest filed
                          balance sheet (period end 2026-0…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      ebitInterest:
                        formula: Operating Income (TTM) ÷ Interest Expense (TTM)
                        inputs:
                          - label: Operating Income (TTM)
                            value: 162285000000
                            format: currency
                        note: >-
                          Shown only when interest expense is positive. TTM =
                          sum of the last 4 distinct f…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      revGrowthYoY:
                        formula: >-
                          (Revenue TTM − prior-year Revenue TTM) ÷ prior-year
                          Revenue TTM
                        inputs:
                          - label: Revenue (TTM)
                            value: 253491000000
                            format: currency
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      epsGrowthYoY:
                        formula: (EPS TTM − prior-year EPS TTM) ÷ prior-year EPS TTM
                        inputs:
                          - label: EPS (TTM)
                            value: 6.53
                            format: per_share
                            qualifier: diluted, split-adjusted
                        note: >-
                          TTM = sum of the last 4 distinct fiscal quarters as
                          known on the metric date (a …
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      revCagr3y:
                        formula: (FY Revenue ÷ FY-3 Revenue)^(1/3) − 1
                        inputs: []
                        note: >-
                          Compound annual growth across the last 3 completed
                          fiscal years, from as-filed a…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      epsCagr3y:
                        formula: (FY diluted EPS ÷ FY-3 diluted EPS)^(1/3) − 1
                        inputs: []
                        note: >-
                          Compound annual growth across the last 3 completed
                          fiscal years; each year's dil…
                        asOf: >-
                          price as of 2026-08-21 · fundamentals through
                          2026-04-26
                      payout:
                        formula: Dividends per Share (TTM) × Shares ÷ Net Income (TTM)
                        inputs:
                          - label: Dividends per Share (TTM)
                            value: 0.27
                            format: per_share
                            qualifier: >-
                              split-adjusted; 3 payments with ex-dates
                              2025-12-03 → 2026-09-09
                        note: >-
                          Shown only when net income is positive. TTM = cash
                          dividends whose ex-date falls…
                        asOf: >-
                          dividends through 2026-09-16 · fundamentals through
                          2026-07-25
                      dps:
                        formula: >-
                          Σ dividends per share with ex-dates in the trailing 12
                          months
                        inputs:
                          - label: Dividends per Share (TTM)
                            value: 0.27
                            format: per_share
                            qualifier: >-
                              split-adjusted; 3 payments with ex-dates
                              2025-12-03 → 2026-09-09
                        note: >-
                          TTM = cash dividends whose ex-date falls in the 12
                          months to today, from the sec…
                        asOf: dividends through 2026-09-16
                  business_summary: >-
                    NVIDIA Corporation operates as a data center scale AI
                    infrastructure company in …
                  employee_count: 42000
                  incorporation_date: null
                  net_income: 18775000000
                  total_assets: 206803000000
                  total_equity: 79327000000
                  shares_outstanding: 24221000000
                  latest_filing:
                    fiscal_year: 2027
                    fiscal_quarter: 1
                    period_end_date: '2026-04-26T07:00:00.000Z'
                    filing_type: 10-Q
        '400':
          description: Invalid parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Unknown company, country, symbol or resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited. Honour Retry-After.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
        - cognitoIdToken: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable message.
        code:
          type: string
          description: >-
            Stable machine code when present: unauthenticated, upgrade_required,
            rate_limited, quota_exceeded.
          enum:
            - unauthenticated
            - upgrade_required
            - rate_limited
            - quota_exceeded
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Astreus API key (pk_live_...), created on the Developers page in the
        terminal. Also accepted as `Authorization: Bearer pk_live_...`.
      x-default: pk_live_YOUR_KEY
    cognitoIdToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Amazon Cognito ID token (token_use=id) for the Astreus user pool — the
        terminal's own session credential. API consumers should use an API key
        instead.

````