REVIEW COPY — End-of-Day Historical Data API

The End-of-Day Historical Data API returns the daily price history of a single instrument: open, high, low, close, adjusted close and volume, one row per trading day, for stocks, ETFs, mutual funds, indices, forex pairs and cryptocurrencies. You can aggregate the same series into weekly or monthly bars, slice it by date, sort it either way, or reduce it to a single number.

History is deep. The S&P 500 series starts on 30 December 1927 and carries 24,794 daily bars; the oldest US common stocks we hold begin on 2 January 1962. Every figure on this page was measured against the live API on 17 September 2026, and every request example runs as written.

End-of-Day Historical Data

https://eodhd.com/api/eod/{SYMBOL}?api_token=YOUR_API_TOKEN&fmt=json

Method GET. Authentication is by api_token in the query string. The default output format is CSV; add fmt=json for a JSON array. With no date range, the response is the instrument’s entire history.

Path Parameter

Query Parameters

Request Example

URL cURL PHP Python R Chat GPT

https://eodhd.com/api/eod/MCD.US?api_token=demo&from=2024-01-02&to=2024-01-05&period=d&fmt=json

(Sign up for free to get an API token)

curl --location "https://eodhd.com/api/eod/MCD.US?api_token=demo&from=2024-01-02&to=2024-01-05&period=d&fmt=json"

(Sign up for free to get an API token)

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/eod/MCD.US?api_token=demo&from=2024-01-02&to=2024-01-05&period=d&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}

(Sign up for free to get an API token)

import requests

url = f'https://eodhd.com/api/eod/MCD.US?api_token=demo&from=2024-01-02&to=2024-01-05&period=d&fmt=json'
data = requests.get(url).json()

print(data)

(Sign up for free to get an API token)

library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/eod/MCD.US?api_token=demo&from=2024-01-02&to=2024-01-05&period=d&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}

(Sign up for free to get an API token)

New to coding? Our ChatGPT assistant can generate code in any language tailored to our API. Simply describe how you want to use our data, and get a working piece of code. Don’t forget to replace the API token with your own.

Try it now (it's free)!

How to use it (YouTube)

Response Example, JSON

The first two of the four rows the request above returns:

[
  {
    "date": "2024-01-02",
    "open": 295.05,
    "high": 297.28,
    "low": 295.05,
    "close": 297.04,
    "adjusted_close": 277.9465,
    "volume": 4458400
  },
  {
    "date": "2024-01-03",
    "open": 297,
    "high": 297.99,
    "low": 294.25,
    "close": 294.39,
    "adjusted_close": 275.4668,
    "volume": 3114800
  }
]

Response Example, CSV

Drop fmt=json and the same request returns CSV with a header row — the format Excel, Google Sheets and pandas read without any parsing code:

Date,Open,High,Low,Close,Adjusted_close,Volume
2024-01-02,295.05,297.28,295.05,297.04,277.9465,4458400
2024-01-03,297,297.99,294.25,294.39,275.4668,3114800
2024-01-04,295.32,297.27,290.92,291.74,272.9872,4615400
2024-01-05,289.21,290.33,287.2,288.99,270.4139,3407300

Response Fields

Aggregation is arithmetic, not a separate feed. The weekly bar for the week of 2 January 2024 on MCD.US opens at 295.05 (Tuesday’s open), closes at 288.99 (Friday’s close), spans a high of 297.99 and a low of 287.20, and reports a volume of 15,595,900 — exactly the sum of the four daily volumes above.

Raw, Split-Adjusted and Fully Adjusted Prices

This is the single most common source of confusion with end-of-day data, so it is worth being precise. The OHLC fields are raw — the prices as they printed on the tape that day, with no adjustment for anything. The adjusted_close field is adjusted for both splits and dividends. The volume field is adjusted for splits only.

Apple’s 4-for-1 split on 31 August 2020 makes the three views easy to see. All three rows below are the same trading day, 27 August 2020:

500.04 divided by four is 125.01, which is why a chart of raw closes shows a 75% crash on 31 August 2020 that never happened. The further step down to 121.1519 is the accumulated dividend adjustment. Volume is identical in all three rows because it is already split-adjusted in the base series. If you need OHLC adjusted for splits but not dividends, use the Technical API with function=splitadjusted; the split and dividend events themselves come from the Splits and Dividends API.

Symbols, Exchanges and History Depth

Tickers follow the SYMBOL.EXCHANGE convention, where the suffix is our exchange code rather than a MIC — US for all American venues, LSE for London, XETRA for Frankfurt, PA for Euronext Paris, NSE for India, FOREX for currency pairs, CC for crypto and INDX for indices. The full list comes from the Exchanges API, the tickers inside one exchange from its symbol list, and if you only know a company name, the Search API resolves it.

The table below is a live sample across asset classes, measured on 17 September 2026 — first available bar and total number of daily bars returned by a single request:

Mutual funds are covered too and behave like any other symbol, except that volume is reported as zero because funds do not trade on an order book.

Single Value Output

The filter parameter collapses the response to one value — the latest date, open, high, low, close or volume. It is built for spreadsheets: a single cell formula such as Excel’s WEBSERVICE or Google Sheets’ IMPORTDATA gets a number it can use directly, with nothing to parse.

URL cURL PHP Python R Chat GPT

https://eodhd.com/api/eod/MCD.US?api_token=demo&filter=last_close&fmt=json

(Sign up for free to get an API token)

curl --location "https://eodhd.com/api/eod/MCD.US?api_token=demo&filter=last_close&fmt=json"

(Sign up for free to get an API token)

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/eod/MCD.US?api_token=demo&filter=last_close&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}

(Sign up for free to get an API token)

import requests

url = f'https://eodhd.com/api/eod/MCD.US?api_token=demo&filter=last_close&fmt=json'
data = requests.get(url).json()

print(data)

(Sign up for free to get an API token)

library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/eod/MCD.US?api_token=demo&filter=last_close&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}

(Sign up for free to get an API token)

New to coding? Our ChatGPT assistant can generate code in any language tailored to our API. Simply describe how you want to use our data, and get a working piece of code. Don’t forget to replace the API token with your own.

Try it now (it's free)!

How to use it (YouTube)

The two output formats differ here, which matters if you are parsing the result. With fmt=json the body is a bare JSON scalar — a number such as 248.56 for last_close, or a quoted date string such as “2026-09-16” for last_date. In CSV, the default, the body is two lines: a header reading Value, then the number. A filtered request still costs one API call.

End-of-Day Historical Prices Update Time

We update each stock exchange 2-3 hours after the market closes. Major US exchanges, NYSE and NASDAQ, are updated within 15 minutes after the market closes. US mutual funds, PINK, OTCBB, and some indices update only the next morning, starting at 3-4 am ET and usually ending at 5-6 am ET. For these symbols we always hold the updated price up to 3-4 am.

Instruments that never close are the exception. Crypto and forex pairs trade around the clock, so their last bar is the current UTC day while every equity, index and fund still shows the previous session — at 06:51 UTC on 17 September 2026, BTC-USD.CC and EURUSD.FOREX were already stamped 2026-09-17 while every exchange-traded symbol read 2026-09-16. Treat the last row of a 24/7 series as a partial bar that is still being written, not a settled close.

Errors

Under the demo token the entitlement check runs before the symbol lookup, so an unknown ticker comes back as 403, not 404. Use your own token when you are testing error handling.

A 404 is billed like any other request — one API call — so a loop over an unverified ticker list consumes your daily allowance at the same rate as a loop over a good one. Check the list against the Exchanges API first.

Plans and API Calls

End-of-day data is included in every paid plan. The free plan gives you the same endpoint for any ticker, but only the past year of history and 20 API calls a day. Each request — whatever its length, and including a 404 — costs one API call against your daily limit. Requests are also capped per minute, independently of the call budget. The full accounting of calls, requests and daily limits is on the API Limits page, and the live counter for your own account is on the dashboard.

Sign up & Get Data

Related APIs

• Bulk API — end-of-day prices for an entire exchange on one date, instead of one symbol at a time.
• Live (Delayed) API — today’s price while the session is still open, before the end-of-day bar exists.
• Intraday Historical Data API — 1-minute, 5-minute and hourly bars.
• Splits and Dividends API — the corporate actions behind the adjustment, with their exact dates and ratios.
• Technical API — split-adjusted OHLC, plus indicators computed server-side on this same series.
• Exchanges API — exchange codes and the symbol list for each one.
• US Stock Symbol Rename History API — where a renamed US ticker’s history went.