{"id":8040,"date":"2026-07-16T10:38:00","date_gmt":"2026-07-16T08:38:00","guid":{"rendered":"https:\/\/eodhd.com\/financial-apis\/?p=8040"},"modified":"2026-08-20T09:57:11","modified_gmt":"2026-08-20T07:57:11","slug":"congressional-trades-api","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/congressional-trades-api","title":{"rendered":"Congressional Trades API (beta)"},"content":{"rendered":"\n

The EODHD Congressional Trades API returns stock-trade disclosures filed by members of the US Congress. Under the STOCK Act, senators and representatives must publicly disclose their securities transactions within 45 days. EODHD collects these filings directly from the two official government portals \u2014 the Senate Electronic Financial Disclosure system and the House Clerk disclosure site \u2014 normalises them into a single schema, and serves both chambers through one endpoint.<\/p>\n\n\n\n

Each record pairs the trading member with the traded asset and the transaction, and adds fields the raw filings do not provide directly: numeric bounds parsed from the disclosed amount range, the number of days between the trade and its disclosure, a flag for filings that missed the 45-day window, and a link back to the original filing for verification.<\/p>\n\n\n\n

<\/p>\n\n\n\n

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

Overview<\/h2>\n\n\n\n

The endpoint is reached over HTTPS with a GET request and authenticated by an api_token query parameter, the same token used across the EODHD API. It returns a JSON object with three top-level keys: data (the array of trade records), meta (the number of rows matching the filter across all pages, plus the offset and limit of the page you received), and links (the path of the next page, when one exists). Results are paged with page[offset] and page[limit], where the default page size is 20 rows and the maximum is 100.<\/p>\n\n\n

\n
https:\/\/eodhd.com\/api\/congressional-trades?api_token=YOUR_TOKEN<\/code><\/pre>\n<\/div>\n\n\n
Records are always returned newest first, ordered by transaction date descending. The order is fixed \u2014 there is no sort parameter, so narrow a result set with the filters below rather than by re-ordering it. A handful of filings carry a mistyped transaction date that falls in the future, and descending order puts them at the very top of an unfiltered request, so set transaction_date_to to today’s date when you want a clean first page. JSON is the only output format; there is no fmt parameter, and any unrecognised query parameter is ignored rather than rejected.<\/p>\n\n\n    
\n        <\/svg><\/span>\n        
\n\n
Filter parameters are passed as flat query keys, for example chamber=senate and transaction_type=purchase,sale. Only the two pagination parameters use bracket notation: page[offset] and page[limit]. Recognised parameters are validated at the gateway, so an invalid value returns HTTP 422 before the request reaches the data service.<\/p>\n\n<\/div>\n    <\/div>\n    \n\n\n
<\/div>\n\n\n\n
Coverage and History<\/h2>\n\n\n\n
History goes back to the first electronic periodic transaction reports published under the STOCK Act, which took effect in 2012. Both chambers appear from 2012 onwards, with sparse coverage before 2014 while electronic filing was still being adopted. The figures below were measured in August 2026 and grow with every new filing.<\/p>\n\n\n\n
Measure<\/th>Value<\/th><\/tr><\/thead>
Earliest transaction<\/td>14 June 2012<\/td><\/tr>
Most recent transaction<\/td>6 August 2026, disclosed 17 August 2026<\/td><\/tr>
Total trade records<\/td>45,561<\/td><\/tr>
House \/ Senate<\/td>31,611 \/ 13,878<\/td><\/tr>
Purchases \/ sales \/ exchanges<\/td>23,068 \/ 22,177 \/ 316<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Annual volume is sparse at the start and then becomes continuous: 2012 contributes 8 trades and 2013 contributes 123. From 2014 the record runs without gaps \u2014 1,486 trades that year, then roughly 2,900 to 4,800 per year through 2024, with 2025 the heaviest year so far at 7,379. For a study that needs a uniform history, 2014 is the practical starting point; 2012 and 2013 are better treated as a fragment than as full years.<\/p>\n\n\n\n
Every count above can be reproduced from the API itself, so you never have to rely on this page being current. Request a date window and read total from the meta object \u2014 this returns the number of trades that took place during the 2025 calendar year:<\/p>\n\n\n
\n
https:\/\/eodhd.com\/api\/congressional-trades?api_token=YOUR_TOKEN&transaction_date_from=2025-01-01&transaction_date_to=2025-12-31&page%5Blimit%5D=1<\/code><\/pre>\n<\/div>\n\n\n
Freshness follows the source, not the market. A trade appears once the member files it, and the STOCK Act allows up to 45 days for that, so the newest transaction date in the feed trails the current date by days to weeks. Filings are collected four times on each weekday, at 00:00, 06:00, 12:00 and 19:00 UTC, with a separate reconciliation pass at 03:00 UTC that re-reads recent filings and picks up amendments.<\/p>\n\n\n    
\n        <\/svg><\/span>\n        
\n\n
To load the full history once, page through the endpoint with no date filter except transaction_date_to set to today, using the maximum page size of 100 and following the next link until it is absent. After that, refresh a rolling recent window rather than only appending: a filing amended at the source is corrected in place, so rows you already hold can change. For backtesting, remember that a trade only becomes public on its disclosure date \u2014 filter on disclosure_date_from and disclosure_date_to to reconstruct what was actually knowable at a point in time, and treat transaction_date as the event date rather than the date the information was available.<\/p>\n\n<\/div>\n    <\/div>\n    \n\n\n
<\/div>\n\n\n\n
Request<\/h2>\n\n\n\n
All parameters are optional except api_token. Filters combine with logical AND, and the member, date-range, symbol, and transaction-type filters can be used together to narrow the result set.<\/p>\n\n\n\n
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                    symbol<\/code>\n        \n                    string<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Restrict to a single ticker symbol, for example AAPL. Records whose asset carries no ticker are excluded by this filter<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    chamber<\/code>\n        \n                    enum<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Chamber of Congress, lower case. Allowed values: senate, house<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    bioguide_id<\/code>\n        \n                    string<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Congressional Biographical Directory ID of a single member, for example S000250. Format is one upper-case letter followed by six digits<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    transaction_type<\/code>\n        \n                    enum<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        One or more transaction types, comma-separated, for example purchase,sale. Allowed values: purchase, sale, exchange<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    transaction_date_from<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Earliest transaction date, YYYY-MM-DD, inclusive<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    transaction_date_to<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Latest transaction date, YYYY-MM-DD, inclusive, on or after transaction_date_from<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    disclosure_date_from<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Earliest disclosure date, YYYY-MM-DD, inclusive<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    disclosure_date_to<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Latest disclosure date, YYYY-MM-DD, inclusive, on or after disclosure_date_from<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    page[limit]<\/code>\n        \n                    integer<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Rows per page<\/span>\n                    (Default: 20, Range: 1-100)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    page[offset]<\/code>\n        \n                    integer<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Rows to skip<\/span>\n                    (Default: 0)<\/em><\/span>\n            <\/div>\n<\/div>\n\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