EOD Historical Data Screening API
Stock screening tools
OpenAPI Specification
openapi: 3.1.0
info:
title: EODHD Financial Data Calendar Screening API
description: Comprehensive API for retrieving financial data including stock prices, fundamentals, calendar events, news, and more from EOD Historical Data (eodhd.com)
version: 2.0.0
contact:
name: EODHD Support
url: https://eodhd.com
email: supportlevel1@eodhistoricaldata.com
termsOfService: https://eodhd.com/financial-apis/terms-conditions
license:
name: Proprietary
url: https://eodhd.com/financial-apis/terms-conditions
servers:
- url: https://eodhd.com/api
description: Primary API path
- url: https://eodhistoricaldata.com/api
description: Alternative API path
security:
- EODHDQueryKey: []
tags:
- name: Screening
description: Stock screening tools
paths:
/screener:
get:
summary: Get filtered stock data based on user-defined criteria.
description: Retrieves stock data filtered by criteria such as market capitalization, exchange, sector, and more. Results can be sorted and paginated.
operationId: GetStockScreenerData
parameters:
- name: api_token
in: query
required: true
description: Your API token for authentication.
schema:
type: string
- name: filters
in: query
required: false
description: Filters to apply, structured as nested arrays (e.g., [["field", "operation", value], ...]).
schema:
type: string
example: '[["market_capitalization",">",1000000000],["sector","=","Technology"]]'
- name: signals
in: query
required: false
description: Signals to filter tickers by pre-calculated fields (e.g., 200d_new_hi, bookvalue_pos).
schema:
type: string
example: 200d_new_hi,bookvalue_pos
- name: sort
in: query
required: false
description: Sorts results by a specified field in ascending or descending order (e.g., market_capitalization.desc).
schema:
type: string
example: market_capitalization.desc
- name: limit
in: query
required: false
description: Number of results per request. Minimum 1, maximum 500. Default is 50.
schema:
type: integer
minimum: 1
maximum: 500
default: 50
- name: offset
in: query
required: false
description: Data offset for paginating results. Minimum 0, maximum 999. Default is 0.
schema:
type: integer
minimum: 0
maximum: 999
default: 0
responses:
'200':
description: Successful response with filtered stock data.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
code:
type: string
description: Ticker symbol.
name:
type: string
description: Company name.
last_day_data_date:
type: string
format: date
description: Date of the latest data.
adjusted_close:
type: number
description: Latest adjusted close price.
refund_1d:
type: number
description: Refund value for the last day.
refund_1d_p:
type: number
description: Refund percentage change for the last day.
refund_5d:
type: number
description: Refund value for the last 5 days.
refund_5d_p:
type: number
description: Refund percentage change for the last 5 days.
exchange:
type: string
description: Exchange code.
currency_symbol:
type: string
description: Currency symbol.
market_capitalization:
type: integer
description: Market capitalization in USD.
earnings_share:
type: number
description: Earnings per share (EPS).
dividend_yield:
type: number
description: Dividend yield percentage.
sector:
type: string
description: Company sector.
industry:
type: string
description: Company industry.
avgvol_1d:
type: integer
description: Average daily volume for the last day.
avgvol_200d:
type: number
description: Average daily volume over the last 200 days.
example:
data:
- code: AAPL
name: Apple Inc
last_day_data_date: '2024-10-25'
adjusted_close: 231.41
refund_1d: 0.84
refund_1d_p: 0.36
refund_5d: -3.59
refund_5d_p: -1.53
exchange: US
currency_symbol: $
market_capitalization: 3518380900352
earnings_share: 6.6
dividend_yield: 0.0043
sector: Technology
industry: Consumer Electronics
avgvol_1d: 38776700
avgvol_200d: 59597856
- code: NVDA
name: NVIDIA Corporation
last_day_data_date: '2024-10-25'
adjusted_close: 141.54
refund_1d: 1.13
refund_1d_p: 0.8
refund_5d: 3.54
refund_5d_p: 2.57
exchange: US
currency_symbol: $
market_capitalization: 3471975907328
earnings_share: 2.15
dividend_yield: 0.0003
sector: Technology
industry: Semiconductors
avgvol_1d: 205122109
avgvol_200d: 411629851.58
'400':
description: Invalid request parameters.
'401':
description: Unauthorized.
tags:
- Screening
/search/{query}:
get:
summary: Search stocks, companies, and ISINs
description: Search for stocks, companies, or ISINs by a query (e.g., company name, stock symbol, or ISIN)
operationId: SearchStocksByQuery
parameters:
- name: query
in: path
required: true
description: The search query (e.g., 'AAPL', 'Amazon', or ISIN 'US3453708600')
schema:
type: string
- name: api_token
in: query
required: true
description: API token for authentication
schema:
type: string
- name: fmt
in: query
required: false
description: Response format (e.g., 'json')
schema:
type: string
enum:
- json
- xml
- name: limit
in: query
required: false
description: Limit the number of results returned
schema:
type: integer
example: 1
- name: type
in: query
required: false
description: Filter by security type.
schema:
type: string
enum:
- all
- stock
- etf
- fund
- bond
- index
- crypto
- name: exchange
in: query
required: false
description: Filter by exchange code (e.g., 'US', 'LSE').
schema:
type: string
- name: bonds_only
in: query
required: false
description: Set to 1 to return bonds only.
schema:
type: integer
enum:
- 0
- 1
responses:
'200':
description: Successful response with search results
content:
application/json:
schema:
type: array
items:
type: object
properties:
Code:
type: string
Exchange:
type: string
Name:
type: string
Type:
type: string
Country:
type: string
Currency:
type: string
ISIN:
type:
- string
- 'null'
previousClose:
type: number
previousCloseDate:
type: string
format: date
example:
- Code: AAPL
Exchange: US
Name: Apple Inc
Type: Common Stock
Country: USA
Currency: USD
ISIN: US0378331005
previousClose: 230.76
previousCloseDate: '2024-10-23'
- Code: AMZN
Exchange: US
Name: Amazon.com Inc
Type: Common Stock
Country: USA
Currency: USD
ISIN: US0231351067
previousClose: 184.71
previousCloseDate: '2024-10-23'
'400':
description: Invalid request parameters
'401':
description: Unauthorized
'404':
description: No results found
tags:
- Screening
components:
securitySchemes:
EODHDQueryKey:
type: apiKey
in: query
name: api_token
description: EODHD API key (stored as a secret in ChatGPT).