EODHD Eod API

openapi: 3.1.0
info:
  title: EODHD End-Of-Day Historical Data Eod API
  description: Access end-of-day historical OHLCV data for stocks, ETFs, funds, indices, and currencies across global exchanges. Returns daily, weekly, or monthly historical price and volume data with both raw and split/dividend-adjusted closing prices.
  version: '1.0'
  contact:
    name: EODHD Support
    url: https://eodhd.com/financial-apis/
  license:
    name: EODHD Terms of Service
    url: https://eodhd.com/financial-apis/terms-conditions
servers:
- url: https://eodhd.com/api
  description: EODHD production API
security:
- apiToken: []
tags:
- name: Eod
paths:
  /eod/{symbol}:
    get:
      summary: Retrieve end-of-day historical data
      description: Returns the end-of-day historical OHLCV time series for a given ticker symbol. The symbol must include the exchange suffix, for example AAPL.US or BMW.XETRA. One call per request regardless of date range.
      operationId: getEodHistoricalData
      parameters:
      - name: symbol
        in: path
        required: true
        description: Ticker symbol with exchange suffix, e.g. AAPL.US.
        schema:
          type: string
          example: AAPL.US
      - name: api_token
        in: query
        required: true
        description: API token assigned to your EODHD account.
        schema:
          type: string
      - name: fmt
        in: query
        required: false
        description: Response format. Defaults to csv.
        schema:
          type: string
          enum:
          - json
          - csv
          default: csv
      - name: period
        in: query
        required: false
        description: Aggregation period. d=daily, w=weekly, m=monthly.
        schema:
          type: string
          enum:
          - d
          - w
          - m
          default: d
      - name: order
        in: query
        required: false
        description: Sort order of returned rows. a=ascending, d=descending.
        schema:
          type: string
          enum:
          - a
          - d
          default: a
      - name: from
        in: query
        required: false
        description: Inclusive start date in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: to
        in: query
        required: false
        description: Inclusive end date in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: filter
        in: query
        required: false
        description: Return only a single field, e.g. last_close or last_volume.
        schema:
          type: string
      responses:
        '200':
          description: Historical OHLCV time series for the requested symbol.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EodBar'
            text/csv:
              schema:
                type: string
        '401':
          description: Missing or invalid api_token.
        '404':
          description: Unknown symbol or exchange.
        '429':
          description: Rate limit exceeded.
      tags:
      - Eod
components:
  schemas:
    EodBar:
      type: object
      properties:
        date:
          type: string
          format: date
          description: Trading date for this bar.
        open:
          type: number
          description: Opening price (raw, unadjusted).
        high:
          type: number
          description: Intraday high (raw, unadjusted).
        low:
          type: number
          description: Intraday low (raw, unadjusted).
        close:
          type: number
          description: Closing price (raw, unadjusted).
        adjusted_close:
          type: number
          description: Closing price adjusted for splits and dividends.
        volume:
          type: integer
          description: Volume adjusted for splits.
  securitySchemes:
    apiToken:
      type: apiKey
      in: query
      name: api_token