MetricDuck Metrics API
The metrics API from MetricDuck — 4 operation(s) for metrics.
The metrics API from MetricDuck — 4 operation(s) for metrics.
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-metrics-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 Metrics API
description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
version: 2.0.0
tags:
- name: Metrics
paths:
/api/v1/metrics:
get:
tags:
- Metrics
summary: Get Available Metrics
description: 'Get list of available financial metrics and their descriptions.
Uses in-memory startup cache for instant response (0ms vs 20-30ms BigQuery).
Falls back to BigQuery if cache not loaded.
Cached automatically by cache_middleware (24 hours in prod, 2 min in dev).
Public endpoint with optional auth for tracking.'
operationId: get_available_metrics_api_v1_metrics_get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- 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:
type: array
items:
$ref: '#/components/schemas/MetricsListResponse'
title: Response Get Available Metrics Api V1 Metrics Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/metrics/catalog:
get:
tags:
- Metrics
summary: Get Metrics Catalog
description: 'Get enhanced metrics catalog for metric picker UI.
Includes all metadata needed for metric picker:
- Search tags and aliases for discoverability
- Formatting configuration for UI display
- Relationships (depends_on, related_metrics)
- Plain-English formula explanations
Cached automatically by cache_middleware (24 hours in prod, 2 min in dev).
Public endpoint with optional auth for tracking.'
operationId: get_metrics_catalog_api_v1_metrics_catalog_get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: category
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by category
title: Category
description: Filter by category
- name: search
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Search by keyword in name, description, or tags
title: Search
description: Search by keyword in name, description, or tags
- 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/MetricCatalogResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/metrics/{metric_id}/seo:
get:
tags:
- Metrics
summary: Get Metric Seo
description: 'Get SEO-optimized metric metadata for blog and glossary pages.
Includes:
- SEO slug and keywords
- Plain-English formula explanation
- Use cases and interpretation guidance
- Typical ranges and examples
- Related metrics for cross-linking
Cached automatically by cache_middleware (24 hours in prod, 2 min in dev).
Public endpoint with optional auth for tracking.'
operationId: get_metric_seo_api_v1_metrics__metric_id__seo_get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: metric_id
in: path
required: true
schema:
type: string
description: Metric identifier
title: Metric Id
description: Metric identifier
- 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/MetricSEOResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/companies/{ticker}/ratios:
get:
tags:
- Metrics
summary: Get Ratios
description: Get financial ratios and operational metrics for a specific company
operationId: get_ratios_api_v1_companies__ticker__ratios_get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: ticker
in: path
required: true
schema:
type: string
description: Company ticker symbol
title: Ticker
description: Company ticker symbol
- name: period
in: query
required: false
schema:
type: string
description: 'Period type: quarterly, annual, or ttm'
default: quarterly
title: Period
description: 'Period type: quarterly, annual, or ttm'
- name: years
in: query
required: false
schema:
type: integer
maximum: 10
minimum: 1
description: Number of years of data
default: 5
title: Years
description: Number of years of data
- 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:
type: array
items:
$ref: '#/components/schemas/RatiosItem'
title: Response Get Ratios Api V1 Companies Ticker Ratios Get
'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
MetricCatalogItem:
properties:
metric_id:
type: string
title: Metric Id
display_name:
type: string
title: Display Name
description:
type: string
title: Description
category:
type: string
title: Category
subcategory:
anyOf:
- type: string
- type: 'null'
title: Subcategory
data_type:
type: string
title: Data Type
temporal_type:
type: string
title: Temporal Type
is_derived:
type: boolean
title: Is Derived
is_highlighted:
type: boolean
title: Is Highlighted
hide_if_all_null:
type: boolean
title: Hide If All Null
search_tags:
items:
type: string
type: array
title: Search Tags
default: []
aliases:
items:
type: string
type: array
title: Aliases
default: []
depends_on:
items:
type: string
type: array
title: Depends On
default: []
related_metrics:
items:
type: string
type: array
title: Related Metrics
default: []
formatting_config:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Formatting Config
formula_plain_english:
anyOf:
- type: string
- type: 'null'
title: Formula Plain English
expression:
anyOf:
- type: string
- type: 'null'
title: Expression
type: object
required:
- metric_id
- display_name
- description
- category
- subcategory
- data_type
- temporal_type
- is_derived
- is_highlighted
- hide_if_all_null
title: MetricCatalogItem
description: Enhanced metric metadata for metric picker
MetricItem:
properties:
name:
type: string
title: Name
displayName:
type: string
title: Displayname
description:
type: string
title: Description
unit:
type: string
title: Unit
dataType:
anyOf:
- type: string
- type: 'null'
title: Datatype
temporalType:
type: string
title: Temporaltype
isDerived:
type: boolean
title: Isderived
type: object
required:
- name
- displayName
- description
- unit
- temporalType
- isDerived
title: MetricItem
description: Individual metric metadata
MetricSEOResponse:
properties:
metric_id:
type: string
title: Metric Id
display_name:
type: string
title: Display Name
description:
type: string
title: Description
category:
type: string
title: Category
subcategory:
anyOf:
- type: string
- type: 'null'
title: Subcategory
seo_slug:
type: string
title: Seo Slug
seo_keywords:
items:
type: string
type: array
title: Seo Keywords
default: []
aliases:
items:
type: string
type: array
title: Aliases
default: []
formula_plain_english:
anyOf:
- type: string
- type: 'null'
title: Formula Plain English
use_cases:
anyOf:
- type: string
- type: 'null'
title: Use Cases
interpretation_guidance:
anyOf:
- type: string
- type: 'null'
title: Interpretation Guidance
typical_range:
anyOf:
- type: string
- type: 'null'
title: Typical Range
example_interpretation:
anyOf:
- type: string
- type: 'null'
title: Example Interpretation
industry_notes:
anyOf:
- type: string
- type: 'null'
title: Industry Notes
related_metrics:
items:
type: string
type: array
title: Related Metrics
default: []
depends_on:
items:
type: string
type: array
title: Depends On
default: []
data_type:
type: string
title: Data Type
temporal_type:
type: string
title: Temporal Type
is_derived:
type: boolean
title: Is Derived
type: object
required:
- metric_id
- display_name
- description
- category
- subcategory
- seo_slug
- data_type
- temporal_type
- is_derived
title: MetricSEOResponse
description: SEO-optimized metric metadata for blog/glossary pages
MetricsListResponse:
properties:
category:
type: string
title: Category
metrics:
items:
$ref: '#/components/schemas/MetricItem'
type: array
title: Metrics
type: object
required:
- category
- metrics
title: MetricsListResponse
description: Available metrics response
RatiosItem:
properties:
date:
type: string
title: Date
symbol:
type: string
title: Symbol
cik:
type: string
title: Cik
filing_date:
anyOf:
- type: string
format: date
- type: 'null'
title: Filing Date
fiscal_year:
type: integer
title: Fiscal Year
period:
type: string
title: Period
industry:
anyOf:
- type: string
- type: 'null'
title: Industry
market_cap:
anyOf:
- type: number
- type: 'null'
title: Market Cap
ev:
anyOf:
- type: number
- type: 'null'
title: Ev
pe_ratio:
anyOf:
- type: number
- type: 'null'
title: Pe Ratio
ps_ratio:
anyOf:
- type: number
- type: 'null'
title: Ps Ratio
pb_ratio:
anyOf:
- type: number
- type: 'null'
title: Pb Ratio
ev_sales:
anyOf:
- type: number
- type: 'null'
title: Ev Sales
ev_ebitda:
anyOf:
- type: number
- type: 'null'
title: Ev Ebitda
ev_ebit:
anyOf:
- type: number
- type: 'null'
title: Ev Ebit
ev_fcf:
anyOf:
- type: number
- type: 'null'
title: Ev Fcf
pocf_ratio:
anyOf:
- type: number
- type: 'null'
title: Pocf Ratio
quick_ratio:
anyOf:
- type: number
- type: 'null'
title: Quick Ratio
current_ratio:
anyOf:
- type: number
- type: 'null'
title: Current Ratio
debt_to_equity:
anyOf:
- type: number
- type: 'null'
title: Debt To Equity
roe:
anyOf:
- type: number
- type: 'null'
title: Roe
roa:
anyOf:
- type: number
- type: 'null'
title: Roa
efficiency_ratio:
anyOf:
- type: number
- type: 'null'
title: Efficiency Ratio
cash_conversion:
anyOf:
- type: number
- type: 'null'
title: Cash Conversion
defensive_interval:
anyOf:
- type: number
- type: 'null'
title: Defensive Interval
ebitda:
anyOf:
- type: number
- type: 'null'
title: Ebitda
ebitda_margin:
anyOf:
- type: number
- type: 'null'
title: Ebitda Margin
ebit:
anyOf:
- type: number
- type: 'null'
title: Ebit
accession_number:
anyOf:
- type: string
- type: 'null'
title: Accession Number
type: object
required:
- date
- symbol
- cik
- fiscal_year
- period
title: RatiosItem
description: Individual ratios period data
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
MetricCatalogResponse:
properties:
metrics:
items:
$ref: '#/components/schemas/MetricCatalogItem'
type: array
title: Metrics
total_count:
type: integer
title: Total Count
categories:
items:
type: string
type: array
title: Categories
type: object
required:
- metrics
- total_count
- categories
title: MetricCatalogResponse
description: Metrics catalog response for metric picker
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key