{"id":3653,"date":"2021-11-24T23:19:45","date_gmt":"2021-11-24T22:19:45","guid":{"rendered":"https:\/\/eodhd.com\/financial-apis\/?p=3653"},"modified":"2026-04-20T17:10:21","modified_gmt":"2026-04-20T15:10:21","slug":"economic-events-data-api","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/economic-events-data-api","title":{"rendered":"Economic Events Data API"},"content":{"rendered":"\n

Sign up & Get Data<\/span><\/a><\/p>\n\n\n\n

The Economic Events Data API provides past and future events like Retail Sales, Bond Auctions, PMI Releases, and many other economic events from countries around the world. The data is available from 2020.<\/p>\n\n\n\n\n\n\n\n

API Endpoint<\/h2>\n\n\n\n

To get economic events data, use the following URL:<\/p>\n\n\n\n\n

\n
\n
URL<\/div>\n
cURL<\/div>\n
PHP<\/div>\n
Python<\/div>\n
R<\/div>\n
Chat GPT<\/div>\n <\/div>\n
\n
\n
\n \n \n <\/use>\n <\/svg>\n <\/button>\n \n \n <\/use>\n <\/svg>\n <\/button>\n <\/div>\n 
https:\/\/eodhd.com\/api\/economic-events?api_token=demo<\/span>&fmt=json<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
curl --location \"https:\/\/eodhd.com\/api\/economic-events?api_token=demo<\/span>&fmt=json\"<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n    CURLOPT_URL => 'https:\/\/eodhd.com\/api\/economic-events?api_token=demo<\/span>&fmt=json',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_ENCODING => '',\n    CURLOPT_MAXREDIRS => 10,\n    CURLOPT_TIMEOUT => 0,\n    CURLOPT_FOLLOWLOCATION => true,\n    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n    CURLOPT_CUSTOMREQUEST => 'GET',\n));\n\n$data = curl_exec($curl);\ncurl_close($curl);\n\ntry {\n    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);\n    var_dump($data);\n} catch (Exception $e) {\n    echo 'Error. '.$e->getMessage();\n}<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
\nimport requests\n\nurl = f'https:\/\/eodhd.com\/api\/economic-events?api_token=demo<\/span>&fmt=json'\ndata = requests.get(url).json()\n\nprint(data)<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
\nlibrary(httr)\nlibrary(jsonlite)\n\nurl <- 'https:\/\/eodhd.com\/api\/economic-events?api_token=demo<\/span>&fmt=json'\nresponse <- GET(url)\n\nif (http_type(response) == \"application\/json\") {\n    content <- content(response, \"text\", encoding = \"UTF-8\")\n    cat(content)\n} else {\n    cat(\"Error while receiving data\\n\")\n}<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                        
\n                
\n                    \n                        \n                            <\/use>\n                        <\/svg>\n                    <\/a>\n                <\/div>\n                
\n                    New to coding? Our ChatGPT assistant can generate code in any language tailored to our API.\n                    Simply describe how you want to use our data, and get a working piece of code.\n                    Don\u2019t forget to replace the API token with your own.

\n                    Try it now (it's free)!<\/a>

\n                    \n                        How to use it (YouTube)\n                    <\/a>\n                <\/div>\n            <\/div>\n        <\/div>\n    <\/div>\n\n    \n\n\n\n
Request Parameters<\/h2>\n\n\n\n
Parameter<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
api_token<\/td>String<\/td>Yes<\/td>Your API key.<\/td><\/tr>
from<\/td>String<\/td>No<\/td>Start date in YYYY-MM-DD format.<\/td><\/tr>
to<\/td>String<\/td>No<\/td>End date in YYYY-MM-DD format.<\/td><\/tr>
country<\/td>String<\/td>No<\/td>Country code in ISO 3166 format (2 characters, e.g. US, GB, JP).<\/td><\/tr>
comparison<\/td>String<\/td>No<\/td>Comparison type: mom<\/strong> (month-over-month), qoq<\/strong> (quarter-over-quarter), yoy<\/strong> (year-over-year).<\/td><\/tr>
type<\/td>String<\/td>No<\/td>Event type filter (e.g. &type=House%20Price%20Index).<\/td><\/tr>
offset<\/td>Integer<\/td>No<\/td>Pagination offset. Values: 0\u20131000. Default: 0.<\/td><\/tr>
limit<\/td>Integer<\/td>No<\/td>Number of results. Values: 0\u20131000. Default: 50.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Response Fields<\/h2>\n\n\n\n
The API returns a JSON array of economic event objects. Each object contains the following fields:<\/p>\n\n\n\n
Field<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
type<\/td>String<\/td>Type of economic event (e.g. “GDP Growth Rate”, “Nonfarm Payrolls”).<\/td><\/tr>
comparison<\/td>String or null<\/td>Comparison type: “mom”, “qoq”, “yoy”, or null if not applicable.<\/td><\/tr>
period<\/td>String or null<\/td>Period associated with the event (e.g. “Q4”, “Jan”, “May”), or null if not applicable.<\/td><\/tr>
country<\/td>String<\/td>Country code in ISO 3166 format (e.g. “US”, “JP”).<\/td><\/tr>
date<\/td>String<\/td>Date and time of the event in YYYY-MM-DD HH:MM:SS format.<\/td><\/tr>
actual<\/td>Number or null<\/td>Actual reported value.<\/td><\/tr>
previous<\/td>Number or null<\/td>Previous value for the same event.<\/td><\/tr>
estimate<\/td>Number or null<\/td>Estimated (forecast) value.<\/td><\/tr>
change<\/td>Number or null<\/td>Change from previous value.<\/td><\/tr>
change_percentage<\/td>Number or null<\/td>Percentage change from previous value.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Response Example<\/h2>\n\n\n\n            
\n                
\n                    \n
[\n  {\n    \"type\": \"Capital Expenditure\",\n    \"comparison\": \"yoy\",\n    \"period\": \"Q4\",\n    \"country\": \"JP\",\n    \"date\": \"2025-03-03 23:50:00\",\n    \"actual\": -0.2,\n    \"previous\": 8.1,\n    \"estimate\": 4.9,\n    \"change\": -8.3,\n    \"change_percentage\": -102.469\n  },\n  {\n    \"type\": \"Jobs\/applications ratio\",\n    \"comparison\": null,\n    \"period\": \"Jan\",\n    \"country\": \"JP\",\n    \"date\": \"2025-03-03 23:30:00\",\n    \"actual\": 1.26,\n    \"previous\": 1.25,\n    \"estimate\": 1.25,\n    \"change\": 0.01,\n    \"change_percentage\": 0.8\n  }\n]<\/code><\/pre>\n\n                <\/div>\n                
\n