Markets data API

Use the navigation to explore the various endpoints available on the Economic data API suite. Each endpoint section hosts its own documentation and demo area to help in forming more complicated requests.

Overview

The EcoEvents API suite makes available data pertaining to economic events as provided by 4cast.

Events

get /v1/events

Returns details on economic events. Events returned are filterable by startDate and endDate, countryCodes, keyword and market impact. Pagination is supported.

ParamWhereExampleDescriptionRequired?
startDateQuerystring2014-09-01Start date for the time period in ISO formatyes
endDateQuerystring2014-09-07End date for the time period in ISO format. Default will return events occurring only on the startDate.no
countryCodesQuerystringGB,USComma separated list of country codesno
impactQuerystringmediumImpact to filter by (low, medium, high)no
keywordQuerystringtradeFilters events by event name containing the given keywordno
startIndexQuerystring0Zero based index to start results returned. May be used in conjuction with numResults for paging.no
numResultsQuerystring10Number of results returnedno
orderByQuerystringStartDateSorts the results by the given value. Valid Inputs: startDate, eventName, unit, previous, forcast, market, actual, countryOrRegionno
sortDirQuerystringAscDetermines the sort direction. "asc" for ascending or "desc" for descending order.no
Example Requests
Auto-generated example using only required fields
//markets.ft.com/research/webservices/economicdata/v1/events?startDate=2014-09-01&source=befd8ca75ac4a20e
Output

Playground

//markets.ft.com/research/webservices/economicdata/v1/events?
Code goes here
Use this form to generate a query. Blank inputs will be excluded.
Start date for the time period in ISO format
startDate=
End date for the time period in ISO format. Default will return events occurring only on the startDate.
endDate=
Comma separated list of country codes
countryCodes=
Impact to filter by (low, medium, high)
impact=
Filters events by event name containing the given keyword
keyword=
Zero based index to start results returned. May be used in conjuction with numResults for paging.
startIndex=
Number of results returned
numResults=
Sorts the results by the given value. Valid Inputs: startDate, eventName, unit, previous, forcast, market, actual, countryOrRegion
orderBy=
Determines the sort direction. "asc" for ascending or "desc" for descending order.
sortDir=