{ "opencollection": "1.0.0", "info": { "name": "EODHD Financial Data API", "version": "2.0.0" }, "request": { "auth": { "type": "apikey", "key": "api_token", "value": "{{api_token}}", "placement": "query" } }, "items": [ { "info": { "name": "Fundamentals", "type": "folder" }, "items": [ { "info": { "name": "Retrieve bulk fundamental data for an exchange", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/bulk-fundamentals/:EXCHANGE", "params": [ { "name": "EXCHANGE", "value": "", "type": "path", "description": "Exchange code (e.g., 'US', 'LSE', 'TO')." }, { "name": "symbols", "value": "", "type": "query", "description": "Comma-separated list of symbols to filter (e.g., 'AAPL,MSFT,GOOGL')." }, { "name": "offset", "value": "", "type": "query", "description": "Offset for pagination (number of records to skip)." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return (max 500)." }, { "name": "version", "value": "", "type": "query", "description": "API version for response format." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Fetches fundamental data in bulk for all symbols on a given exchange. Supports filtering by specific symbols and data sections (General, Highlights, Valuation, etc.)." }, { "info": { "name": "Retrieve filtered fundamental data for a specific symbol", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/fundamentals/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "The ticker symbol in the format SYMBOL.EXCHANGE, e.g., 'AAPL.US' for Apple Inc. on NASDAQ." }, { "name": "filter", "value": "", "type": "query", "description": "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." }, { "name": "historical", "value": "", "type": "query", "description": "Set to 1 to return historical data for certain sections (e.g., outstandingShares)." }, { "name": "from", "value": "", "type": "query", "description": "Start date for historical data in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date for historical data in 'YYYY-MM-DD' format." }, { "name": "version", "value": "", "type": "query", "description": "API version for response format." }, { "name": "no_cache", "value": "", "type": "query", "description": "Set to 1 to bypass cache and get fresh data." } ] }, "docs": "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." }, { "info": { "name": "Retrieve bulk fundamental data for an exchange (v1.1)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/v1.1/bulk-fundamentals/:EXCHANGE", "params": [ { "name": "EXCHANGE", "value": "", "type": "path", "description": "Exchange code (e.g., 'US', 'LSE', 'TO')." }, { "name": "symbols", "value": "", "type": "query", "description": "Comma-separated list of symbols to filter (e.g., 'AAPL,MSFT,GOOGL')." }, { "name": "offset", "value": "", "type": "query", "description": "Offset for pagination (number of records to skip)." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return (max 500)." }, { "name": "version", "value": "", "type": "query", "description": "API version for response format." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format. In v1.1, only json format is supported." } ] }, "docs": "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." }, { "info": { "name": "Retrieve filtered fundamental data for a specific symbol (v1.1)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/v1.1/fundamentals/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "The ticker symbol in the format SYMBOL.EXCHANGE, e.g., 'AAPL.US' for Apple Inc. on NASDAQ." }, { "name": "filter", "value": "", "type": "query", "description": "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." }, { "name": "historical", "value": "", "type": "query", "description": "Set to 1 to return historical data for certain sections (e.g., outstandingShares)." }, { "name": "from", "value": "", "type": "query", "description": "Start date for historical data in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date for historical data in 'YYYY-MM-DD' format." }, { "name": "version", "value": "", "type": "query", "description": "API version for response format." }, { "name": "no_cache", "value": "", "type": "query", "description": "Set to 1 to bypass cache and get fresh data." } ] }, "docs": "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." } ] }, { "info": { "name": "Calendar", "type": "folder" }, "items": [ { "info": { "name": "Retrieve upcoming dividends calendar", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/calendar/dividends", "params": [ { "name": "filter[date_eq]", "value": "", "type": "query", "description": "Exact date in 'YYYY-MM-DD' format. Required if `filter[symbol]` is not present.\n" }, { "name": "filter[date_from]", "value": "", "type": "query", "description": "Start date in 'YYYY-MM-DD' format." }, { "name": "filter[date_to]", "value": "", "type": "query", "description": "End date in 'YYYY-MM-DD' format." }, { "name": "filter[symbol]", "value": "", "type": "query", "description": "Ticker symbol (e.g., 'AAPL.US'). When provided, `filter[date_eq]` may be omitted.\n" }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page (1-10000)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (0-1000000)." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format. Defaults to 'json'." } ] }, "docs": "Look up upcoming and historical dividend events.\n\nUses 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.\n" }, { "info": { "name": "Retrieve upcoming earnings data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/calendar/earnings", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date for earnings data, in 'YYYY-MM-DD' format. Defaults to today if not provided." }, { "name": "to", "value": "", "type": "query", "description": "End date for earnings data, in 'YYYY-MM-DD' format. Defaults to 7 days from today if not provided." }, { "name": "symbols", "value": "", "type": "query", "description": "Specific symbols to retrieve earnings data for, separated by commas (e.g., 'AAPL.US,MSFT.US'). Overrides the 'from' and 'to' parameters if used." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format, either 'csv' or 'json'. Defaults to 'csv'." } ] }, "docs": "Fetches upcoming earnings data, with optional parameters for date ranges and specific symbols." }, { "info": { "name": "Retrieve upcoming IPO data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/calendar/ipos", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date for IPO data in 'YYYY-MM-DD' format. Defaults to today if not provided." }, { "name": "to", "value": "", "type": "query", "description": "End date for IPO data in 'YYYY-MM-DD' format. Defaults to 7 days from today if not provided." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format. Possible values: 'csv' for CSV and 'json' for JSON. Defaults to 'csv'." } ] }, "docs": "Fetches historical and upcoming IPOs for specified date ranges." }, { "info": { "name": "Retrieve upcoming and historical stock splits", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/calendar/splits", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date for split data in 'YYYY-MM-DD' format. Defaults to today if not provided." }, { "name": "to", "value": "", "type": "query", "description": "End date for split data in 'YYYY-MM-DD' format. Defaults to 7 days from today if not provided." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format, either 'csv' or 'json'. Default is 'csv'." } ] }, "docs": "Fetches information on stock splits for specified date ranges." }, { "info": { "name": "Retrieve earnings trends data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/calendar/trends", "params": [ { "name": "symbols", "value": "", "type": "query", "description": "Comma-separated list of stock symbols to retrieve trends data for (e.g., 'AAPL.US,MSFT.US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format. Currently supports only 'json'." } ] }, "docs": "Fetches historical and upcoming earnings trends, including EPS and revenue estimates, trends, and revisions for specific stock symbols." } ] }, { "info": { "name": "Economic Data", "type": "folder" }, "items": [ { "info": { "name": "Get historical commodity prices", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/commodities/historical/:code", "params": [ { "name": "code", "value": "", "type": "path", "description": "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')." }, { "name": "interval", "value": "", "type": "query", "description": "Data interval — 'daily' (default), 'weekly', or 'monthly'." }, { "name": "from", "value": "", "type": "query", "description": "Start date in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date in 'YYYY-MM-DD' format." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns historical price data for a specific commodity by its code (e.g., WTI, BRENT, NATURAL_GAS)." }, { "info": { "name": "Retrieve economic events data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/economic-events", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date for data retrieval in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date for data retrieval in 'YYYY-MM-DD' format." }, { "name": "country", "value": "", "type": "query", "description": "Country code in ISO 3166-1 alpha-2 format, e.g., 'US' for the United States." }, { "name": "comparison", "value": "", "type": "query", "description": "Comparison type, e.g., 'mom' for month-over-month, 'qoq' for quarter-over-quarter, 'yoy' for year-over-year." }, { "name": "offset", "value": "", "type": "query", "description": "Data offset, from 0 to 1000. Default is 0." }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return, from 0 to 1000. Default is 50." } ] }, "docs": "Fetches economic events by date range, country, comparison type, and other optional parameters." }, { "info": { "name": "Retrieve macroeconomic indicators for a specific country", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/macro-indicator/:country", "params": [ { "name": "country", "value": "", "type": "path", "description": "Country code in ISO Alpha-3 format (e.g., 'USA' for United States, 'FRA' for France)." }, { "name": "indicator", "value": "", "type": "query", "description": "The macroeconomic indicator to retrieve. Default is 'gdp_current_usd'." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format: 'json' or 'csv'. Default is 'json'." } ] }, "docs": "Fetches macroeconomic data for a selected indicator, such as GDP or inflation, by country code." } ] }, { "info": { "name": "Credit & Sovereign Risk", "type": "folder" }, "items": [ { "info": { "name": "Get sovereign country risk premiums", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/credit-risk/sovereign/risk-premium", "params": [ { "name": "filter[country]", "value": "", "type": "query", "description": "Filter by country name or ISO Alpha-3 code (e.g., 'USA' or 'Germany')." }, { "name": "filter[region]", "value": "", "type": "query", "description": "Filter by region name." }, { "name": "filter[as_of]", "value": "", "type": "query", "description": "Filter by the as-of date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns country-level default spreads, country risk premiums, equity risk premiums, corporate tax rates, and related sovereign credit metrics." }, { "info": { "name": "Get sovereign credit ratings", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/credit-risk/sovereign/credit-ratings", "params": [ { "name": "filter[country]", "value": "", "type": "query", "description": "Filter by country name or ISO Alpha-3 code (e.g., 'USA' or 'Germany')." }, { "name": "filter[as_of]", "value": "", "type": "query", "description": "Filter by the as-of date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns sovereign credit ratings by country from Moody's, S&P, and Fitch." }, { "info": { "name": "Get sovereign CDS spreads", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/credit-risk/sovereign/cds-spreads", "params": [ { "name": "filter[country]", "value": "", "type": "query", "description": "Filter by country name or ISO Alpha-3 code (e.g., 'USA' or 'Germany')." }, { "name": "filter[as_of]", "value": "", "type": "query", "description": "Filter by the as-of date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns sovereign credit default swap (CDS) spreads by country, including spreads net of Switzerland." }, { "info": { "name": "Get default spreads by rating", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/credit-risk/sovereign/default-spreads", "params": [ { "name": "filter[rating]", "value": "", "type": "query", "description": "Filter by credit rating bucket (e.g., 'Aaa', 'Baa2')." }, { "name": "filter[as_of]", "value": "", "type": "query", "description": "Filter by the as-of date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns default spreads mapped to credit rating buckets." }, { "info": { "name": "Get corporate market debt indices (CMDI)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/credit-risk/corporate/cmdi", "params": [ { "name": "filter[from]", "value": "", "type": "query", "description": "Start date (YYYY-MM-DD)." }, { "name": "filter[to]", "value": "", "type": "query", "description": "End date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns the Corporate Market Debt Index series, including overall market, investment-grade, and high-yield sub-indices." }, { "info": { "name": "Get high quality market (HQM) corporate bond yields", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/credit-risk/corporate/hqm-yields", "params": [ { "name": "filter[tenor]", "value": "", "type": "query", "description": "Filter by tenor in years, single value or comma-separated list (e.g., '10' or '2,5,10'). Allowed values 1, 2, 3, 5, 7, 10, 15, 20, 25, 30." }, { "name": "filter[type]", "value": "", "type": "query", "description": "Yield curve type, single value or comma-separated list (e.g., 'par' or 'par,spot'). Allowed values par, spot (case-insensitive)." }, { "name": "filter[from]", "value": "", "type": "query", "description": "Start date (YYYY-MM-DD)." }, { "name": "filter[to]", "value": "", "type": "query", "description": "End date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns High Quality Market corporate bond yield curve values (par and spot) across standard tenors." }, { "info": { "name": "Get CDS market aggregate statistics", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/credit-risk/cds-market/aggregates", "params": [ { "name": "filter[metric]", "value": "", "type": "query", "description": "Aggregate metric to return." }, { "name": "filter[dimension]", "value": "", "type": "query", "description": "Breakdown dimension." }, { "name": "filter[value]", "value": "", "type": "query", "description": "Filter by the value of the breakdown dimension." }, { "name": "filter[region]", "value": "", "type": "query", "description": "Filter by region." }, { "name": "filter[from]", "value": "", "type": "query", "description": "Start date (YYYY-MM-DD)." }, { "name": "filter[to]", "value": "", "type": "query", "description": "End date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns aggregated CDS market statistics (e.g., gross notional) broken down by dimensions such as grade or cleared status." } ] }, { "info": { "name": "CBOE", "type": "folder" }, "items": [ { "info": { "name": "Get CBOE index historical data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/cboe/index", "params": [ { "name": "filter[index_code]", "value": "", "type": "query", "description": "CBOE index code (e.g., 'VIX', 'SPX')." }, { "name": "filter[feed_type]", "value": "", "type": "query", "description": "Feed type filter." }, { "name": "filter[date]", "value": "", "type": "query", "description": "Date filter in 'YYYY-MM-DD' format." }, { "name": "filter[include_review]", "value": "", "type": "query", "description": "Include review data." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns historical end-of-day data for a specific CBOE index, including daily open, high, low, close values." }, { "info": { "name": "List CBOE indices", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/cboe/indices", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns a list of all available CBOE indices with their latest values and metadata." } ] }, { "info": { "name": "Dividends & Splits", "type": "folder" }, "items": [ { "info": { "name": "Retrieve historical dividend data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/div/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "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)." }, { "name": "from", "value": "", "type": "query", "description": "Start date for data retrieval in 'YYYY-MM-DD' format. Defaults to earliest available data if not provided." }, { "name": "to", "value": "", "type": "query", "description": "End date for data retrieval in 'YYYY-MM-DD' format. Defaults to latest available data if not provided." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format, either 'json' or 'csv'. Defaults to 'json'." } ] }, "docs": "Fetches historical dividend data for a specified stock symbol, including key dividend dates and values." }, { "info": { "name": "Retrieve historical split data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/splits/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "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)." }, { "name": "from", "value": "", "type": "query", "description": "Start date for data retrieval in 'YYYY-MM-DD' format. Defaults to earliest available data if not provided." }, { "name": "to", "value": "", "type": "query", "description": "End date for data retrieval in 'YYYY-MM-DD' format. Defaults to latest available data if not provided." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format, either 'json' or 'csv'. Defaults to 'json'." } ] }, "docs": "Fetches historical stock split data for a specified ticker, including split dates and ratios." } ] }, { "info": { "name": "End-of-Day Data", "type": "folder" }, "items": [ { "info": { "name": "Retrieve end-of-day historical price data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/eod/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Ticker symbol of the company" }, { "name": "fmt", "value": "", "type": "query", "description": "Response format (e.g., 'json')" }, { "name": "from", "value": "", "type": "query", "description": "Start date for historical data (YYYY-MM-DD)" }, { "name": "to", "value": "", "type": "query", "description": "End date for historical data (YYYY-MM-DD)" }, { "name": "period", "value": "", "type": "query", "description": "Data period (e.g., 'd' for daily, 'w' for weekly, 'm' for monthly)" }, { "name": "filter", "value": "", "type": "query", "description": "Filter for specific last known data points" } ] }, "docs": "Retrieve end-of-day historical data for a specific company by its ticker symbol, with optional filters for specific data points." }, { "info": { "name": "Retrieve bulk EOD, splits, or dividends data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/eod-bulk-last-day/:exchange", "params": [ { "name": "exchange", "value": "", "type": "path", "description": "Exchange symbol (e.g., 'VI' for Vienna or 'US' for the U.S.)." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format ('json' or 'csv')." }, { "name": "type", "value": "", "type": "query", "description": "Data type ('eod' for end-of-day data, 'splits' for stock splits, 'dividends' for dividend information)." }, { "name": "date", "value": "", "type": "query", "description": "Specific date for historical data (YYYY-MM-DD). Defaults to the last trading day." }, { "name": "symbols", "value": "", "type": "query", "description": "Comma-separated list of specific tickers to retrieve data for (e.g., 'MSFT,AAPL'). Only available for EOD data." }, { "name": "filter", "value": "", "type": "query", "description": "Extended filter for additional data such as company name, EMA, etc. Only available in JSON format." } ] }, "docs": "Retrieve bulk end-of-day data, splits, or dividends for an entire exchange or specific tickers, with an option for extended data." } ] }, { "info": { "name": "Exchanges", "type": "folder" }, "items": [ { "info": { "name": "Retrieve details for a specific exchange", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/exchange-details/:EXCHANGE_CODE", "params": [ { "name": "EXCHANGE_CODE", "value": "", "type": "path", "description": "Exchange code for which details are to be retrieved (e.g., 'US' for the USA exchange)." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format. Options are 'json' and 'csv'. Defaults to JSON." }, { "name": "from", "value": "", "type": "query", "description": "Start date for holiday data (YYYY-MM-DD). Defaults to 6 months before the current date." }, { "name": "to", "value": "", "type": "query", "description": "End date for holiday data (YYYY-MM-DD). Defaults to 6 months after the current date." }, { "name": "format_version", "value": "", "type": "query", "description": "Response format version." } ] }, "docs": "Retrieve exchange details, trading hours, holidays, and active tickers for a specified exchange." }, { "info": { "name": "Retrieve the list of tickers for a specific exchange.", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/exchange-symbol-list/:exchangeCode", "params": [ { "name": "exchangeCode", "value": "", "type": "path", "description": "Exchange code, e.g., 'PSE' for the Philippines Stock Exchange or 'US' for combined US exchanges." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format. Options: 'json' (default) or 'csv'." }, { "name": "delisted", "value": "", "type": "query", "description": "Include delisted (inactive) tickers. Set to '1' to include." }, { "name": "type", "value": "", "type": "query", "description": "Filter by ticker type. Options: 'common_stock', 'preferred_stock', 'stock', 'etf', 'fund'." } ] }, "docs": "Returns a list of active or delisted symbols for the specified exchange, with optional filters by ticker type." }, { "info": { "name": "List supported exchanges", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/exchanges-list", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Response format. Options are 'json' and 'csv'. Defaults to JSON." } ] }, "docs": "Retrieve the list of supported exchanges with their details." }, { "info": { "name": "Map between financial identifiers", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/id-mapping", "params": [ { "name": "filter[symbol]", "value": "", "type": "query", "description": "Filter by ticker symbol (e.g., 'AAPL')." }, { "name": "filter[ex]", "value": "", "type": "query", "description": "Filter by exchange code (e.g., 'US')." }, { "name": "filter[isin]", "value": "", "type": "query", "description": "Filter by ISIN code (e.g., 'US0378331005')." }, { "name": "filter[figi]", "value": "", "type": "query", "description": "Filter by FIGI identifier." }, { "name": "filter[lei]", "value": "", "type": "query", "description": "Filter by LEI code." }, { "name": "filter[cusip]", "value": "", "type": "query", "description": "Filter by CUSIP identifier." }, { "name": "filter[cik]", "value": "", "type": "query", "description": "Filter by CIK number." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Look up securities by various identifiers including symbol, exchange code, ISIN, FIGI, LEI, CUSIP, and CIK.\n\n**At least one of the following filter parameters is required**:\n`filter[symbol]`, `filter[isin]`, `filter[figi]`, `filter[lei]`, `filter[cusip]`, `filter[cik]`, or `filter[ex]`.\nA request without any of these will return HTTP 422.\n" }, { "info": { "name": "List available exchanges (v2)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/v2/exchange-details" }, "docs": "Returns an array of all exchange codes supported by the v2 endpoint. Use these codes to request details for a specific exchange via /v2/exchange-details/{code}." }, { "info": { "name": "Get exchange details and trading hours (v2)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/v2/exchange-details/:code", "params": [ { "name": "code", "value": "", "type": "path", "description": "Exchange code (case-insensitive). Use /v2/exchange-details to get the list of supported codes." } ] }, "docs": "Returns trading hours, extended sessions (pre-market, after-hours), lunch breaks, and the full holiday calendar for the requested exchange. Covers 73 exchanges with verified data. The code parameter is case-insensitive." } ] }, { "info": { "name": "Market Data", "type": "folder" }, "items": [ { "info": { "name": "Retrieve historical market capitalization data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/historical-market-cap/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "The ticker symbol of the stock, e.g., 'AAPL.US' or simply 'AAPL'." }, { "name": "from", "value": "", "type": "query", "description": "Start date for data retrieval in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date for data retrieval in 'YYYY-MM-DD' format." }, { "name": "reverse", "value": "", "type": "query", "description": "Set to 'true' to reverse sort order (newest first)." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format, either 'json' or 'csv'. Defaults to 'json'." } ] }, "docs": "Fetches historical market capitalization for a specified stock symbol with weekly frequency." } ] }, { "info": { "name": "Corporate Actions", "type": "folder" }, "items": [ { "info": { "name": "Retrieve insider transaction data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/insider-transactions", "params": [ { "name": "limit", "value": "", "type": "query", "description": "Max number of entries per result, from 1 to 1000. Default is 100." }, { "name": "from", "value": "", "type": "query", "description": "Start date for transactions (format: YYYY-MM-DD). Defaults to one year before current date." }, { "name": "to", "value": "", "type": "query", "description": "End date for transactions (format: YYYY-MM-DD). Defaults to current date." }, { "name": "code", "value": "", "type": "query", "description": "Ticker symbol for filtering results (e.g., 'AAPL.US'). If omitted, returns data for all symbols." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format (only 'json' supported)." } ] }, "docs": "Fetch insider transaction data for US-listed companies. Covers insider buys and sells, providing transaction details such as date, shares, and price." }, { "info": { "name": "Retrieve symbol change history", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/symbol-change-history", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date for symbol change history in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date for symbol change history in 'YYYY-MM-DD' format." }, { "name": "ex", "value": "", "type": "query", "description": "Exchange code filter (e.g., 'US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format. Options are 'json' and 'csv'. Defaults to JSON." } ] }, "docs": "Retrieve the symbol change history within a specified date range. Only US exchanges are currently supported." } ] }, { "info": { "name": "User", "type": "folder" }, "items": [ { "info": { "name": "Retrieve internal user account information", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/internal-user" }, "docs": "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." }, { "info": { "name": "Get current user details", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/user", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns details about the authenticated user, including subscription info and API usage." } ] }, { "info": { "name": "Intraday Data", "type": "folder" }, "items": [ { "info": { "name": "Retrieve intraday historical price data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/intraday/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Ticker symbol with exchange code (e.g., 'AAPL.US')." }, { "name": "interval", "value": "", "type": "query", "description": "Interval for data points. Options are '1m' (1 minute), '5m' (5 minutes), '15m' (15 minutes), '30m' (30 minutes), and '1h' (1 hour)." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format. Defaults to CSV if not specified. Options are 'json' and 'csv'." }, { "name": "from", "value": "", "type": "query", "description": "Start datetime in Unix timestamp (UTC). For example, 1627896900 for '2021-08-02 09:35:00'." }, { "name": "to", "value": "", "type": "query", "description": "End datetime in Unix timestamp (UTC). For example, 1630575300 for '2021-09-02 09:35:00'." } ] }, "docs": "Retrieve intraday historical stock data for a specific ticker." } ] }, { "info": { "name": "Logos", "type": "folder" }, "items": [ { "info": { "name": "Get ticker logo (PNG)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/logo/:symbol", "params": [ { "name": "symbol", "value": "", "type": "path", "description": "Ticker with exchange, e.g., AAPL.US" } ] }, "docs": "Returns a 200x200 PNG logo (transparent background) for the given ticker symbol, formatted as {ticker}.{exchange} (e.g., AAPL.US)." }, { "info": { "name": "Get ticker logo (SVG)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/logo-svg/:symbol", "params": [ { "name": "symbol", "value": "", "type": "path", "description": "Ticker with exchange, e.g., AAPL.US" } ] }, "docs": "Returns an SVG logo for the given ticker symbol, formatted as {ticker}.{exchange} (e.g., AAPL.US)." } ] }, { "info": { "name": "ESG", "type": "folder" }, "items": [ { "info": { "name": "List ESG-rated companies", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/investverte/companies", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns a list of all companies with ESG ratings available from Investverte." }, { "info": { "name": "List ESG country scores", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/investverte/countries", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns a list of all countries with their aggregate ESG scores from Investverte." }, { "info": { "name": "Get ESG country details", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/investverte/country/:symbol", "params": [ { "name": "symbol", "value": "", "type": "path", "description": "Country code (e.g., 'US', 'GB', 'DE')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns detailed ESG scores and metrics for a specific country from Investverte." }, { "info": { "name": "Get ESG rating for a company", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/investverte/esg/:symbol", "params": [ { "name": "symbol", "value": "", "type": "path", "description": "Ticker symbol (e.g., 'AAPL.US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns detailed ESG ratings and scores for a specific company from Investverte." }, { "info": { "name": "Get ESG sector details", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/investverte/sector/:symbol", "params": [ { "name": "symbol", "value": "", "type": "path", "description": "Sector identifier." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns detailed ESG scores and metrics for a specific sector from Investverte." }, { "info": { "name": "List ESG sector scores", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/investverte/sectors", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns a list of all sectors with their aggregate ESG scores from Investverte." } ] }, { "info": { "name": "Investment Analytics", "type": "folder" }, "items": [ { "info": { "name": "Analyse bond by ISIN", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/analyse/bond/:isin", "params": [ { "name": "isin", "value": "", "type": "path", "description": "Bond ISIN code." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns PRAAMS risk scoring and analysis for a specific bond identified by ISIN." }, { "info": { "name": "Analyse equity by ISIN", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/analyse/equity/isin/:isin", "params": [ { "name": "isin", "value": "", "type": "path", "description": "Equity ISIN code." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns PRAAMS risk scoring and analysis for a specific equity identified by ISIN." }, { "info": { "name": "Analyse equity by ticker", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/analyse/equity/ticker/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Ticker symbol (e.g., 'AAPL.US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns PRAAMS risk scoring and analysis for a specific equity identified by ticker." }, { "info": { "name": "Get bank balance sheet by ISIN", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/bank/balance_sheet/isin/:isin", "params": [ { "name": "isin", "value": "", "type": "path", "description": "ISIN code (e.g., 'US46625H1005')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns bank-specific balance sheet analysis for the specified ISIN from PRAAMS." }, { "info": { "name": "Get bank balance sheet by ticker", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/bank/balance_sheet/ticker/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Ticker symbol (e.g., 'JPM.US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns bank-specific balance sheet analysis for the specified ticker from PRAAMS." }, { "info": { "name": "Get bank income statement by ISIN", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/bank/income_statement/isin/:isin", "params": [ { "name": "isin", "value": "", "type": "path", "description": "ISIN code (e.g., 'US46625H1005')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns bank-specific income statement analysis for the specified ISIN from PRAAMS." }, { "info": { "name": "Get bank income statement by ticker", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/bank/income_statement/ticker/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Ticker symbol (e.g., 'JPM.US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns bank-specific income statement analysis for the specified ticker from PRAAMS." }, { "info": { "name": "Explore bonds", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/explore/bond", "params": [ { "name": "risk_category", "value": "", "type": "query", "description": "Filter by risk category (e.g., 'Low', 'Medium', 'High')." }, { "name": "min_yield", "value": "", "type": "query", "description": "Minimum yield to maturity filter." }, { "name": "max_yield", "value": "", "type": "query", "description": "Maximum yield to maturity filter." }, { "name": "currency", "value": "", "type": "query", "description": "Filter by currency (e.g., 'USD', 'EUR')." }, { "name": "offset", "value": "", "type": "query", "description": "Pagination offset." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum results to return." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Search and filter bonds using PRAAMS analytics. Returns a list of bonds matching the specified criteria with risk scores." }, { "info": { "name": "Explore equities", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/explore/equity", "params": [ { "name": "risk_category", "value": "", "type": "query", "description": "Filter by risk category (e.g., 'Low', 'Medium', 'High')." }, { "name": "sector", "value": "", "type": "query", "description": "Filter by sector." }, { "name": "country", "value": "", "type": "query", "description": "Filter by country code." }, { "name": "min_market_cap", "value": "", "type": "query", "description": "Minimum market capitalization filter." }, { "name": "offset", "value": "", "type": "query", "description": "Pagination offset." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum results to return." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Search and filter equities using PRAAMS analytics. Returns a list of equities matching the specified criteria with risk scores." }, { "info": { "name": "Get bond report by ISIN", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/reports/bond/:isin", "params": [ { "name": "isin", "value": "", "type": "path", "description": "Bond ISIN code." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns a comprehensive PRAAMS report for a specific bond, including risk assessment and analytics." }, { "info": { "name": "Get equity report by ISIN", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/reports/equity/isin/:isin", "params": [ { "name": "isin", "value": "", "type": "path", "description": "Equity ISIN code." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns a comprehensive PRAAMS report for a specific equity identified by ISIN." }, { "info": { "name": "Get equity report by ticker", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/praams/reports/equity/ticker/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Ticker symbol (e.g., 'AAPL.US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns a comprehensive PRAAMS report for a specific equity, including risk assessment and analytics." } ] }, { "info": { "name": "Options", "type": "folder" }, "items": [ { "info": { "name": "Get options contracts", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/unicornbay/options/contracts", "params": [ { "name": "filter[contract]", "value": "", "type": "query", "description": "Exact contract name, e.g., AAPL270115P00450000" }, { "name": "filter[underlying_symbol]", "value": "", "type": "query", "description": "Underlying symbol, e.g., AAPL" }, { "name": "filter[exp_date_eq]", "value": "", "type": "query", "description": "Expiration equals (YYYY-MM-DD)" }, { "name": "filter[exp_date_from]", "value": "", "type": "query", "description": "Expiration from (YYYY-MM-DD)" }, { "name": "filter[exp_date_to]", "value": "", "type": "query", "description": "Expiration to (YYYY-MM-DD)" }, { "name": "filter[tradetime_eq]", "value": "", "type": "query", "description": "Trade time equals (YYYY-MM-DD)" }, { "name": "filter[tradetime_from]", "value": "", "type": "query", "description": "Trade time from (YYYY-MM-DD)" }, { "name": "filter[tradetime_to]", "value": "", "type": "query", "description": "Trade time to (YYYY-MM-DD)" }, { "name": "filter[type]", "value": "", "type": "query", "description": "Option type" }, { "name": "filter[strike_eq]", "value": "", "type": "query", "description": "Strike equals" }, { "name": "filter[strike_from]", "value": "", "type": "query", "description": "Strike from" }, { "name": "filter[strike_to]", "value": "", "type": "query", "description": "Strike to" }, { "name": "sort", "value": "", "type": "query", "description": "Sort by expiration date or strike (asc/desc)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip). Max 10000." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Pagination limit. Default & max 1000." }, { "name": "fields[options-contracts]", "value": "", "type": "query", "description": "CSV of fields to include (e.g., contract,exp_date,strike)." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format." } ] }, "docs": "Fetch options contracts filtered by underlying symbol, expiration, strike, type, or contract name. Supports sorting, pagination, and field selection." }, { "info": { "name": "Get end-of-day options data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/unicornbay/options/eod", "params": [ { "name": "filter[contract]", "value": "", "type": "query", "description": "Exact contract name, e.g., AAPL270115P00450000" }, { "name": "filter[underlying_symbol]", "value": "", "type": "query", "description": "Underlying symbol, e.g., AAPL" }, { "name": "filter[exp_date_eq]", "value": "", "type": "query", "description": "Expiration equals (YYYY-MM-DD)" }, { "name": "filter[exp_date_from]", "value": "", "type": "query", "description": "Expiration from (YYYY-MM-DD)" }, { "name": "filter[exp_date_to]", "value": "", "type": "query", "description": "Expiration to (YYYY-MM-DD)" }, { "name": "filter[tradetime_eq]", "value": "", "type": "query", "description": "Trade time equals (YYYY-MM-DD)" }, { "name": "filter[tradetime_from]", "value": "", "type": "query", "description": "Trade time from (YYYY-MM-DD)" }, { "name": "filter[tradetime_to]", "value": "", "type": "query", "description": "Trade time to (YYYY-MM-DD)" }, { "name": "filter[type]", "value": "", "type": "query", "description": "Option type" }, { "name": "filter[strike_eq]", "value": "", "type": "query", "description": "Strike equals" }, { "name": "filter[strike_from]", "value": "", "type": "query", "description": "Strike from" }, { "name": "filter[strike_to]", "value": "", "type": "query", "description": "Strike to" }, { "name": "sort", "value": "", "type": "query", "description": "Sort by expiration date or strike (asc/desc)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip). Max 10000." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Pagination limit. Default & max 1000." }, { "name": "fields[options-eod]", "value": "", "type": "query", "description": "CSV of fields to include (e.g., contract,exp_date,strike)." }, { "name": "compact", "value": "", "type": "query", "description": "Set 1 for compact mode (rows as arrays in `data`, columns = `meta.fields`)." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format." } ] }, "docs": "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." }, { "info": { "name": "List underlying symbols with options", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/unicornbay/options/underlying-symbols", "params": [ { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Pagination limit. Default & max 1000." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format." } ] }, "docs": "Returns the list of all supported stock symbols for which option contracts are available. May be paginated." } ] }, { "info": { "name": "Indices", "type": "folder" }, "items": [ { "info": { "name": "Index components (current + historical)", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/unicornbay/spglobal/comp/:symbol", "params": [ { "name": "symbol", "value": "", "type": "path", "description": "Index symbol, e.g., GSPC.INDX" }, { "name": "fmt", "value": "", "type": "query", "description": "Response format." } ] }, "docs": "Returns the current components and historical changes for an index symbol." }, { "info": { "name": "List of indices with details", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/unicornbay/spglobal/list", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Response format." } ] }, "docs": "Returns essential EOD details for 100+ S&P & Dow Jones indices." } ] }, { "info": { "name": "Tick Data", "type": "folder" }, "items": [ { "info": { "name": "Retrieve marketplace tick data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/mp/unicornbay/tickdata/ticks", "params": [ { "name": "s", "value": "", "type": "query", "description": "Ticker symbol (e.g., 'AAPL' or 'AAPL.US')." }, { "name": "from", "value": "", "type": "query", "description": "Start UNIX timestamp (UTC)." }, { "name": "to", "value": "", "type": "query", "description": "End UNIX timestamp (UTC)." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of ticks to return." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Get tick-level data via the UnicornBay marketplace data provider. Returns granular trade-by-trade data for supported symbols." }, { "info": { "name": "Retrieve historical tick data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/ticks", "params": [ { "name": "s", "value": "", "type": "query", "description": "Ticker symbol (e.g., 'AAPL' or 'AAPL.US' for US-listed stocks)." }, { "name": "from", "value": "", "type": "query", "description": "Start UNIX timestamp (UTC) for filtering data." }, { "name": "to", "value": "", "type": "query", "description": "End UNIX timestamp (UTC) for filtering data." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of ticks to return." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format (only 'json' supported)" } ] }, "docs": "Get historical stock tick data for US equities using UNIX time for filtering. Limited to US exchanges." } ] }, { "info": { "name": "News", "type": "folder" }, "items": [ { "info": { "name": "Retrieve financial news articles", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/news", "params": [ { "name": "s", "value": "", "type": "query", "description": "Ticker code to get news for (e.g., 'AAPL.US'). Required if 't' is not provided." }, { "name": "t", "value": "", "type": "query", "description": "Tag to get news on a given topic. Required if 's' is not provided." }, { "name": "from", "value": "", "type": "query", "description": "Start date for news data (YYYY-MM-DD)" }, { "name": "to", "value": "", "type": "query", "description": "End date for news data (YYYY-MM-DD)" }, { "name": "limit", "value": "", "type": "query", "description": "The number of results to return" }, { "name": "offset", "value": "", "type": "query", "description": "The offset of the data" }, { "name": "fmt", "value": "", "type": "query", "description": "Response format (e.g., 'json')" } ] }, "docs": "Retrieve financial news articles for a specific company ticker or topic" }, { "info": { "name": "Top weighted news keywords for a ticker", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/news-word-weights", "params": [ { "name": "s", "value": "", "type": "query", "description": "Ticker to analyze, e.g., AAPL or AAPL.US" }, { "name": "filter[date_from]", "value": "", "type": "query", "description": "Start date (YYYY-MM-DD)" }, { "name": "filter[date_to]", "value": "", "type": "query", "description": "End date (YYYY-MM-DD). Prefer this over the legacy alias `filter[to]`." }, { "name": "filter[to]", "value": "", "type": "query", "description": "Deprecated alias for `filter[date_to]` (YYYY-MM-DD). Use only one of these parameters." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of top words to return" }, { "name": "fmt", "value": "", "type": "query", "description": "Response format" } ] }, "docs": "Returns the most relevant words from financial news for the given ticker and period, with weights (frequency ? significance)." }, { "info": { "name": "Retrieve market news sentiment data", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/sentiments", "params": [ { "name": "s", "value": "", "type": "query", "description": "Comma-separated list of ticker codes to retrieve sentiment data for (e.g., 'btc-usd.cc,aapl.us')." }, { "name": "from", "value": "", "type": "query", "description": "Start date for sentiment data (YYYY-MM-DD)." }, { "name": "to", "value": "", "type": "query", "description": "End date for sentiment data (YYYY-MM-DD)." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format (only 'json' is supported)." } ] }, "docs": "Retrieve sentiment analysis for financial news related to specified tickers." } ] }, { "info": { "name": "Interest Rates", "type": "folder" }, "items": [ { "info": { "name": "Get reference interest rates", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/rates/reference-rates", "params": [ { "name": "filter[code]", "value": "", "type": "query", "description": "Filter by reference rate code (e.g., 'SOFR')." }, { "name": "filter[currency]", "value": "", "type": "query", "description": "Filter by currency." }, { "name": "filter[from]", "value": "", "type": "query", "description": "Start date (YYYY-MM-DD)." }, { "name": "filter[to]", "value": "", "type": "query", "description": "End date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns benchmark reference interest rates (e.g., SOFR, SONIA, ESTR) by code and currency." }, { "info": { "name": "Get central bank policy rates", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/rates/policy-rates", "params": [ { "name": "filter[code]", "value": "", "type": "query", "description": "Filter by policy rate code." }, { "name": "filter[country]", "value": "", "type": "query", "description": "Filter by country." }, { "name": "filter[central_bank]", "value": "", "type": "query", "description": "Filter by central bank (e.g., 'FED', 'ECB')." }, { "name": "filter[from]", "value": "", "type": "query", "description": "Start date (YYYY-MM-DD)." }, { "name": "filter[to]", "value": "", "type": "query", "description": "End date (YYYY-MM-DD)." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns central bank policy (target) interest rates by code, country, and central bank." }, { "info": { "name": "Get funding-stress spreads", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/spreads/funding-stress", "params": [ { "name": "filter[code]", "value": "", "type": "query", "description": "Filter by spread code (e.g., 'SOFR_OIS')." }, { "name": "filter[from]", "value": "", "type": "query", "description": "Start date (YYYY-MM-DD)." }, { "name": "filter[to]", "value": "", "type": "query", "description": "End date (YYYY-MM-DD)." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns funding-stress spread series (in basis points) computed as the difference between two rate legs, with the underlying formula and leg values." } ] }, { "info": { "name": "Live (Delayed) Data", "type": "folder" }, "items": [ { "info": { "name": "Retrieve delayed real-time stock prices", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/real-time/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Ticker symbol with exchange code (e.g., 'AAPL.US')." }, { "name": "s", "value": "", "type": "query", "description": "Comma-separated list of additional ticker symbols for multiple requests in a single call (e.g., 'VTI,EUR.FOREX')." }, { "name": "ex", "value": "", "type": "query", "description": "Exchange code filter (e.g., 'US')." }, { "name": "fmt", "value": "", "type": "query", "description": "Response format. Options are 'json' and 'csv'. Defaults to JSON." } ] }, "docs": "Retrieve live (delayed) stock prices for specified ticker(s)." }, { "info": { "name": "Get US delayed stock quotes", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/us-quote-delayed", "params": [ { "name": "s", "value": "", "type": "query", "description": "Comma-separated ticker symbols (e.g., 'AAPL,MSFT,GOOGL')." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-separated list of fields to return (e.g., 'close,volume,change_p')." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns 15-minute delayed quote data for US equities. Supports multiple symbols in a single request." } ] }, { "info": { "name": "Sanctions", "type": "folder" }, "items": [ { "info": { "name": "Get sanctioned entities", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/sanctions/entities", "params": [ { "name": "source", "value": "", "type": "query", "description": "Filter by sanctions source." }, { "name": "type", "value": "", "type": "query", "description": "Filter by entity type." }, { "name": "program", "value": "", "type": "query", "description": "Filter by sanctions program code." }, { "name": "country", "value": "", "type": "query", "description": "Filter by country." }, { "name": "q", "value": "", "type": "query", "description": "Free-text search query (minimum 2 characters)." }, { "name": "active", "value": "", "type": "query", "description": "Filter by active listing status." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns sanctioned entities (individuals and organizations) aggregated from OFAC and other sanctions sources, including programs, aliases, and identifiers." }, { "info": { "name": "Get sanctioned vessels", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/sanctions/vessels", "params": [ { "name": "source", "value": "", "type": "query", "description": "Filter by sanctions source." }, { "name": "imo", "value": "", "type": "query", "description": "Filter by IMO number." }, { "name": "flag", "value": "", "type": "query", "description": "Filter by flag (country of registration)." }, { "name": "vessel_type", "value": "", "type": "query", "description": "Filter by vessel type." }, { "name": "q", "value": "", "type": "query", "description": "Free-text search query (minimum 2 characters)." }, { "name": "program", "value": "", "type": "query", "description": "Filter by sanctions program code." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset (records to skip)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page. Default 20, maximum 100." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns sanctioned vessels aggregated from OFAC and other sanctions sources, including IMO/MMSI identifiers, flag, and linked sanctioned entity." }, { "info": { "name": "Get sanctions programs", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/sanctions/programs", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns the list of sanctions programs with the count of listed entities per program." }, { "info": { "name": "Get sanctions sources", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/sanctions/sources", "params": [ { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns the list of sanctions data sources available in the dataset." } ] }, { "info": { "name": "Screening", "type": "folder" }, "items": [ { "info": { "name": "Get filtered stock data based on user-defined criteria.", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/screener", "params": [ { "name": "filters", "value": "", "type": "query", "description": "Filters to apply, structured as nested arrays (e.g., [[\"field\", \"operation\", value], ...])." }, { "name": "signals", "value": "", "type": "query", "description": "Signals to filter tickers by pre-calculated fields (e.g., 200d_new_hi, bookvalue_pos)." }, { "name": "sort", "value": "", "type": "query", "description": "Sorts results by a specified field in ascending or descending order (e.g., market_capitalization.desc)." }, { "name": "limit", "value": "", "type": "query", "description": "Number of results per request. Minimum 1, maximum 500. Default is 50." }, { "name": "offset", "value": "", "type": "query", "description": "Data offset for paginating results. Minimum 0, maximum 999. Default is 0." } ] }, "docs": "Retrieves stock data filtered by criteria such as market capitalization, exchange, sector, and more. Results can be sorted and paginated." }, { "info": { "name": "Search stocks, companies, and ISINs", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/search/:query", "params": [ { "name": "query", "value": "", "type": "path", "description": "The search query (e.g., 'AAPL', 'Amazon', or ISIN 'US3453708600')" }, { "name": "fmt", "value": "", "type": "query", "description": "Response format (e.g., 'json')" }, { "name": "limit", "value": "", "type": "query", "description": "Limit the number of results returned" }, { "name": "type", "value": "", "type": "query", "description": "Filter by security type." }, { "name": "exchange", "value": "", "type": "query", "description": "Filter by exchange code (e.g., 'US', 'LSE')." }, { "name": "bonds_only", "value": "", "type": "query", "description": "Set to 1 to return bonds only." } ] }, "docs": "Search for stocks, companies, or ISINs by a query (e.g., company name, stock symbol, or ISIN)" } ] }, { "info": { "name": "Technical", "type": "folder" }, "items": [ { "info": { "name": "Retrieve technical indicator data for a specified symbol.", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/technical/:ticker", "params": [ { "name": "ticker", "value": "", "type": "path", "description": "Symbol in the format {SYMBOL_NAME}.{EXCHANGE_ID}, e.g., AAPL.US for Apple Inc." }, { "name": "function", "value": "", "type": "query", "description": "The function to calculate the technical indicator (e.g., 'sma' for Simple Moving Average)." }, { "name": "period", "value": "", "type": "query", "description": "Number of data points used to calculate the indicator. Default is 50." }, { "name": "from", "value": "", "type": "query", "description": "Start date for data retrieval in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date for data retrieval in 'YYYY-MM-DD' format." }, { "name": "order", "value": "", "type": "query", "description": "Sort order of dates: 'a' for ascending, 'd' for descending. Default is ascending." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format, either 'json' or 'csv'. Default is 'json'." }, { "name": "splitadjusted_only", "value": "", "type": "query", "description": "For select functions, adjust data only for splits by setting to '1'. Default is '0'." }, { "name": "filter", "value": "", "type": "query", "description": "Retrieve only the last value by specifying 'last_ema' or 'last_volume' as the filter." } ] }, "docs": "Fetches technical indicator data, such as moving averages and other analytics, based on specified parameters." } ] }, { "info": { "name": "US Treasury", "type": "folder" }, "items": [ { "info": { "name": "Get US Treasury bill rates", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/ust/bill-rates", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date in 'YYYY-MM-DD' format." }, { "name": "filter[year]", "value": "", "type": "query", "description": "Filter by year (e.g., 2024)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns daily US Treasury bill rates (discount rates for 4-week, 8-week, 13-week, 17-week, 26-week, and 52-week bills)." }, { "info": { "name": "Get US Treasury long-term rates", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/ust/long-term-rates", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date in 'YYYY-MM-DD' format." }, { "name": "filter[year]", "value": "", "type": "query", "description": "Filter by year (e.g., 2024)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns US Treasury long-term average rates and extrapolation factors for maturities beyond 30 years." }, { "info": { "name": "Get US Treasury real yield curve rates", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/ust/real-yield-rates", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date in 'YYYY-MM-DD' format." }, { "name": "filter[year]", "value": "", "type": "query", "description": "Filter by year (e.g., 2024)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "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)." }, { "info": { "name": "Get US Treasury yield curve rates", "type": "http" }, "http": { "method": "GET", "url": "https://eodhd.com/api/ust/yield-rates", "params": [ { "name": "from", "value": "", "type": "query", "description": "Start date in 'YYYY-MM-DD' format." }, { "name": "to", "value": "", "type": "query", "description": "End date in 'YYYY-MM-DD' format." }, { "name": "filter[year]", "value": "", "type": "query", "description": "Filter by year (e.g., 2024)." }, { "name": "page[limit]", "value": "", "type": "query", "description": "Number of records per page." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Pagination offset." }, { "name": "fmt", "value": "", "type": "query", "description": "Output format." } ] }, "docs": "Returns daily US Treasury yield curve rates (constant maturity rates for 1-month through 30-year maturities)." } ] } ], "bundled": true }