Calendar API v2 (Deprecated)

Deprecated

This API version has been deprecated, please use the current version instead.

The purpose of this page is to return the main grid view of the events selected by the filter options. Inside each event, you can find "IdEcoCalendarDate". It represents the unique identifier for it event and is used for the detail request.

This call allows a configurable set of parameters than you can use:

In order to call a single eventdate you need to add the GUID of the eventdate as the final endpoint https://calendar.fxstreet.com/eventdate/{EVENT_DATE_ID}?

Parameters

All parameters are optional.

Format

Possible values:

  • html: html format.
  • xml: xml format.
  • json: json format.
  • jsonp: jsonp format.
  • jsonhtml: html format executable from another domain (like JSONP, but instead of returning a JSON object it returns an HTML code).
  • csv: csv format (only available on historic).

Useage: f=json

Sample: https://calendar.fxstreet.com/eventdate/?&f=json&view=day&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

View

Possible values:

  • Current: Displays n events (parameter 'rows'), tacking m from the past (parameter 'pastevents'), going k hours back (parameter 'hoursbefore').
  • Range: Displays events from a start date to a end
  • Day: Displays the events for the current day
  • Week: Displays the events for the current week
  • Month: Displays the events for the current month

Useage: view=day

Sample: https://calendar.fxstreet.com/eventdate/?view=day&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Start/End

Start date. Must be formated as yyyyMMdd.

Constraint: End - Start cannot be bigger than a year

Rows

Only applicable on view=current.

Integer positive. The number of rows to display.

Useage: rows=50

Sample: https://calendar.fxstreet.com/eventdate/?view=current&pastevents=10&hoursbefore=48&rows=50&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Hours before

Only applicable on view=current.

Integer positive. Max value 240.

The number maximum hours in the past to display.

Constraint: only works with view=current.

Useage: hoursbefore=48

Sample: https://calendar.fxstreet.com/eventdate/?view=current&pastevents=10&hoursbefore=48&rows=50&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Paste events

Only applicable on view=current.

Integer positive. Max value 100.

The number of events from the past.

Constraint: only works with view=current.

Useage: pastevents=10

Sample: https://calendar.fxstreet.com/eventdate/?view=current&pastevents=10&hoursbefore=48&rows=50&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Keyword

keyword filter. Must contain at least 3 non blank characters.

Columns

Only applicable on f=html.

you can choose what columns do you wish to show.

Possible values. Multiple selection (comma separated):

  • CountryCode
  • CountryName
  • CountryCurrency
  • Countdown

Useage: columns=CountryCode,CountryName,CountryCurrency

Sample: https://calendar.fxstreet.com/eventdate/?f=html&columns=CountryCode,CountryName,Countdown&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Countrycode

you can choose what countries do you wish to show. Multiple selection (comma separated).

Useage: countrycode=UK,EMU,US

AR
AU
AT
BE
BR
CA
CL
CN
CO
CZ
DK
EMU
FI
FR
DE
GR
HK
HU
IS
IN
ID
IE
IT
JP
MX
NL
NZ
NO
PL
PT
RO
RU
SG
SK
ZA
ES
SE
CH
TR
UK
US

Sample: https://calendar.fxstreet.com/eventdate/?countrycode=UK,EMU,US&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Categories

This parameter allows you to choose the cateogries.

Possible values. Multiple selection (comma separated):

  • c94405b5-5f85-4397-ab11-002a481c4b92. Central Banks.
  • 33303f5e-1e3c-4016-ab2d-ac87e98f57ca. Consump. & Inflation
  • e229c890-80fc-40f3-b6f4-b658f3a02635. Confidence Indices
  • 91da97bd-d94a-4ce8-a02b-b96ee2944e4c. Employment.
  • 24127f3b-edce-4dc4-afdf-0b3bd8a964be. Economic Activity.
  • fa6570f6-e494-4563-a363-00d0f2abec37. Liquidity & Balance.
  • e9e957ec-2927-4a77-ae0c-f5e4b5807c16. Government.

Useage: categories=c94405b5-5f85-4397-ab11-002a481c4b92,33303f5e-1e3c-4016-ab2d-ac87e98f57ca

Sample: https://calendar.fxstreet.com/eventdate/?categories=c94405b5-5f85-4397-ab11-002a481c4b92,33303f5e-1e3c-4016-ab2d-ac87e98f57ca&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Culture

Possible values:

  • en-us. English.
  • ru-ru. Russian.
  • ar-ae. Arabic.
  • zh-cn. Simplified Chinesse.
  • zh-cht. Traditional Chinesse
  • id-id. Indonesian.
  • tr-tr. turkish.
  • hu-hu. Hungarian.
  • fr-fr. French.
  • de-de. German.
  • pt-pt. Portuguese.
  • it-it. Italian.
  • ja-jp. Japanese
  • es-es. Spanish.
  • ca-es. Catalan.
  • pl-pl. Polish.
  • vi-vn. Vientamese.

Useage: culture=ja-jp

Sample: https://calendar.fxstreet.com/eventdate/?culture=ja-jp&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

Timezone

You can find the possible values in:

https://calendar.fxstreet.com/country/GetTimeZones?v=2&f=json

https://calendar.fxstreet.com/country/GetTimeZones?v=2

Useage: timezone=South+Africa+Standard+Time

Sample: https://calendar.fxstreet.com/eventdate/?timezone=South+Africa+Standard+Time&k={YOUR_CLIENT_KEY}&s={HASH}&t={TIMESTAMP}

event dates at glance

<EventDateModel>
<IdEcoCalendarType>e229c890-80fc-40f3-b6f4-b658f3a02635</IdEcoCalendarType>
<EcoCalendarType>Confidence Indices</EcoCalendarType>
<IdEcoCalendar>5c290d7e-aac7-406f-b40a-40913fd19118</IdEcoCalendar>
<IdEcoCalendarDate>ebcc4514-b920-4ff3-9a64-bfb944930a2d</IdEcoCalendarDate>
<DateTime>
<Date>2012-06-27T06:00:00Z</Date>
</DateTime>
<InternationalCode>FI </InternationalCode>
<Country>Finland</Country>
<IdCountry>76fb5056-2704-4aad-b81e-c21b367cc5f7</IdCountry>
<Name>Consumer Confidence</Name>
<HTMLDescription>The Consumer Confidence released by the <a href="https://www.stat.fi/index_en.html">Statistics Finland </a> is a leading index that measures the level of consumer confidence in economic activity. A high level of consumer confidence stimulates economic expansion while a low level drives to economic downturn. A high reading is seen as positive (or bullish) for the EUR, while a low reading is seen as negative (or bearish).</HTMLDescription>
<Preliminar>false</Preliminar>
<ForType>8b033ce1-b224-41ac-8d2d-7e69516b34c5</ForType>
<For>
<Date>2012-06-01T00:00:00</Date>
</For>
<Volatility>1</Volatility>
<Actual>5.8</Actual>
<Consensus xsi:nil="true"/>
<Relation>true</Relation>
<Previous>12</Previous>
<Revised xsi:nil="true"/>
<Better>false</Better>
<Worst>false</Worst>
<Tentative>false</Tentative>
<AllDay>false</AllDay>
<HasMetadata>false</HasMetadata>
<HasOlsenScale>true</HasOlsenScale>
<HasCountries>false</HasCountries>
<HasReports>false</HasReports>
<HasNews>false</HasNews>
<HasAdvancedNews>false</HasAdvancedNews>
<HasRelateds>false</HasRelateds>
<HasWebinars>false</HasWebinars>
<HasLiveCoverage>false</HasLiveCoverage>
<HasBlogs>false</HasBlogs>
<HasHistory>true</HasHistory>
<HasAutochartist>false</HasAutochartist>
<HasPairs>false</HasPairs>
<DisplayActual>5.8</DisplayActual>
<DisplayPrevious>12.0</DisplayPrevious>
<DisplayConsensus/>
<DisplayRevised/>
<Precision>1</Precision>
</EventDateModel>

Nodes

  • IdEcoCalendarType Indicates the type of the event.
  • EcoCalendarType The description of the IdEcoCalendarType.
  • IdEcoCalendar The Id of the event. There are multiples dates for this Id.
  • IdEcoCalendarDate The Id of the event for this date. You need this Id to make detail calls.
  • DateTime Date time.
  • InternationalCode International code of the country.
  • Country Country name.
  • IdCountry The Id of the country.
  • Name Name of the event.
  • HTMLDescription HTML description of the event.
  • Preliminar The event is preliminar.
  • ForType It can be one of the following values:
    • Null: no effect
    • E18CF035-44CE-4D43-A15E-1EF81091E130: Day
    • 8B033CE1-B224-41AC-8D2D-7E69516B34C5: Month
    • 4E9C6743-49EA-4205-A89D-E31F28B9F0DF: Quarter
  • For A particular day or period of time the event relates to (eg. PPI for March, Trade Balance for the Q3).
  • Volatility It can be 0, 1, 2 or 3 (0 = no volatility, 3 = max volatility. Represents the impact of the event on the marketplace).
  • Actual The actual value of the event.
  • Conscensus The consensus for the actual of the event.
  • Relation It compares the actual value with the consensus. True: if the actual is greater than the consensus means that the result is better than expected. False: if the - actual is greater than the concensus means that the result is worse than expected. Can be null: no relation.
  • Previous The previous value for this event.
  • Revised The actual was revised from this value.
  • Better The actual is better than the consensus (see relation).
  • Worst The actual is worst than the consensus (see relation).
  • Tentative The date for this event is approximate.
  • AllDay The event is for all the day.
  • HasMetadata Can be true/false: True: there is more data for this event.
  • HasOlsenScale Can be true/false: True: there is an Olsen Scale for that event.
  • HasCountries Can be true/false: True: there is country info for that event.
  • HasReports Can be true/false: True: there are reports for that event.
  • HasNews Can be true/false: True: there are news for that event.
  • HasAdvancedNews Can be true/false: True: there are advanced news for that event.
  • HasRelateds Can be true/false: True: there are relateds for that event.
  • HasWebinars Can be true/false: True: there is a webinar for that event.
  • HasLiveCoverage Can be true/false: True: there is a live coverage for that event.
  • HasBlogs Can be true/false: True: there are blogs for that event.
  • HasHistory Can be true/false: True: there is a history for that event.
  • HasAutochartist Can be true/false: True: there is an Autochartist for that event.
  • HasPairs Can be true/false: True: there is an Autochartist for that event.
  • DisplayActual Actual in string format.
  • DisplayPrevious Previous in string format.
  • DisplayConsensus Consensus in string format.
  • DisplayRevised Revised in string format.
  • Precision Number of decimals.

Samples