{"id":141,"date":"2019-04-01T20:19:00","date_gmt":"2019-04-01T18:19:00","guid":{"rendered":"https:\/\/eodhd.com\/knowledgebase\/?p=141"},"modified":"2026-08-20T09:56:59","modified_gmt":"2026-08-20T07:56:59","slug":"bulk-api-eod-splits-dividends","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/bulk-api-eod-splits-dividends","title":{"rendered":"Bulk API for EOD, Splits and Dividends"},"content":{"rendered":"\n

One request, one exchange, one day. Instead of looping over thousands of tickers to close your books, this endpoint returns the whole market in a single download \u2014 end-of-day prices, or every split, or every dividend that landed on that date. A full US day \u2014 18 August 2026, to name the one measured here \u2014 is 44,376 rows<\/strong>, delivered as a 2.3 MB CSV or a 6.7 MB JSON file.<\/p>\n\n\n\n

The same endpoint serves three datasets through the type<\/strong> parameter, and it reaches back decades rather than only to the last session: 2 January 1990 returns 2,197 US rows, 15 June 2000 returns 13,860, and non-US venues go back too \u2014 303 rows on XETRA for that day in 2000, 425 on the LSE for 1 March 1995. The row count is itself a record of how coverage grew.<\/p>\n\n\n\n\n\n

\n <\/svg><\/span>\n
\n\n

Cost is worth understanding before you write the loop. A whole-exchange request is a flat 100 API calls<\/strong> regardless of how many rows come back, while adding the symbols parameter charges 100 plus one call per ticker<\/strong> \u2014 measured at 102 calls for two tickers and 104 for four. Asking for a handful of names through this endpoint is therefore more<\/em> expensive than taking the entire exchange, and far more expensive than the single call each ticker costs on the End-of-Day API<\/a>. Use symbols for convenience, not to save quota.<\/p>\n\n<\/div>\n <\/div>\n \n\n

\n <\/svg><\/span>\n
\n\n

Bulk downloads are not part of the Free plan, and each dataset carries the entitlement of its per-ticker equivalent: prices need the end-of-day feed, splits the splits feed, dividends the dividends feed. A plan with prices but not corporate actions will serve the first and refuse the other two. The sidebar lists the plans that include all three.<\/p>\n\n<\/div>\n <\/div>\n \n\n\n

<\/div>\n\n\n\n

End-of-day prices for a whole exchange<\/h2>\n\n\n
\n
https:\/\/eodhd.com\/api\/eod-bulk-last-day\/US?api_token=YOUR_API_TOKEN&fmt=json<\/code><\/pre>\n<\/div>\n\n\n
Path Parameter<\/h4>\n\n\n
\n    \n
\n    
\n                    exchangeCode<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        Exchange code from the Exchanges API, for example US, XETRA or WAR. Four US venue codes are also accepted \u2014 NYSE, NASDAQ, BATS and AMEX \u2014 and return only that venue. An unknown code returns HTTP 404 with the body Exchange Not Found.<\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n\n
Query Parameters<\/h4>\n\n\n
\n    \n
\n    
\n                    api_token<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        Your EODHD API token<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    type<\/code>\n        \n                    enum<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Which dataset to return. Allowed values: eod, splits, dividends. Any other value currently returns HTTP 500 with a generic error body rather than a validation error<\/span>\n                    (Default: eod)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    date<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        The day to download, YYYY-MM-DD. Two silent fallbacks: a past non-trading day returns the previous trading day relative to the date you asked for (a Sunday gave the Friday, US Independence Day 2026 gave 2 July, Christmas 2020 gave 24 December), while a future date returns the latest available day instead. Read the date field in the response rather than assuming. An unparseable value returns HTTP 422 with a validation error naming the date field<\/span>\n                    (Default: last trading day)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    symbols<\/code>\n        \n                    string<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Comma-separated tickers instead of the whole exchange. Suffixes are honoured and may cross exchanges \u2014 MSFT,AAPL,BMW.XETRA,SAP.F returns all four in one response, and the exchange in the path stops mattering (the same pair came back through the US, NASDAQ, XETRA and WAR paths alike). Ignored when type is splits or dividends<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    fmt<\/code>\n        \n                    enum<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Response format. Allowed values: json, csv. JSON carries fields CSV does not \u2014 prev_close, change and change_p on prices, and most of the dividend record \u2014 so pass fmt=json when you need them<\/span>\n                    (Default: csv)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    filter<\/code>\n        \n                    enum<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Set to extended for company name, market capitalisation and technical fields. See the extended dataset section<\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n    
\n        <\/svg><\/span>\n        
\n\n
The four US venue codes cover the exchange one level down, and they carve it up cleanly: on 18 August 2026 NYSE returned 5,853 rows, NASDAQ 5,365, BATS 1,512 and AMEX 284, with no ticker appearing in two of them<\/strong> and all 13,014 also present in the composite. The composite is much larger, though \u2014 44,376 rows \u2014 so 31,362 tickers, OTC and similar venues among them, are reachable only through US<\/strong>. Note also that every row still reports the exchange as US<\/strong>: the venue lives in the path, not in the data. Codes outside those four behave unevenly \u2014 NMFQS, OTCQB, PINK and NYSEARCA all return 404, OTC returns HTTP 200 with an empty array, and NYSE ARCA returns a payload byte-identical to NYSE.<\/p>\n\n<\/div>\n    <\/div>\n    \n\n\n
Request Example<\/h4>\n\n\n    
\n                
\n            
\n                                                                        URL<\/button>\n                                                                            cURL<\/button>\n                                                                            PHP<\/button>\n                                                                            Python<\/button>\n                                                                            R<\/button>\n                                                                            Chat GPT<\/button>\n                                                <\/div>\n            
\n