MetricDuck Market API

The market API from MetricDuck — 3 operation(s) for market.

GitHub OpenAPI

Operations 3

GET /api/v1/market/daily/{ticker} Get Daily Market Data #
GET /api/v1/market/summary/{ticker} Get Market Data Summary #
GET /api/v1/market/health Market Health Check #

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-market-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-market-api-openapi.yml Raw ↑
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