Available with: All-In-One and Fundamentals Data Feed packages.
Consumption: Each request consumes 1 API call.

Sign up & Get Data

The Economic Events Data API provides past and future events like Retail Sails, Bond Auctions, PMI Releases, and many other economic events from countries around the world. The data is available from 2020.

To get economic events data, please use the following URL:

URL
cURL
PHP
Python
R
https://eodhd.com/api/economic-events?api_token=demo&fmt=json
curl --location "https://eodhd.com/api/economic-events?api_token=demo&fmt=json"
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/economic-events?api_token=demo&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();
}
import requests

url = f'https://eodhd.com/api/economic-events?api_token=demo&fmt=json'
data = requests.get(url).json()

print(data)
library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/economic-events?api_token=demo&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")
}

Possible parameters:

  • api_token. String. REQUIRED. Your API KEY, which you will get after you subscribe to our services.
  • from and to. String. Optional. The format is ‘YYYY-MM-DD’. If you need data from Jan 5, 2020, to Feb 10, 2020, you should use from=2020-01-05 and to=2020-02-10.
  • country. String. OPTIONAL. The country code is in ISO 3166 format, has 2 symbols.
  • comparison. String. OPTIONAL. Possible values: mom, qoq, yoy.
  • offset. Integer. OPTIONAL. Possible values from 0 to 1000. Default value: 0.
  • limit. Integer. OPTIONAL. Possible values from 0 to 1000. Default value: 50.

An example of the economic events API output:

Economic Events Calendar

You can also read more about our Fundamental Data.

Sign up & Get Data