MetricDuck Market API
The market API from MetricDuck — 3 operation(s) for market.
The market API from MetricDuck — 3 operation(s) for market.
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-market-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 Market API
description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
version: 2.0.0
tags:
- name: Market
paths:
/api/v1/market/daily/{ticker}:
get:
tags:
- Market
summary: Get Daily Market Data
description: 'Get daily market data for a specific ticker
Returns OHLCV + VWAP data for the specified ticker and date range: the vendor feed, or
under PRICE_SOURCE=iex IEX''s daily close with split-adjusted adj_close (OHLV/VWAP absent).
`metadata.data_source` names which (core/price_source.py).'
operationId: get_daily_market_data_api_v1_market_daily__ticker__get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: ticker
in: path
required: true
schema:
type: string
pattern: ^[A-Z]{1,5}([.-][A-Z]{1,3})?$
description: Stock ticker symbol (share classes allowed, e.g. BRK-B)
title: Ticker
description: Stock ticker symbol (share classes allowed, e.g. BRK-B)
- name: start_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: Start date (YYYY-MM-DD)
title: Start Date
description: Start date (YYYY-MM-DD)
- name: end_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: End date (YYYY-MM-DD)
title: End Date
description: End date (YYYY-MM-DD)
- name: limit
in: query
required: false
schema:
type: integer
maximum: 2000
minimum: 1
description: Maximum records to return
default: 365
title: Limit
description: Maximum records to return
- 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/MarketDataResponse'
'404':
description: Ticker not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/market/summary/{ticker}:
get:
tags:
- Market
summary: Get Market Data Summary
description: 'Get summary statistics for market data
Returns aggregated statistics like min/max prices, average volume, etc.
for the specified ticker over the given number of days.'
operationId: get_market_data_summary_api_v1_market_summary__ticker__get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: ticker
in: path
required: true
schema:
type: string
pattern: ^[A-Z]{1,5}([.-][A-Z]{1,3})?$
description: Stock ticker symbol (share classes allowed, e.g. BRK-B)
title: Ticker
description: Stock ticker symbol (share classes allowed, e.g. BRK-B)
- name: days
in: query
required: false
schema:
type: integer
maximum: 3650
minimum: 1
description: Number of days to analyze
default: 365
title: Days
description: Number of days to analyze
- 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/MarketDataSummary'
'404':
description: Ticker not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/market/health:
get:
tags:
- Market
summary: Market Health Check
description: Health check endpoint for market data service
operationId: market_health_check_api_v1_market_health_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
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
MarketDataSummary:
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).
trading_days:
type: integer
title: Trading Days
description: Number of trading days with data
first_date:
anyOf:
- type: string
format: date
- type: 'null'
title: First Date
description: First available trading date
last_date:
anyOf:
- type: string
format: date
- type: 'null'
title: Last Date
description: Last available trading date
min_price:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Min Price
description: Lowest intraday low in the period, split-adjusted to the last bar's basis where the stored basis is known
max_price:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Max Price
description: Highest intraday high in the period, split-adjusted to the last bar's basis where the stored basis is known
avg_close:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Avg Close
description: Average close, split-adjusted to the last bar's basis where the stored basis is known
avg_volume:
anyOf:
- type: integer
minimum: 0.0
- type: 'null'
title: Avg Volume
description: Average volume, in shares of the last bar's basis where the stored basis is known
avg_vwap:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Avg Vwap
description: Average VWAP, split-adjusted to the last bar's basis where the stored basis is known
price_volatility:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Price Volatility
description: Std dev of the close split-adjusted to the last bar's basis where the stored basis is known
type: object
required:
- trading_days
title: MarketDataSummary
description: Summary statistics for market data
ErrorResponse:
properties:
error:
type: string
title: Error
description: Error message
details:
anyOf:
- type: string
- type: 'null'
title: Details
description: Additional error details
error_code:
anyOf:
- type: string
- type: 'null'
title: Error Code
description: Error code for client handling
type: object
required:
- error
title: ErrorResponse
description: Standard error response
example:
details: No market data available for ticker INVALID
error: Ticker not found
error_code: TICKER_NOT_FOUND
MarketDataResponse:
properties:
ticker:
type: string
title: Ticker
description: Stock ticker symbol
company_name:
anyOf:
- type: string
- type: 'null'
title: Company Name
description: Company name
requested_ticker:
anyOf:
- type: string
- type: 'null'
title: Requested Ticker
description: The ticker the caller asked for, when it was an alias
is_alias:
type: boolean
title: Is Alias
description: True when `ticker` was substituted for `requested_ticker`
default: false
request_start_date:
type: string
format: date
title: Request Start Date
description: Requested start date
request_end_date:
type: string
format: date
title: Request End Date
description: Requested end date
data_points:
items:
$ref: '#/components/schemas/MarketDataPoint'
type: array
title: Data Points
description: Daily market data points
summary:
$ref: '#/components/schemas/MarketDataSummary'
description: Summary statistics
shares_outstanding:
anyOf:
- $ref: '#/components/schemas/SharesOutstandingInfo'
- type: 'null'
description: Latest reported period-end share count <= request end date
market_cap_at_close:
anyOf:
- type: number
- type: 'null'
title: Market Cap At Close
description: Latest close in range x shares_outstanding.value (same share basis)
metadata:
additionalProperties: true
type: object
title: Metadata
description: Additional metadata
type: object
required:
- ticker
- request_start_date
- request_end_date
- data_points
- summary
title: MarketDataResponse
description: Complete market data response
MarketDataPoint:
properties:
trade_date:
type: string
format: date
title: Trade Date
description: Trading date
ticker:
type: string
title: Ticker
description: Stock ticker symbol
open:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Open
description: Opening price
high:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: High
description: Daily high price
low:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Low
description: Daily low price
close:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Close
description: Closing price (unadjusted)
adj_close:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Adj Close
description: Adjusted closing price
volume:
anyOf:
- type: integer
minimum: 0.0
- type: 'null'
title: Volume
description: Trading volume in shares
vwap:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Vwap
description: Volume-weighted average price
type: object
required:
- trade_date
- ticker
title: MarketDataPoint
description: Individual daily market data point
SharesOutstandingInfo:
properties:
value:
type: number
exclusiveMinimum: 0.0
title: Value
description: Shares outstanding (count)
as_of:
type: string
format: date
title: As Of
description: Reporting date of the share count (period end)
source:
type: string
title: Source
description: Basis of the count
default: period-end balance sheet (dei cover where absent)
type: object
required:
- value
- as_of
title: SharesOutstandingInfo
description: 'Latest reported period-end shares outstanding on or before the request end date.
Pairs the price-at-date surface with the share count every market-cap / EV /
P-B computation needs (q010/q012: agents improvised weighted-average counts
when this wasn''t on the same surface as the price).'
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