MetricDuck Earnings Calendar API

The earnings-calendar API from MetricDuck — 1 operation(s) for earnings-calendar.

GitHub OpenAPI

Operations 1

GET /api/v1/earnings-calendar/next-filings Get Next Filings #

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-earnings-calendar-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-earnings-calendar-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Metric Duck Earnings Calendar API
  description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
  version: 2.0.0
tags:
- name: earnings-calendar
paths:
  /api/v1/earnings-calendar/next-filings:
    get:
      tags:
      - earnings-calendar
      summary: Get Next Filings
      description: 'Get next predicted filings for companies.


        **Use Cases**:

        - Alert table batch lookup: `?cik=0000320193,0000789019&form_type=8-K-2.02`

        - Single company check: `?cik=0000320193&days=30`

        - Browse upcoming filings: `?days=30&limit=20&offset=0`

        - Filter by form type: `?form_type=10-Q,10-K&days=60`


        **Response**: Companies with next_filing dict keyed by form_type'
      operationId: get_next_filings_api_v1_earnings_calendar_next_filings_get
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
      parameters:
      - name: cik
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Single CIK or comma-separated list of CIKs for batch lookup
          title: Cik
        description: Single CIK or comma-separated list of CIKs for batch lookup
      - name: form_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Filter by form type(s): 10-Q, 10-K, 8-K-2.02 (comma-separated)'
          title: Form Type
        description: 'Filter by form type(s): 10-Q, 10-K, 8-K-2.02 (comma-separated)'
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          description: Look ahead N days for upcoming filings
          default: 90
          title: Days
        description: Look ahead N days for upcoming filings
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 1000
          minimum: 1
          description: Maximum number of companies to return
          default: 100
          title: Limit
        description: Maximum number of companies to return
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Pagination offset
          default: 0
          title: Offset
        description: Pagination offset
      - name: min_rank
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            minimum: 1
          - type: 'null'
          description: Filter to top N companies by market cap rank
          title: Min Rank
        description: Filter to top N companies by market cap rank
      - 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/NextFilingsResponse'
        '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
    NextFilingsResponse:
      properties:
        total:
          type: integer
          title: Total
          description: Total number of companies with upcoming filings
        items:
          items:
            $ref: '#/components/schemas/CompanyNextFilings'
          type: array
          title: Items
          description: List of companies with next filings
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
          description: Pagination information
      type: object
      required:
      - total
      - items
      - pagination
      title: NextFilingsResponse
      description: Response for next filings endpoint
    PaginationInfo:
      properties:
        limit:
          type: integer
          title: Limit
          description: Number of items per page
        offset:
          type: integer
          title: Offset
          description: Current offset
        has_next:
          type: boolean
          title: Has Next
          description: Whether there are more items
      type: object
      required:
      - limit
      - offset
      - has_next
      title: PaginationInfo
      description: Pagination metadata
    NextFiling:
      properties:
        predicted_date:
          type: string
          format: date
          title: Predicted Date
          description: Predicted filing date
        days_until:
          type: integer
          title: Days Until
          description: Days until filing from today
        confidence:
          type: string
          title: Confidence
          description: 'Prediction confidence: high, medium, low'
        time_window:
          type: string
          title: Time Window
          description: 'Time window: BEFORE_MARKET, AFTER_MARKET, DURING_MARKET, UNKNOWN'
        date_range_start:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Date Range Start
          description: Earliest possible filing date
        date_range_end:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Date Range End
          description: Latest possible filing date
      type: object
      required:
      - predicted_date
      - days_until
      - confidence
      - time_window
      title: NextFiling
      description: Predicted filing with confidence and time window
    CompanyNextFilings:
      properties:
        cik:
          type: string
          title: Cik
          description: SEC CIK identifier
        ticker:
          anyOf:
          - type: string
          - type: 'null'
          title: Ticker
          description: Stock ticker symbol
        company_name:
          type: string
          title: Company Name
          description: Company legal name
        rank:
          anyOf:
          - type: integer
          - type: 'null'
          title: Rank
          description: Company rank by market cap
        market_cap:
          anyOf:
          - type: number
          - type: 'null'
          title: Market Cap
          description: Market capitalization in USD
        next_filing:
          additionalProperties:
            $ref: '#/components/schemas/NextFiling'
          type: object
          title: Next Filing
          description: Next predicted filing by form type (10-Q, 10-K, 8-K-2.02)
      type: object
      required:
      - cik
      - company_name
      title: CompanyNextFilings
      description: Company metadata with next predicted filings
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key