API docs by Redocly

EODHD Financial Data API (2.0.0)

Download OpenAPI specification:

EODHD Support: supportlevel1@eodhistoricaldata.com URL: https://eodhd.com License: Proprietary Terms of Service

Comprehensive API for retrieving financial data including stock prices, fundamentals, calendar events, news, and more from EOD Historical Data (eodhd.com)

Calendar

Calendar events including earnings, IPOs, splits, dividends, and trends

Retrieve upcoming dividends calendar

Look up upcoming and historical dividend events.

Uses the JSON:API filter/page convention. At least one of filter[date_eq] or filter[symbol] is required — a request without either will return HTTP 422.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

Your API token for accessing the API.

filter[date_eq]
string <date>

Exact date in 'YYYY-MM-DD' format. Required if filter[symbol] is not present.

filter[date_from]
string <date>

Start date in 'YYYY-MM-DD' format.

filter[date_to]
string <date>

End date in 'YYYY-MM-DD' format.

filter[symbol]
string

Ticker symbol (e.g., 'AAPL.US'). When provided, filter[date_eq] may be omitted.

page[limit]
integer [ 1 .. 10000 ]

Number of records per page (1-10000).

page[offset]
integer [ 0 .. 1000000 ]

Pagination offset (0-1000000).

fmt
string
Default: "json"
Enum: "csv" "json"

Output format. Defaults to 'json'.

Responses

Response samples

Content type
application/json
{}

Retrieve upcoming earnings data

Fetches upcoming earnings data, with optional parameters for date ranges and specific symbols.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

Your API token for accessing the API.

from
string <date>

Start date for earnings data, in 'YYYY-MM-DD' format. Defaults to today if not provided.

to
string <date>

End date for earnings data, in 'YYYY-MM-DD' format. Defaults to 7 days from today if not provided.

symbols
string

Specific symbols to retrieve earnings data for, separated by commas (e.g., 'AAPL.US,MSFT.US'). Overrides the 'from' and 'to' parameters if used.

fmt
string
Default: "csv"
Enum: "csv" "json"

Output format, either 'csv' or 'json'. Defaults to 'csv'.

Responses

Response samples

Content type
application/json
{
  • "type": "Earnings",
  • "description": "Historical and upcoming Earnings",
  • "from": "2018-12-02",
  • "to": "2018-12-05",
  • "earnings": [
    ]
}

Retrieve upcoming IPO data

Fetches historical and upcoming IPOs for specified date ranges.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

Your API key for authentication.

from
string <date>

Start date for IPO data in 'YYYY-MM-DD' format. Defaults to today if not provided.

to
string <date>

End date for IPO data in 'YYYY-MM-DD' format. Defaults to 7 days from today if not provided.

fmt
string
Default: "csv"
Enum: "csv" "json"

Output format. Possible values: 'csv' for CSV and 'json' for JSON. Defaults to 'csv'.

Responses

Response samples

Content type
application/json
{
  • "type": "IPOs",
  • "description": "Historical and upcoming IPOs",
  • "from": "2018-12-02",
  • "to": "2018-12-06",
  • "ipos": [
    ]
}

Retrieve upcoming and historical stock splits

Fetches information on stock splits for specified date ranges.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

Your API key for authentication.

from
string <date>

Start date for split data in 'YYYY-MM-DD' format. Defaults to today if not provided.

to
string <date>

End date for split data in 'YYYY-MM-DD' format. Defaults to 7 days from today if not provided.

fmt
string
Default: "csv"
Enum: "csv" "json"

Output format, either 'csv' or 'json'. Default is 'csv'.

Responses

Response samples

Content type
application/json
{
  • "type": "Splits",
  • "description": "Historical and upcoming splits",
  • "from": "2018-12-02",
  • "to": "2018-12-06",
  • "splits": [
    ]
}

Retrieve earnings trends data

Fetches historical and upcoming earnings trends, including EPS and revenue estimates, trends, and revisions for specific stock symbols.

Authorizations:
EODHDQueryKey
query Parameters
symbols
required
string

Comma-separated list of stock symbols to retrieve trends data for (e.g., 'AAPL.US,MSFT.US').

api_token
required
string

Your API key for authentication.

fmt
string
Default: "json"
Value: "json"

Output format. Currently supports only 'json'.

Responses

Response samples

Content type
application/json
{
  • "type": "Trends",
  • "description": "Historical and upcoming earning trends",
  • "symbols": "AAPL.US",
  • "trends": [
    ]
}

End-of-Day Data

Historical and current end-of-day price data

Retrieve end-of-day historical price data

Retrieve end-of-day historical data for a specific company by its ticker symbol, with optional filters for specific data points.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol of the company

query Parameters
api_token
required
string

API token for authentication

fmt
string
Enum: "json" "csv"

Response format (e.g., 'json')

from
string <date>

Start date for historical data (YYYY-MM-DD)

to
string <date>

End date for historical data (YYYY-MM-DD)

period
string
Enum: "d" "w" "m"

Data period (e.g., 'd' for daily, 'w' for weekly, 'm' for monthly)

filter
string
Enum: "last_date" "last_open" "last_high" "last_low" "last_close" "last_volume"

Filter for specific last known data points

Responses

Response samples

Content type
application/json
Example
[
  • {
    },
  • {
    }
]

Retrieve bulk EOD, splits, or dividends data

Retrieve bulk end-of-day data, splits, or dividends for an entire exchange or specific tickers, with an option for extended data.

Authorizations:
EODHDQueryKey
path Parameters
exchange
required
string

Exchange symbol (e.g., 'VI' for Vienna or 'US' for the U.S.).

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Enum: "json" "csv"

Response format ('json' or 'csv').

type
string
Default: "eod"
Enum: "eod" "splits" "dividends"

Data type ('eod' for end-of-day data, 'splits' for stock splits, 'dividends' for dividend information).

date
string <date>

Specific date for historical data (YYYY-MM-DD). Defaults to the last trading day.

symbols
string

Comma-separated list of specific tickers to retrieve data for (e.g., 'MSFT,AAPL'). Only available for EOD data.

filter
string
Value: "extended"

Extended filter for additional data such as company name, EMA, etc. Only available in JSON format.

Responses

Response samples

Content type
application/json
Example
[
  • {
    }
]

Intraday Data

Real-time and intraday price data

Retrieve intraday historical price data

Retrieve intraday historical stock data for a specific ticker.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol with exchange code (e.g., 'AAPL.US').

query Parameters
api_token
required
string

API token for authentication.

interval
required
string
Enum: "1m" "5m" "15m" "30m" "1h"

Interval for data points. Options are '1m' (1 minute), '5m' (5 minutes), '15m' (15 minutes), '30m' (30 minutes), and '1h' (1 hour).

fmt
string
Enum: "json" "csv"

Response format. Defaults to CSV if not specified. Options are 'json' and 'csv'.

from
integer

Start datetime in Unix timestamp (UTC). For example, 1627896900 for '2021-08-02 09:35:00'.

to
integer

End datetime in Unix timestamp (UTC). For example, 1630575300 for '2021-09-02 09:35:00'.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Retrieve marketplace tick data

Get tick-level data via the UnicornBay marketplace data provider. Returns granular trade-by-trade data for supported symbols.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

s
required
string

Ticker symbol (e.g., 'AAPL' or 'AAPL.US').

from
integer <int64>

Start UNIX timestamp (UTC).

to
integer <int64>

End UNIX timestamp (UTC).

limit
integer

Maximum number of ticks to return.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve delayed real-time stock prices

Retrieve live (delayed) stock prices for specified ticker(s).

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol with exchange code (e.g., 'AAPL.US').

query Parameters
s
string

Comma-separated list of additional ticker symbols for multiple requests in a single call (e.g., 'VTI,EUR.FOREX').

api_token
required
string

API token for authentication.

ex
string

Exchange code filter (e.g., 'US').

fmt
string
Enum: "json" "csv"

Response format. Options are 'json' and 'csv'. Defaults to JSON.

Responses

Response samples

Content type
application/json
Example
{
  • "code": "AAPL.US",
  • "timestamp": 1729888080,
  • "gmtoffset": 0,
  • "open": 229.74,
  • "high": 233.22,
  • "low": 229.57,
  • "close": 231.41,
  • "volume": 37931706,
  • "previousClose": 230.57,
  • "change": 0.84,
  • "change_p": 0.3643
}

Retrieve historical tick data

Get historical stock tick data for US equities using UNIX time for filtering. Limited to US exchanges.

Authorizations:
EODHDQueryKey
query Parameters
s
required
string

Ticker symbol (e.g., 'AAPL' or 'AAPL.US' for US-listed stocks).

api_token
required
string

API key for authentication

from
integer <int64>

Start UNIX timestamp (UTC) for filtering data.

to
integer <int64>

End UNIX timestamp (UTC) for filtering data.

limit
integer

Maximum number of ticks to return.

fmt
string
Default: "json"
Value: "json"

Output format (only 'json' supported)

Responses

Response samples

Content type
application/json
{
  • "ex": [
    ],
  • "mkt": [
    ],
  • "price": [
    ],
  • "seq": [
    ],
  • "shares": [
    ],
  • "sl": [
    ],
  • "sub_mkt": [
    ],
  • "ts": [
    ]
}

Get US delayed stock quotes

Returns 15-minute delayed quote data for US equities. Supports multiple symbols in a single request.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

Your API token for authentication.

s
required
string

Comma-separated ticker symbols (e.g., 'AAPL,MSFT,GOOGL').

fields
string

Comma-separated list of fields to return (e.g., 'close,volume,change_p').

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Fundamentals

Fundamental data for stocks and companies

Retrieve bulk fundamental data for an exchange

Fetches fundamental data in bulk for all symbols on a given exchange. Supports filtering by specific symbols and data sections (General, Highlights, Valuation, etc.).

Authorizations:
EODHDQueryKey
path Parameters
EXCHANGE
required
string

Exchange code (e.g., 'US', 'LSE', 'TO').

query Parameters
api_token
required
string

Your API token for authentication.

symbols
string

Comma-separated list of symbols to filter (e.g., 'AAPL,MSFT,GOOGL').

offset
integer
Default: 0

Offset for pagination (number of records to skip).

limit
integer
Default: 500

Maximum number of records to return (max 500).

version
integer

API version for response format.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve filtered fundamental data for a specific symbol

Fetches various sections of fundamental data for a given stock symbol. Use filters to specify the data section and sub-sections, such as Financials::Balance_Sheet::quarterly::2024-06-30 for quarterly Balance Sheet data.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

The ticker symbol in the format SYMBOL.EXCHANGE, e.g., 'AAPL.US' for Apple Inc. on NASDAQ.

query Parameters
api_token
required
string
Example: api_token=demo

Your API token for authentication. Use 'demo' for limited access with specific symbols.

filter
string
Example: filter=Financials::Income_Statement::annual::2023-12-31

Filter parameter to specify data section and optional sub-sections, e.g., Financials::Balance_Sheet::quarterly::2024-06-30. Supported sections include General, Highlights, Valuation, SharesStats, Technicals, SplitsDividends, AnalystRatings, Holders, InsiderTransactions, ESGScores, outstandingShares, Earnings, and Financials. When omitted, returns all sections.

historical
integer
Enum: 0 1

Set to 1 to return historical data for certain sections (e.g., outstandingShares).

from
string <date>

Start date for historical data in 'YYYY-MM-DD' format.

to
string <date>

End date for historical data in 'YYYY-MM-DD' format.

version
integer

API version for response format.

no_cache
integer
Enum: 0 1

Set to 1 to bypass cache and get fresh data.

Responses

Response samples

Content type
application/json
{
  • "General": {
    },
  • "Highlights": {
    },
  • "Valuation": {
    },
  • "SharesStats": {
    },
  • "Technicals": {
    },
  • "SplitsDividends": {
    },
  • "AnalystRatings": {
    },
  • "Holders": {
    },
  • "InsiderTransactions": [
    ],
  • "ESGScores": {
    },
  • "outstandingShares": {
    },
  • "Earnings": {
    },
  • "Financials": {
    }
}

Retrieve bulk fundamental data for an exchange (v1.1)

Fetches fundamental data in bulk for all symbols on a given exchange using API v1.1. Supports filtering by specific symbols and data sections (General, Highlights, Valuation, etc.). In v1.1, the fmt parameter only supports json format.

Authorizations:
EODHDQueryKey
path Parameters
EXCHANGE
required
string

Exchange code (e.g., 'US', 'LSE', 'TO').

query Parameters
api_token
required
string

Your API token for authentication.

symbols
string

Comma-separated list of symbols to filter (e.g., 'AAPL,MSFT,GOOGL').

offset
integer
Default: 0

Offset for pagination (number of records to skip).

limit
integer
Default: 500

Maximum number of records to return (max 500).

version
integer

API version for response format.

fmt
string
Default: "json"
Value: "json"

Output format. In v1.1, only json format is supported.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve filtered fundamental data for a specific symbol (v1.1)

Fetches various sections of fundamental data for a given stock symbol using API v1.1. This version differs from v1 in the Earnings Trend section, which is split into Quarterly and Annual sub-objects with an additional "quarter" field on quarterly items. Use filters to specify the data section and sub-sections, such as Financials::Balance_Sheet::quarterly::2024-06-30 for quarterly Balance Sheet data.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

The ticker symbol in the format SYMBOL.EXCHANGE, e.g., 'AAPL.US' for Apple Inc. on NASDAQ.

query Parameters
api_token
required
string
Example: api_token=demo

Your API token for authentication. Use 'demo' for limited access with specific symbols.

filter
string
Example: filter=Financials::Income_Statement::annual::2023-12-31

Filter parameter to specify data section and optional sub-sections, e.g., Financials::Balance_Sheet::quarterly::2024-06-30. Supported sections include General, Highlights, Valuation, SharesStats, Technicals, SplitsDividends, AnalystRatings, Holders, InsiderTransactions, ESGScores, outstandingShares, Earnings, and Financials. When omitted, returns all sections.

historical
integer
Enum: 0 1

Set to 1 to return historical data for certain sections (e.g., outstandingShares).

from
string <date>

Start date for historical data in 'YYYY-MM-DD' format.

to
string <date>

End date for historical data in 'YYYY-MM-DD' format.

version
integer

API version for response format.

no_cache
integer
Enum: 0 1

Set to 1 to bypass cache and get fresh data.

Responses

Response samples

Content type
application/json
{
  • "General": {
    },
  • "Highlights": {
    },
  • "Valuation": {
    },
  • "SharesStats": {
    },
  • "Technicals": {
    },
  • "SplitsDividends": {
    },
  • "AnalystRatings": {
    },
  • "Holders": {
    },
  • "InsiderTransactions": [
    ],
  • "ESGScores": {
    },
  • "outstandingShares": {
    },
  • "Earnings": {
    },
  • "Financials": {
    }
}

Exchanges

Exchange information and symbols

Retrieve details for a specific exchange

Retrieve exchange details, trading hours, holidays, and active tickers for a specified exchange.

Authorizations:
EODHDQueryKey
path Parameters
EXCHANGE_CODE
required
string

Exchange code for which details are to be retrieved (e.g., 'US' for the USA exchange).

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Enum: "json" "csv"

Response format. Options are 'json' and 'csv'. Defaults to JSON.

from
string <date>

Start date for holiday data (YYYY-MM-DD). Defaults to 6 months before the current date.

to
string <date>

End date for holiday data (YYYY-MM-DD). Defaults to 6 months after the current date.

format_version
integer

Response format version.

Responses

Response samples

Content type
application/json
{
  • "Name": "USA Stocks",
  • "Code": "US",
  • "OperatingMIC": "XNAS, XNYS, OTCM",
  • "Country": "USA",
  • "Currency": "USD",
  • "Timezone": "America/New_York",
  • "ExchangeHolidays": [
    ],
  • "ExchangeEarlyCloseDays": [ ],
  • "isOpen": false,
  • "TradingHours": {
    },
  • "ActiveTickers": 49242,
  • "PreviousDayUpdatedTickers": 47442,
  • "UpdatedTickers": 0
}

Retrieve the list of tickers for a specific exchange.

Returns a list of active or delisted symbols for the specified exchange, with optional filters by ticker type.

Authorizations:
EODHDQueryKey
path Parameters
exchangeCode
required
string

Exchange code, e.g., 'PSE' for the Philippines Stock Exchange or 'US' for combined US exchanges.

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Enum: "json" "csv"

Response format. Options: 'json' (default) or 'csv'.

delisted
integer
Default: 0
Enum: 0 1

Include delisted (inactive) tickers. Set to '1' to include.

type
string
Enum: "common_stock" "preferred_stock" "stock" "etf" "fund"

Filter by ticker type. Options: 'common_stock', 'preferred_stock', 'stock', 'etf', 'fund'.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

List supported exchanges

Retrieve the list of supported exchanges with their details.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

fmt
string
Enum: "json" "csv"

Response format. Options are 'json' and 'csv'. Defaults to JSON.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Map between financial identifiers

Look up securities by various identifiers including symbol, exchange code, ISIN, FIGI, LEI, CUSIP, and CIK.

At least one of the following filter parameters is required: filter[symbol], filter[isin], filter[figi], filter[lei], filter[cusip], filter[cik], or filter[ex]. A request without any of these will return HTTP 422.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

filter[symbol]
string

Filter by ticker symbol (e.g., 'AAPL').

filter[ex]
string

Filter by exchange code (e.g., 'US').

filter[isin]
string

Filter by ISIN code (e.g., 'US0378331005').

filter[figi]
string

Filter by FIGI identifier.

filter[lei]
string

Filter by LEI code.

filter[cusip]
string

Filter by CUSIP identifier.

filter[cik]
string

Filter by CIK number.

page[limit]
integer

Number of records per page.

page[offset]
integer

Pagination offset.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Economic Data

Economic events and macro indicators

Get historical commodity prices

Returns historical price data for a specific commodity by its code (e.g., WTI, BRENT, NATURAL_GAS).

Authorizations:
EODHDQueryKey
path Parameters
code
required
string

Commodity code (e.g., 'WTI', 'BRENT', 'NATURAL_GAS', 'GOLD', 'SILVER', 'COPPER', 'PLATINUM', 'PALLADIUM', 'WHEAT', 'CORN', 'SOYBEANS', 'RICE', 'SUGAR', 'COFFEE', 'COTTON', 'COCOA', 'OATS', 'LUMBER', 'RUBBER', 'ETHANOL', 'PROPANE', 'URANIUM', 'COAL').

query Parameters
api_token
required
string

API token for authentication.

interval
string
Default: "daily"
Enum: "daily" "weekly" "monthly"

Data interval — 'daily' (default), 'weekly', or 'monthly'.

from
string <date>

Start date in 'YYYY-MM-DD' format.

to
string <date>

End date in 'YYYY-MM-DD' format.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve economic events data

Fetches economic events by date range, country, comparison type, and other optional parameters.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

Your API key for authentication.

from
string <date>

Start date for data retrieval in 'YYYY-MM-DD' format.

to
string <date>

End date for data retrieval in 'YYYY-MM-DD' format.

country
string = 2 characters

Country code in ISO 3166-1 alpha-2 format, e.g., 'US' for the United States.

comparison
string
Enum: "mom" "qoq" "yoy"

Comparison type, e.g., 'mom' for month-over-month, 'qoq' for quarter-over-quarter, 'yoy' for year-over-year.

offset
integer [ 0 .. 1000 ]
Default: 0

Data offset, from 0 to 1000. Default is 0.

limit
integer [ 0 .. 1000 ]
Default: 50

Number of results to return, from 0 to 1000. Default is 50.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Retrieve macroeconomic indicators for a specific country

Fetches macroeconomic data for a selected indicator, such as GDP or inflation, by country code.

Authorizations:
EODHDQueryKey
path Parameters
country
required
string

Country code in ISO Alpha-3 format (e.g., 'USA' for United States, 'FRA' for France).

query Parameters
api_token
required
string

Your API token for authentication.

indicator
string
Default: "gdp_current_usd"
Enum: "real_interest_rate" "population_total" "population_growth_annual" "inflation_consumer_prices_annual" "consumer_price_index" "gdp_current_usd" "gdp_per_capita_usd" "gdp_growth_annual" "debt_percent_gdp" "net_trades_goods_services" "inflation_gdp_deflator_annual" "agriculture_value_added_percent_gdp" "industry_value_added_percent_gdp" "services_value_added_percent_gdp" "exports_of_goods_services_percent_gdp" "imports_of_goods_services_percent_gdp" "gross_capital_formation_percent_gdp" "net_migration" "gni_usd" "gni_per_capita_usd" "gni_ppp_usd" "gni_per_capita_ppp_usd" "income_share_lowest_twenty" "life_expectancy" "fertility_rate" "prevalence_hiv_total" "co2_emissions_tons_per_capita" "surface_area_km" "poverty_poverty_lines_percent_population" "revenue_excluding_grants_percent_gdp" "cash_surplus_deficit_percent_gdp" "startup_procedures_register" "market_cap_domestic_companies_percent_gdp" "mobile_subscriptions_per_hundred" "internet_users_per_hundred" "high_technology_exports_percent_total" "merchandise_trade_percent_gdp" "total_debt_service_percent_gni" "unemployment_total_percent"

The macroeconomic indicator to retrieve. Default is 'gdp_current_usd'.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format: 'json' or 'csv'. Default is 'json'.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Options

Options contracts and pricing data

Get options contracts

Fetch options contracts filtered by underlying symbol, expiration, strike, type, or contract name. Supports sorting, pagination, and field selection.

Authorizations:
EODHDQueryKey
query Parameters
filter[contract]
string

Exact contract name, e.g., AAPL270115P00450000

filter[underlying_symbol]
string

Underlying symbol, e.g., AAPL

filter[exp_date_eq]
string

Expiration equals (YYYY-MM-DD)

filter[exp_date_from]
string

Expiration from (YYYY-MM-DD)

filter[exp_date_to]
string

Expiration to (YYYY-MM-DD)

filter[tradetime_eq]
string

Trade time equals (YYYY-MM-DD)

filter[tradetime_from]
string

Trade time from (YYYY-MM-DD)

filter[tradetime_to]
string

Trade time to (YYYY-MM-DD)

filter[type]
string
Enum: "put" "call"

Option type

filter[strike_eq]
number

Strike equals

filter[strike_from]
number

Strike from

filter[strike_to]
number

Strike to

sort
string
Enum: "exp_date" "strike" "-exp_date" "-strike"

Sort by expiration date or strike (asc/desc).

page[offset]
integer [ 0 .. 10000 ]
Default: 0

Pagination offset (records to skip). Max 10000.

page[limit]
integer [ 1 .. 1000 ]
Default: 1000

Pagination limit. Default & max 1000.

fields[options-contracts]
string

CSV of fields to include (e.g., contract,exp_date,strike).

fmt
string
Default: "json"
Enum: "json" "xml"

Response format.

api_token
required
string

API token for authentication.

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "data": [
    ],
  • "links": {}
}

Get end-of-day options data

Returns EOD trades/bid data for options, with the same filter set as contracts. Supports compact mode (compact=1) to return arrays instead of objects.

Authorizations:
EODHDQueryKey
query Parameters
filter[contract]
string

Exact contract name, e.g., AAPL270115P00450000

filter[underlying_symbol]
string

Underlying symbol, e.g., AAPL

filter[exp_date_eq]
string

Expiration equals (YYYY-MM-DD)

filter[exp_date_from]
string

Expiration from (YYYY-MM-DD)

filter[exp_date_to]
string

Expiration to (YYYY-MM-DD)

filter[tradetime_eq]
string

Trade time equals (YYYY-MM-DD)

filter[tradetime_from]
string

Trade time from (YYYY-MM-DD)

filter[tradetime_to]
string

Trade time to (YYYY-MM-DD)

filter[type]
string
Enum: "put" "call"

Option type

filter[strike_eq]
number

Strike equals

filter[strike_from]
number

Strike from

filter[strike_to]
number

Strike to

sort
string
Enum: "exp_date" "strike" "-exp_date" "-strike"

Sort by expiration date or strike (asc/desc).

page[offset]
integer [ 0 .. 10000 ]
Default: 0

Pagination offset (records to skip). Max 10000.

page[limit]
integer [ 1 .. 1000 ]
Default: 1000

Pagination limit. Default & max 1000.

fields[options-eod]
string

CSV of fields to include (e.g., contract,exp_date,strike).

compact
integer
Default: 0
Enum: 0 1

Set 1 for compact mode (rows as arrays in data, columns = meta.fields).

fmt
string
Default: "json"
Enum: "json" "xml"

Response format.

api_token
required
string

API token for authentication.

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "data": [
    ],
  • "links": {}
}

List underlying symbols with options

Returns the list of all supported stock symbols for which option contracts are available. May be paginated.

Authorizations:
EODHDQueryKey
query Parameters
page[offset]
integer [ 0 .. 10000 ]
Default: 0

Pagination offset (records to skip).

page[limit]
integer [ 1 .. 1000 ]
Default: 1000

Pagination limit. Default & max 1000.

fmt
string
Default: "json"
Enum: "json" "xml"

Response format.

api_token
required
string

API token for authentication.

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "data": [
    ],
  • "links": {
    }
}

News

Financial news and sentiment analysis

Retrieve financial news articles

Retrieve financial news articles for a specific company ticker or topic

Authorizations:
EODHDQueryKey
query Parameters
s
string

Ticker code to get news for (e.g., 'AAPL.US'). Required if 't' is not provided.

t
string

Tag to get news on a given topic. Required if 's' is not provided.

api_token
required
string

API token for authentication

from
string <date>

Start date for news data (YYYY-MM-DD)

to
string <date>

End date for news data (YYYY-MM-DD)

limit
integer [ 1 .. 1000 ]
Default: 50

The number of results to return

offset
integer >= 0
Default: 0

The offset of the data

fmt
string
Value: "json"

Response format (e.g., 'json')

Responses

Response samples

Content type
application/json
[]

Top weighted news keywords for a ticker

Returns the most relevant words from financial news for the given ticker and period, with weights (frequency ? significance).

Authorizations:
EODHDQueryKey
query Parameters
s
required
string

Ticker to analyze, e.g., AAPL or AAPL.US

filter[date_from]
string <date>

Start date (YYYY-MM-DD)

filter[date_to]
string <date>

End date (YYYY-MM-DD). Prefer this over the legacy alias filter[to].

filter[to]
string <date>
Deprecated

Deprecated alias for filter[date_to] (YYYY-MM-DD). Use only one of these parameters.

page[limit]
integer [ 1 .. 500 ]
Default: 10

Number of top words to return

fmt
string
Default: "json"
Enum: "json" "xml"

Response format

api_token
required
string

API token for authentication.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": {
    },
  • "links": {
    }
}

Retrieve market news sentiment data

Retrieve sentiment analysis for financial news related to specified tickers.

Authorizations:
EODHDQueryKey
query Parameters
s
required
string

Comma-separated list of ticker codes to retrieve sentiment data for (e.g., 'btc-usd.cc,aapl.us').

api_token
required
string

API token for authentication.

from
string <date>

Start date for sentiment data (YYYY-MM-DD).

to
string <date>

End date for sentiment data (YYYY-MM-DD).

fmt
string
Value: "json"

Response format (only 'json' is supported).

Responses

Response samples

Content type
application/json
{
  • "ticker": {
    }
}

Technical

Technical analysis indicators

Retrieve technical indicator data for a specified symbol.

Fetches technical indicator data, such as moving averages and other analytics, based on specified parameters.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Symbol in the format {SYMBOL_NAME}.{EXCHANGE_ID}, e.g., AAPL.US for Apple Inc.

query Parameters
api_token
required
string

Your API token for authentication.

function
required
string
Enum: "sma" "ema" "wma" "volatility" "stochastic" "rsi" "stddev" "stochrsi" "slope" "dmi" "adx" "macd" "atr" "cci" "sar" "beta" "bbands" "splitadjusted" "avgvol" "avgvolccy"

The function to calculate the technical indicator (e.g., 'sma' for Simple Moving Average).

period
integer [ 2 .. 100000 ]
Default: 50

Number of data points used to calculate the indicator. Default is 50.

from
string <date>

Start date for data retrieval in 'YYYY-MM-DD' format.

to
string <date>

End date for data retrieval in 'YYYY-MM-DD' format.

order
string
Default: "a"
Enum: "a" "d"

Sort order of dates: 'a' for ascending, 'd' for descending. Default is ascending.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format, either 'json' or 'csv'. Default is 'json'.

splitadjusted_only
integer
Default: 0
Enum: 0 1

For select functions, adjust data only for splits by setting to '1'. Default is '0'.

filter
string

Retrieve only the last value by specifying 'last_ema' or 'last_volume' as the filter.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Screening

Stock screening tools

Get filtered stock data based on user-defined criteria.

Retrieves stock data filtered by criteria such as market capitalization, exchange, sector, and more. Results can be sorted and paginated.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

Your API token for authentication.

filters
string
Example: filters=[["market_capitalization",">",1000000000],["sector","=","Technology"]]

Filters to apply, structured as nested arrays (e.g., [["field", "operation", value], ...]).

signals
string
Example: signals=200d_new_hi,bookvalue_pos

Signals to filter tickers by pre-calculated fields (e.g., 200d_new_hi, bookvalue_pos).

sort
string
Example: sort=market_capitalization.desc

Sorts results by a specified field in ascending or descending order (e.g., market_capitalization.desc).

limit
integer [ 1 .. 500 ]
Default: 50

Number of results per request. Minimum 1, maximum 500. Default is 50.

offset
integer [ 0 .. 999 ]
Default: 0

Data offset for paginating results. Minimum 0, maximum 999. Default is 0.

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Search stocks, companies, and ISINs

Search for stocks, companies, or ISINs by a query (e.g., company name, stock symbol, or ISIN)

Authorizations:
EODHDQueryKey
path Parameters
query
required
string

The search query (e.g., 'AAPL', 'Amazon', or ISIN 'US3453708600')

query Parameters
api_token
required
string

API token for authentication

fmt
string
Enum: "json" "xml"

Response format (e.g., 'json')

limit
integer
Example: limit=1

Limit the number of results returned

type
string
Enum: "all" "stock" "etf" "fund" "bond" "index" "crypto"

Filter by security type.

exchange
string

Filter by exchange code (e.g., 'US', 'LSE').

bonds_only
integer
Enum: 0 1

Set to 1 to return bonds only.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Dividends & Splits

Dividend and split history

Retrieve historical dividend data

Fetches historical dividend data for a specified stock symbol, including key dividend dates and values.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol of the stock in the format {SYMBOL_NAME}.{EXCHANGE_ID} (e.g., 'AAPL.US' for NASDAQ or 'AAPL.MX' for the Mexican Stock Exchange).

query Parameters
api_token
required
string

Your API key for authentication.

from
string <date>

Start date for data retrieval in 'YYYY-MM-DD' format. Defaults to earliest available data if not provided.

to
string <date>

End date for data retrieval in 'YYYY-MM-DD' format. Defaults to latest available data if not provided.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format, either 'json' or 'csv'. Defaults to 'json'.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Retrieve historical split data

Fetches historical stock split data for a specified ticker, including split dates and ratios.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol of the stock in the format {SYMBOL_NAME}.{EXCHANGE_ID} (e.g., 'AAPL.US' for NASDAQ or 'AAPL.MX' for the Mexican Stock Exchange).

query Parameters
api_token
required
string

Your API key for authentication.

from
string <date>

Start date for data retrieval in 'YYYY-MM-DD' format. Defaults to earliest available data if not provided.

to
string <date>

End date for data retrieval in 'YYYY-MM-DD' format. Defaults to latest available data if not provided.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format, either 'json' or 'csv'. Defaults to 'json'.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Corporate Actions

Symbol changes and insider transactions

Retrieve insider transaction data

Fetch insider transaction data for US-listed companies. Covers insider buys and sells, providing transaction details such as date, shares, and price.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication

limit
integer [ 1 .. 1000 ]
Default: 100

Max number of entries per result, from 1 to 1000. Default is 100.

from
string <date>

Start date for transactions (format: YYYY-MM-DD). Defaults to one year before current date.

to
string <date>

End date for transactions (format: YYYY-MM-DD). Defaults to current date.

code
string

Ticker symbol for filtering results (e.g., 'AAPL.US'). If omitted, returns data for all symbols.

fmt
string
Default: "json"
Value: "json"

Output format (only 'json' supported).

Responses

Response samples

Content type
application/json
[
  • {}
]

Retrieve symbol change history

Retrieve the symbol change history within a specified date range. Only US exchanges are currently supported.

Authorizations:
EODHDQueryKey
query Parameters
from
required
string <date>

Start date for symbol change history in 'YYYY-MM-DD' format.

to
required
string <date>

End date for symbol change history in 'YYYY-MM-DD' format.

api_token
required
string

API token for authentication.

ex
string

Exchange code filter (e.g., 'US').

fmt
string
Enum: "json" "csv"

Response format. Options are 'json' and 'csv'. Defaults to JSON.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Market Data

Market capitalization and other market data

Retrieve historical market capitalization data

Fetches historical market capitalization for a specified stock symbol with weekly frequency.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

The ticker symbol of the stock, e.g., 'AAPL.US' or simply 'AAPL'.

query Parameters
api_token
required
string

Your API key for authentication.

from
string <date>

Start date for data retrieval in 'YYYY-MM-DD' format.

to
string <date>

End date for data retrieval in 'YYYY-MM-DD' format.

reverse
string
Enum: "true" "false"

Set to 'true' to reverse sort order (newest first).

fmt
string
Default: "json"
Enum: "json" "csv"

Output format, either 'json' or 'csv'. Defaults to 'json'.

Responses

Response samples

Content type
application/json
{
  • "0": {
    },
  • "1": {
    },
  • "2": {
    },
  • "3": {
    }
}

Logos

Company and ticker logos

Get ticker logo (SVG)

Returns an SVG logo for the given ticker symbol, formatted as {ticker}.{exchange} (e.g., AAPL.US).

Authorizations:
EODHDQueryKey
path Parameters
symbol
required
string
Examples:
  • AAPL.US - Apple Inc. on US exchange

Ticker with exchange, e.g., AAPL.US

query Parameters
api_token
required
string

API token for authentication.

Responses

Response samples

Content type
image/svg+xml
<svg>...</svg>

User

User account and subscription information

Retrieve internal user account information

Fetch detailed internal account information for the authenticated user, including subscription type, usage statistics, and available data feeds. Requires a valid api_token as a query parameter.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string >= 10 characters
Example: api_token=YOUR_API_TOKEN_HERE

API token for authentication. You can find this in your account dashboard on eodhd.com.

Responses

Response samples

Content type
application/json
{
  • "name": "John Doe",
  • "email": "user@example.com",
  • "subscriptionType": "monthly",
  • "paymentMethod": "Stripe",
  • "apiRequests": 1234,
  • "apiRequestsDate": "2025-01-15",
  • "dailyRateLimit": 100000,
  • "extraLimit": 0,
  • "inviteToken": "",
  • "inviteTokenClicked": 0,
  • "subscriptionMode": "paid",
  • "availableDataFeeds": [
    ],
  • "availableMarketplaceDataFeeds": {
    }
}

Get current user details

Returns details about the authenticated user, including subscription info and API usage.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "email": "string",
  • "subscriptionType": "string",
  • "paymentMethod": "string",
  • "apiRequests": 0,
  • "apiRequestsDate": "string",
  • "dailyRateLimit": 0
}

Indices

S&P/Dow Jones indices data and components

Index components (current + historical)

Returns the current components and historical changes for an index symbol.

Authorizations:
EODHDQueryKey
path Parameters
symbol
required
string

Index symbol, e.g., GSPC.INDX

query Parameters
fmt
string
Default: "json"
Enum: "json" "xml"

Response format.

api_token
required
string

API token for authentication.

Responses

Response samples

Content type
application/json
{
  • "General": {
    },
  • "Components": {
    },
  • "HistoricalTickerComponents": {
    }
}

List of indices with details

Returns essential EOD details for 100+ S&P & Dow Jones indices.

Authorizations:
EODHDQueryKey
query Parameters
fmt
string
Default: "json"
Enum: "json" "xml"

Response format.

api_token
required
string

API token for authentication.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

US Treasury

US Treasury interest rates (bills, yields, long-term, real yields)

Get US Treasury bill rates

Returns daily US Treasury bill rates (discount rates for 4-week, 8-week, 13-week, 17-week, 26-week, and 52-week bills).

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

from
string <date>

Start date in 'YYYY-MM-DD' format.

to
string <date>

End date in 'YYYY-MM-DD' format.

filter[year]
integer
Example: filter[year]=2024

Filter by year (e.g., 2024).

page[limit]
integer

Number of records per page.

page[offset]
integer

Pagination offset.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get US Treasury long-term rates

Returns US Treasury long-term average rates and extrapolation factors for maturities beyond 30 years.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

from
string <date>

Start date in 'YYYY-MM-DD' format.

to
string <date>

End date in 'YYYY-MM-DD' format.

filter[year]
integer
Example: filter[year]=2024

Filter by year (e.g., 2024).

page[limit]
integer

Number of records per page.

page[offset]
integer

Pagination offset.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get US Treasury real yield curve rates

Returns daily US Treasury real yield curve rates (TIPS-derived real yields for 5-year, 7-year, 10-year, 20-year, and 30-year maturities).

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

from
string <date>

Start date in 'YYYY-MM-DD' format.

to
string <date>

End date in 'YYYY-MM-DD' format.

filter[year]
integer
Example: filter[year]=2024

Filter by year (e.g., 2024).

page[limit]
integer

Number of records per page.

page[offset]
integer

Pagination offset.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get US Treasury yield curve rates

Returns daily US Treasury yield curve rates (constant maturity rates for 1-month through 30-year maturities).

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

from
string <date>

Start date in 'YYYY-MM-DD' format.

to
string <date>

End date in 'YYYY-MM-DD' format.

filter[year]
integer
Example: filter[year]=2024

Filter by year (e.g., 2024).

page[limit]
integer

Number of records per page.

page[offset]
integer

Pagination offset.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

CBOE

CBOE index data and listings

Get CBOE index historical data

Returns historical end-of-day data for a specific CBOE index, including daily open, high, low, close values.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

filter[index_code]
required
string

CBOE index code (e.g., 'VIX', 'SPX').

filter[feed_type]
required
string

Feed type filter.

filter[date]
required
string <date>

Date filter in 'YYYY-MM-DD' format.

filter[include_review]
string

Include review data.

fmt
string
Default: "json"
Enum: "json" "csv"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List CBOE indices

Returns a list of all available CBOE indices with their latest values and metadata.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

ESG

Environmental, Social, and Governance ratings (Investverte)

List ESG-rated companies

Returns a list of all companies with ESG ratings available from Investverte.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List ESG country scores

Returns a list of all countries with their aggregate ESG scores from Investverte.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get ESG country details

Returns detailed ESG scores and metrics for a specific country from Investverte.

Authorizations:
EODHDQueryKey
path Parameters
symbol
required
string

Country code (e.g., 'US', 'GB', 'DE').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "country": "string",
  • "country_code": "string",
  • "esg_score": 0,
  • "environmental_score": 0,
  • "social_score": 0,
  • "governance_score": 0,
  • "top_companies": [
    ],
  • "sector_breakdown": [
    ]
}

Get ESG rating for a company

Returns detailed ESG ratings and scores for a specific company from Investverte.

Authorizations:
EODHDQueryKey
path Parameters
symbol
required
string

Ticker symbol (e.g., 'AAPL.US').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "symbol": "string",
  • "name": "string",
  • "esg_score": 0,
  • "esg_rating": "string",
  • "environmental_score": 0,
  • "social_score": 0,
  • "governance_score": 0,
  • "environmental_details": { },
  • "social_details": { },
  • "governance_details": { },
  • "last_updated": "2019-08-24"
}

Get ESG sector details

Returns detailed ESG scores and metrics for a specific sector from Investverte.

Authorizations:
EODHDQueryKey
path Parameters
symbol
required
string

Sector identifier.

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "sector": "string",
  • "esg_score": 0,
  • "environmental_score": 0,
  • "social_score": 0,
  • "governance_score": 0,
  • "top_companies": [
    ],
  • "country_breakdown": [
    ]
}

List ESG sector scores

Returns a list of all sectors with their aggregate ESG scores from Investverte.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Investment Analytics

Risk scoring, bond analysis, bank financials, reports (PRAAMS)

Analyse bond by ISIN

Returns PRAAMS risk scoring and analysis for a specific bond identified by ISIN.

Authorizations:
EODHDQueryKey
path Parameters
isin
required
string

Bond ISIN code.

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "isin": "string",
  • "name": "string",
  • "risk_score": 0,
  • "risk_category": "string",
  • "yield_to_maturity": 0,
  • "duration": 0,
  • "convexity": 0,
  • "credit_rating": "string",
  • "coupon_rate": 0,
  • "maturity_date": "2019-08-24",
  • "issuer": "string"
}

Analyse equity by ISIN

Returns PRAAMS risk scoring and analysis for a specific equity identified by ISIN.

Authorizations:
EODHDQueryKey
path Parameters
isin
required
string

Equity ISIN code.

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "isin": "string",
  • "name": "string",
  • "risk_score": 0,
  • "risk_category": "string",
  • "volatility": 0,
  • "beta": 0,
  • "sharpe_ratio": 0,
  • "max_drawdown": 0,
  • "sector": "string",
  • "market_cap": 0
}

Analyse equity by ticker

Returns PRAAMS risk scoring and analysis for a specific equity identified by ticker.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol (e.g., 'AAPL.US').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "ticker": "string",
  • "name": "string",
  • "risk_score": 0,
  • "risk_category": "string",
  • "volatility": 0,
  • "beta": 0,
  • "sharpe_ratio": 0,
  • "max_drawdown": 0,
  • "sector": "string",
  • "market_cap": 0
}

Get bank balance sheet by ISIN

Returns bank-specific balance sheet analysis for the specified ISIN from PRAAMS.

Authorizations:
EODHDQueryKey
path Parameters
isin
required
string

ISIN code (e.g., 'US46625H1005').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "isin": "string",
  • "name": "string",
  • "total_assets": 0,
  • "total_liabilities": 0,
  • "total_equity": 0,
  • "loans_net": 0,
  • "deposits": 0,
  • "tier1_capital_ratio": 0,
  • "leverage_ratio": 0,
  • "periods": [
    ]
}

Get bank balance sheet by ticker

Returns bank-specific balance sheet analysis for the specified ticker from PRAAMS.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol (e.g., 'JPM.US').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "ticker": "string",
  • "name": "string",
  • "total_assets": 0,
  • "total_liabilities": 0,
  • "total_equity": 0,
  • "loans_net": 0,
  • "deposits": 0,
  • "tier1_capital_ratio": 0,
  • "leverage_ratio": 0,
  • "periods": [
    ]
}

Get bank income statement by ISIN

Returns bank-specific income statement analysis for the specified ISIN from PRAAMS.

Authorizations:
EODHDQueryKey
path Parameters
isin
required
string

ISIN code (e.g., 'US46625H1005').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "isin": "string",
  • "name": "string",
  • "net_interest_income": 0,
  • "non_interest_income": 0,
  • "provision_for_loan_losses": 0,
  • "net_income": 0,
  • "return_on_assets": 0,
  • "return_on_equity": 0,
  • "efficiency_ratio": 0,
  • "periods": [
    ]
}

Get bank income statement by ticker

Returns bank-specific income statement analysis for the specified ticker from PRAAMS.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol (e.g., 'JPM.US').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "ticker": "string",
  • "name": "string",
  • "net_interest_income": 0,
  • "non_interest_income": 0,
  • "provision_for_loan_losses": 0,
  • "net_income": 0,
  • "return_on_assets": 0,
  • "return_on_equity": 0,
  • "efficiency_ratio": 0,
  • "periods": [
    ]
}

Explore bonds

Search and filter bonds using PRAAMS analytics. Returns a list of bonds matching the specified criteria with risk scores.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

risk_category
string

Filter by risk category (e.g., 'Low', 'Medium', 'High').

min_yield
number

Minimum yield to maturity filter.

max_yield
number

Maximum yield to maturity filter.

currency
string

Filter by currency (e.g., 'USD', 'EUR').

offset
integer
Default: 0

Pagination offset.

limit
integer
Default: 50

Maximum results to return.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "offset": 0,
  • "limit": 0,
  • "bonds": [
    ]
}

Explore equities

Search and filter equities using PRAAMS analytics. Returns a list of equities matching the specified criteria with risk scores.

Authorizations:
EODHDQueryKey
query Parameters
api_token
required
string

API token for authentication.

risk_category
string

Filter by risk category (e.g., 'Low', 'Medium', 'High').

sector
string

Filter by sector.

country
string

Filter by country code.

min_market_cap
number

Minimum market capitalization filter.

offset
integer
Default: 0

Pagination offset.

limit
integer
Default: 50

Maximum results to return.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "offset": 0,
  • "limit": 0,
  • "equities": [
    ]
}

Get bond report by ISIN

Returns a comprehensive PRAAMS report for a specific bond, including risk assessment and analytics.

Authorizations:
EODHDQueryKey
path Parameters
isin
required
string

Bond ISIN code.

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "isin": "string",
  • "name": "string",
  • "report_date": "2019-08-24",
  • "risk_summary": {
    },
  • "bond_details": {
    }
}

Get equity report by ISIN

Returns a comprehensive PRAAMS report for a specific equity identified by ISIN.

Authorizations:
EODHDQueryKey
path Parameters
isin
required
string

Equity ISIN code.

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "isin": "string",
  • "name": "string",
  • "report_date": "2019-08-24",
  • "risk_summary": {
    },
  • "equity_details": {
    },
  • "performance": {
    }
}

Get equity report by ticker

Returns a comprehensive PRAAMS report for a specific equity, including risk assessment and analytics.

Authorizations:
EODHDQueryKey
path Parameters
ticker
required
string

Ticker symbol (e.g., 'AAPL.US').

query Parameters
api_token
required
string

API token for authentication.

fmt
string
Default: "json"
Value: "json"

Output format.

Responses

Response samples

Content type
application/json
{
  • "ticker": "string",
  • "name": "string",
  • "report_date": "2019-08-24",
  • "risk_summary": {
    },
  • "equity_details": {
    },
  • "performance": {
    }
}