> ## 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.

# Coverage inventory

> The live coverage inventory — what Astreus holds right now, straight from the serving tables, refreshed hourly. Universe totals (companies by sector and exchange, filings by year and type, facts, prices, macro series, transcripts, observations, narratives, guidance commitments, central-bank documents) plus `markets[]`: for every country served, its exchanges, published companies, the earliest reporting period held, the median completeness score, served note tables, and for each data type (financial statements, segments & KPIs, report documents, filing notes, earnings releases, transcripts, audio, investor presentations, 13F holdings) the reporting periods held versus the periods that exist. Ask this before answering "what is your coverage of market X?".



## OpenAPI

````yaml /openapi.json get /api/v1/landing/coverage
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/landing/coverage:
    get:
      tags:
        - Search & Meta
      summary: Coverage inventory
      description: >-
        The live coverage inventory — what Astreus holds right now, straight
        from the serving tables, refreshed hourly. Universe totals (companies by
        sector and exchange, filings by year and type, facts, prices, macro
        series, transcripts, observations, narratives, guidance commitments,
        central-bank documents) plus `markets[]`: for every country served, its
        exchanges, published companies, the earliest reporting period held, the
        median completeness score, served note tables, and for each data type
        (financial statements, segments & KPIs, report documents, filing notes,
        earnings releases, transcripts, audio, investor presentations, 13F
        holdings) the reporting periods held versus the periods that exist. Ask
        this before answering "what is your coverage of market X?".
      operationId: get-coverage-inventory
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                generatedAt: '2026-09-12T13:10:21.391Z'
                companies:
                  covered: 729
                  knownToEdgar: 850
                  bySector:
                    - name: Technology
                      count: 192
                    - name: Industrials
                      count: 129
                    - name: Financial Services
                      count: 80
                  byExchange:
                    - name: NYSE
                      count: 417
                    - name: Nasdaq
                      count: 240
                    - name: TSE
                      count: 25
                    - name: TWSE
                      count: 15
                    - name: Unclassified
                      count: 8
                filings:
                  total: 64639
                  parsed: 64515
                  firstYear: 1994
                  lastYear: 2026
                  byType:
                    - name: 10-Q
                      count: 32588
                    - name: DEF 14A
                      count: 15266
                    - name: 10-K
                      count: 10919
                    - name: S-1/A
                      count: 1127
                facts:
                  financialApprox: 55780104
                  segment: 1977900
                ownership:
                  insiderTransactions: 3726578
                  institutionalHoldings: 15590856
                  eightKEvents: 151104
                prices:
                  rows: 6628768
                  securities: 1120
                  firstDate: '1962-01-02'
                  lastDate: '2026-09-11'
                macro:
                  economies: 34
                  series: 1127
                  observations: 2881504
                  firstDate: '1854-12-01'
                  lastDate: '2026-09-11'
                  byProvider:
                    - name: EIA
                      count: 446
                    - name: FRED
                      count: 175
                    - name: CME
                      count: 72
                intelligence:
                  observations: 742458
                  narratives: 2521
                  claimEdges: 8522
                  guidanceCommitments: 72582
                  transcripts: 12171
                  transcriptCompanies: 499
                  transcriptFirstDate: '2010-04-26'
                  transcriptLastDate: '2026-09-10'
                  centralBankDocuments: 5621
                markets:
                  - countryCode: US
                    exchanges:
                      - NYSE
                      - Nasdaq
                      - OTC
                      - CBOE
                    companies: 633
                    earliestPeriod: '1991-03-31'
                    medianScore: 45
                    noteTables: 5641
                    measuredAt: '2026-09-12'
                    rows:
                      audio:
                        held: 0
                        expected: 60129
                      documents:
                        held: 74516
                        expected: 75032
                      earnings_release:
                        held: 222
                        expected: 60129
                      filing_notes:
                        held: 46115
                        expected: 75032
                      financials:
                        held: 46666
                        expected: 75032
                      holdings_13f:
                        held: 26492
                        expected: 29819
                      presentation:
                        held: 8219
                        expected: 60129
                      segments:
                        held: 41843
                        expected: 75032
                      transcript:
                        held: 8461
                        expected: 60129
                  - countryCode: SA
                    exchanges:
                      - TADAWUL
                    companies: 54
                    earliestPeriod: '2012-03-31'
                    medianScore: 44
                    noteTables: 978
                    measuredAt: '2026-09-12'
                    rows:
                      audio:
                        held: 0
                        expected: 1553
                      documents:
                        held: 1957
                        expected: 1957
                      earnings_release:
                        held: 1414
                        expected: 1553
                      filing_notes:
                        held: 347
                        expected: 1957
                      financials:
                        held: 1108
                        expected: 1957
                      presentation:
                        held: 397
                        expected: 1553
                      segments:
                        held: 1265
                        expected: 1957
                      transcript:
                        held: 55
                        expected: 1553
                  - countryCode: JP
                    exchanges:
                      - TSE
                    companies: 25
                    earliestPeriod: '2016-06-30'
                    medianScore: 51
                    noteTables: 0
                    measuredAt: '2026-09-12'
                    rows:
                      audio:
                        held: 0
                        expected: 792
                      documents:
                        held: 985
                        expected: 985
                      earnings_release:
                        held: 0
                        expected: 792
                      filing_notes:
                        held: 0
                        expected: 985
                      financials:
                        held: 908
                        expected: 985
                      presentation:
                        held: 0
                        expected: 792
                      segments:
                        held: 775
                        expected: 985
                      transcript:
                        held: 0
                        expected: 792
                  - countryCode: TW
                    exchanges:
                      - TWSE
                      - NYSE
                      - TPEX
                      - Nasdaq
                    companies: 22
                    earliestPeriod: '2000-12-31'
                    medianScore: 45
                    noteTables: 0
                    measuredAt: '2026-09-12'
                    rows:
                      audio:
                        held: 0
                        expected: 1048
                      documents:
                        held: 1225
                        expected: 1276
                      earnings_release:
                        held: 12
                        expected: 1048
                      filing_notes:
                        held: 81
                        expected: 1276
                      financials:
                        held: 1175
                        expected: 1276
                      holdings_13f:
                        held: 49
                        expected: 62
                      presentation:
                        held: 16
                        expected: 1048
                      segments:
                        held: 58
                        expected: 1276
                      transcript:
                        held: 0
                        expected: 1048
                  - countryCode: AE
                    exchanges:
                      - DFM
                      - ADX
                    companies: 14
                    earliestPeriod: '2007-12-31'
                    medianScore: 44
                    noteTables: 0
                    measuredAt: '2026-09-12'
                    rows:
                      audio:
                        held: 26
                        expected: 404
                      documents:
                        held: 506
                        expected: 506
                      earnings_release:
                        held: 94
                        expected: 404
                      filing_notes:
                        held: 121
                        expected: 506
                      financials:
                        held: 385
                        expected: 506
                      presentation:
                        held: 137
                        expected: 404
                      segments:
                        held: 103
                        expected: 506
                      transcript:
                        held: 104
                        expected: 404
        '400':
          description: Invalid parameter.
          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: []
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

````