MetricDuck Filing Intelligence API

The Filing Intelligence API from MetricDuck — 2 operation(s) for filing intelligence.

GitHub OpenAPI

Operations 2

GET /api/v1/filing-intelligence/recent Get recent filing intelligence across all companies #
POST /api/v1/filing-intelligence/screen Screen companies by filing intelligence signals #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/metricduck-com:metricduck-com-filing-intelligence-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

metricduck-com-filing-intelligence-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Metric Duck Filing Intelligence API
  description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
  version: 2.0.0
tags:
- name: Filing Intelligence
paths:
  /api/v1/filing-intelligence/recent:
    get:
      tags:
      - Filing Intelligence
      summary: Get recent filing intelligence across all companies
      description: 'Retrieve recent filing intelligence for dashboard feeds.


        Returns simplified summaries of the most recent 10-Q/10-K filings

        across all tracked companies, ranked by company importance.


        This endpoint is designed for dashboard cards showing latest quarterly filings.'
      operationId: get_recent_filing_intelligence_api_v1_filing_intelligence_recent_get
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 50
          minimum: 1
          description: Maximum number of filings to return
          default: 10
          title: Limit
        description: Maximum number of filings to return
      - name: days_lookback
        in: query
        required: false
        schema:
          type: integer
          maximum: 90
          minimum: 1
          description: Number of days to look back for filings
          default: 14
          title: Days Lookback
        description: Number of days to look back for filings
      - name: api_key
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Api Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingIntelligenceSummaryListResponse'
        '500':
          description: Database error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingIntelligenceError'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/filing-intelligence/screen:
    post:
      tags:
      - Filing Intelligence
      summary: Screen companies by filing intelligence signals
      description: 'Cross-company screening by qualitative signals extracted from SEC filings.


        Filters by signals a model extracted from each filing (management tone, material

        weakness, SBC levels, risks it read as new) — NOT by LLM-generated scores.


        Available signals:

        - tone_cautious: management tone is cautious or defensive

        - tone_shifted: tone shifted more cautious vs prior filing

        - material_weakness: material weakness in internal controls detected

        - has_new_risks: a model read ≥1 risk as new in this filing (not a text diff vs the prior filing)'
      operationId: screen_filing_signals_api_v1_filing_intelligence_screen_post
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
      parameters:
      - name: api_key
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Api Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignalScreenRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignalScreenResponse'
        '400':
          description: Invalid signal name
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingIntelligenceError'
        '500':
          description: Database error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingIntelligenceError'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    FilingIntelligenceError:
      properties:
        success:
          type: boolean
          title: Success
          default: false
        error:
          type: string
          title: Error
        ticker:
          anyOf:
          - type: string
          - type: 'null'
          title: Ticker
        message:
          anyOf:
          - type: string
          - type: 'null'
          title: Message
        help:
          anyOf:
          - type: string
          - type: 'null'
          title: Help
      type: object
      required:
      - error
      title: FilingIntelligenceError
      description: Error response for filing intelligence endpoints.
    FilingIntelligenceSummaryListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/FilingIntelligenceSummary'
          type: array
          title: Data
        total:
          type: integer
          title: Total
      type: object
      required:
      - data
      - total
      title: FilingIntelligenceSummaryListResponse
      description: 'List response for recent filing intelligence summaries.


        Returned by GET /api/v1/filing-intelligence/recent'
    SignalScreenMatch:
      properties:
        ticker:
          anyOf:
          - type: string
          - type: 'null'
          title: Ticker
        company_name:
          type: string
          title: Company Name
        sector:
          anyOf:
          - type: string
          - type: 'null'
          title: Sector
        form_type:
          type: string
          title: Form Type
        filing_date:
          type: string
          title: Filing Date
        fiscal_period:
          anyOf:
          - type: string
          - type: 'null'
          title: Fiscal Period
        matched_signals:
          items:
            type: string
          type: array
          title: Matched Signals
        match_detail:
          anyOf:
          - type: string
          - type: 'null'
          title: Match Detail
        matched_payloads:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          title: Matched Payloads
        cik:
          anyOf:
          - type: string
          - type: 'null'
          title: Cik
        accession_number:
          anyOf:
          - type: string
          - type: 'null'
          title: Accession Number
        source_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Url
        source_event_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Event Type
        transcript_version:
          anyOf:
          - type: integer
          - type: 'null'
          title: Transcript Version
        market_cap:
          anyOf:
          - type: number
          - type: 'null'
          title: Market Cap
      type: object
      required:
      - company_name
      - form_type
      - filing_date
      - matched_signals
      title: SignalScreenMatch
      description: A single company match from signal screening.
    SignalScreenRequest:
      properties:
        signals:
          items:
            type: string
          type: array
          title: Signals
          description: Signal filters to match. Pass any signal_id present in the signals.signals catalog. The api is id-agnostic — no allowlist enforced here; mcp-worker SCREENING_SIGNALS (mcp-worker/src/tools/signal-catalog.ts) is the SSOT for client-facing valid IDs.
        ticker:
          anyOf:
          - type: string
          - type: 'null'
          title: Ticker
          description: Filter to a single ticker (e.g. 'NVDA'). Per-ticker cross-source signal inventory. Combines with sectors as AND.
        sectors:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Sectors
          description: Sector codes to filter by (e.g., ['TECH', 'FIN'])
        recency_days:
          type: integer
          maximum: 365.0
          minimum: 1.0
          title: Recency Days
          description: Only filings from last N days
          default: 90
        limit:
          type: integer
          maximum: 50.0
          minimum: 1.0
          title: Limit
          description: Max results to return
          default: 20
        match_mode:
          type: string
          enum:
          - all
          - any
          title: Match Mode
          description: 'Signal-list match semantics within each source type. ''all'' (default, backwards-compat): row qualifies only if every requested signal_id fires on the same source row. ''any'': row qualifies if any requested signal_id fires. Use ''any'' for broadcast-discovery; ''all'' for targeted screening.'
          default: all
        order_by:
          type: string
          enum:
          - recency
          - market_cap
          title: Order By
          description: 'Result ordering. ''recency'' (default): event_date / filing_date DESC. ''market_cap'': company market cap DESC NULLS LAST, recency as tiebreaker. Use ''market_cap'' for broadcast-digest discovery so high-impact filings aren''t pushed past the limit by fresher small-cap noise.'
          default: recency
        since_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Since Date
          description: 'Time-travel lower bound (inclusive) on event_date / filing_date. When provided alongside until_date, defines an explicit date range — overrides recency_days. Format: YYYY-MM-DD. Use for backfilling past digests or anchoring research to specific historical windows.'
        until_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Until Date
          description: 'Time-travel upper bound (inclusive) on event_date / filing_date. When provided alongside since_date, defines an explicit date range — overrides recency_days. Defaults to today (UTC) when only since_date is set. Format: YYYY-MM-DD.'
        agreement_type_filter:
          anyOf:
          - type: string
          - type: 'null'
          title: Agreement Type Filter
          description: Discriminator filter for ir_partnership signals — restricts results to a specific agreement_type (e.g., 'm_and_a_announcement', 'partnership_strategic'). Values mirror services/sec-8k-material-agreement/extraction/schemas.py AgreementType. Only applied to ir_press_release source rows; ignored for other sources.
      type: object
      required:
      - signals
      title: SignalScreenRequest
      description: Request for cross-company filing intelligence signal screening.
    FilingIntelligenceSummary:
      properties:
        ticker:
          type: string
          title: Ticker
        cik:
          type: string
          title: Cik
        company_name:
          type: string
          title: Company Name
        accession_number:
          type: string
          title: Accession Number
        form_type:
          type: string
          title: Form Type
        filing_date:
          type: string
          format: date
          title: Filing Date
        fiscal_period:
          anyOf:
          - type: string
          - type: 'null'
          title: Fiscal Period
        fiscal_year:
          anyOf:
          - type: integer
          - type: 'null'
          title: Fiscal Year
        overall_score:
          anyOf:
          - type: integer
            maximum: 10.0
            minimum: 1.0
          - type: 'null'
          title: Overall Score
        executive_summary:
          anyOf:
          - type: string
          - type: 'null'
          title: Executive Summary
        top_concerns:
          items:
            type: string
          type: array
          title: Top Concerns
        top_positives:
          items:
            type: string
          type: array
          title: Top Positives
        processor_version:
          anyOf:
          - type: string
          - type: 'null'
          title: Processor Version
      type: object
      required:
      - ticker
      - cik
      - company_name
      - accession_number
      - form_type
      - filing_date
      title: FilingIntelligenceSummary
      description: 'Simplified filing intelligence summary for list/card views.


        Used by GET /api/v1/filing-intelligence/recent for dashboard feeds.

        Contains only essential fields needed for displaying recent 10-Q/10-K filings.'
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SurfaceCoverage:
      properties:
        surface:
          type: string
          title: Surface
        companies_covered:
          type: integer
          title: Companies Covered
      type: object
      required:
      - surface
      - companies_covered
      title: SurfaceCoverage
      description: '#coverage-honesty: how many DISTINCT companies were EVALUATED on one screened

        surface (trailing ~2y) — the screen''s DENOMINATOR for that surface, counted from the

        SAME table the surface''s handler screens, so a caller can tell ''0 of 3,795 filers''

        from ''0 of ~830 with transcripts''. Absence from a surface''s source table means

        NOT-EVALUATED for that surface''s criteria, not evaluated-and-not-fired.'
    SignalScreenResponse:
      properties:
        price_attribution:
          anyOf:
          - type: string
          - type: 'null'
          title: Price Attribution
          description: The price source's required attribution, present only when the prices in this response come from a source that requires one (IEX HIST).
        matches:
          items:
            $ref: '#/components/schemas/SignalScreenMatch'
          type: array
          title: Matches
        total:
          type: integer
          title: Total
        signals_requested:
          items:
            type: string
          type: array
          title: Signals Requested
        coverage:
          items:
            $ref: '#/components/schemas/SurfaceCoverage'
          type: array
          title: Coverage
          description: 'Per-surface coverage DENOMINATORS (#coverage-honesty): distinct companies evaluated on each screened surface. `total` is the MATCH count, NOT a share of the universe — read this to scope the result. A company absent from a surface''s source table was NOT evaluated for that surface''s criteria (absence ≠ not-fired). NOTE: the denominator window is a fixed trailing ~2y and may exceed a narrower `recency_days` screen window.'
        coverage_note:
          anyOf:
          - type: string
          - type: 'null'
          title: Coverage Note
          description: Human scope caveat, esp. when a screen mixes surfaces with divergent coverage (e.g. filings ~3,795 vs transcripts ~830).
        available_signals:
          items:
            type: string
          type: array
          title: Available Signals
          description: (Reserved.) Empty by default. The api does not enumerate the signals catalog in responses; mcp-worker SCREENING_SIGNALS (mcp-worker/src/tools/signal-catalog.ts) is the SSOT for valid IDs. Kept on the model for back-compat with consumers that read the field name.
      type: object
      required:
      - matches
      - total
      - signals_requested
      title: SignalScreenResponse
      description: Response for cross-company filing intelligence signal screening.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key