MetricDuck Earnings Calendar API
The earnings-calendar API from MetricDuck — 1 operation(s) for earnings-calendar.
The earnings-calendar API from MetricDuck — 1 operation(s) for earnings-calendar.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/metricduck-com:metricduck-com-earnings-calendar-api"
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.
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: 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