Catalyst: Multi-Asset Economic Calendar
============================================================
⚠️ IMPORTANT — READ BEFORE USING ⚠️
============================================================
⚠️ Catalyst is an educational and analytical tool. It is not financial advice, a trading system or a signal service. It does not generate buy or sell signals, and nothing it displays is a recommendation to trade.
⚠️ The calendar shows scheduled events and released economic data — not predictions. Impact ratings, colours, figures and alerts do not tell you whether price will rise, fall or reverse. A Critical event does not guarantee a large move, and a favourable data change is not a buy signal.
⚠️ Use this tool to help plan your session, not as a replacement for official sources. Schedules can change, coverage can be incomplete, and figures may be delayed, missing or revised. Accuracy and completeness cannot be guaranteed. Always confirm important releases with their original publisher before relying on them.
⚠️ Past data and past market reactions do not guarantee future results. The same type of announcement can produce a different reaction from one release to the next.
⚠️ Your trading decisions and any resulting losses are your responsibility. Leveraged trading can cause substantial losses and, depending on the product and account protections, losses beyond your initial deposit. Seek advice from an appropriately licensed professional when needed.
------------------------------------------------------------
📅 Catalyst — your economic calendar, right on your chart
What news is coming up, when is it due, and which events relate to the market you are watching? Catalyst brings that information into one simple table on your TradingView chart.
See scheduled interest-rate decisions, inflation reports, jobs data, oil inventories and more, with their release times and colour-coded impact levels. When a supported result reaches TradingView, the table shows the new figure beside the previous one.
In the default Auto mode, change your chart's symbol and the calendar changes with it. Everything stays in one corner of your chart — no extra lines or levels drawn over price.
Whether you are learning to use an economic calendar or already plan your sessions around news, the aim is the same: less switching between screens and a clearer view of what is scheduled.
✨ Why traders add it
📆 See the week at a glance. Quickly spot scheduled releases, with red for Critical, orange for High and yellow for Medium impact.
🎯 Let Auto mode choose the relevant releases. EURUSD shows US and euro-area events, crude oil includes energy reports, and gold includes trader-positioning reports.
🔢 Compare the latest result with the previous one. Actual, Prev. and Change fill in automatically when supported figures become available through TradingView. The Change colour reflects the usual interpretation for the currency — not a trading signal.
⏰ Keep track of what is next. A countdown shows the time until the next release, and you can create an alert to notify you beforehand.
🗓️ Use publisher-based dates. Dates come from the original publisher's calendar or published scheduling rule. Missing dates are not guessed.
🔓 Free and open source. No separate data feed, no API key and no external service to connect.
🚀 Quick start
1. Add Catalyst to your chart. The table appears in the bottom-right corner.
2. You are ready to go: Auto mode selects the releases for your symbol, showing This Week in New York time by default.
3. To change the timezone, date range, impact levels or appearance, double-click the table to open its settings.
👀 Reading the table
Impact dots
🔴 Critical · 🟠 High · 🟡 Medium · ⚪ Low · 🔵 Holiday
Critical includes releases that can move a market on their own, such as interest-rate decisions, US payrolls and US CPI inflation. High is the next tier, including retail sales, business-activity surveys (PMIs) and economic-growth reports (GDP). These labels describe the event's impact category, not a guaranteed market reaction.
Time, Currency and Type
Time follows your chosen timezone — New York by default. Currency identifies the economy behind the release; currencies other than USD appear in bold. Type identifies the event category, such as Economy, Energy or Bonds.
Event
This is the release name. Where available, the reporting period appears in brackets. For example, “CPI (YoY) (Sep)” refers to September's consumer inflation compared with a year earlier, released in October. The month in brackets is the month being measured, not necessarily the release month.
Actual, Prev. and Change
Actual is the released figure. Prev. is the previous figure. Change is the difference between them: Actual minus Previous. Its colour follows the usual interpretation for the currency; for example, rising unemployment is shown as weaker. It does not predict how price will react.
Now and Next
The now line separates past releases from upcoming ones. The Next line counts down to the next release. The table focuses on the events nearest to now, with roughly one-third already released and the rest still to come.
Bottom line
This shows the selected period and how many events it contains.
💡 Hover for help. Hover over an event name to learn what it measures, a Change cell to read its usual interpretation, or a dash to find out why a value is missing.
🎯 Auto mode — a calendar that follows your chart
Auto is the default. It uses your chart's symbol to select the relevant economies and event categories:
Currency pairs: releases for both currencies.
Crude oil and natural gas: US releases, US Treasury auctions, energy reports and trader-positioning reports.
US stock indices: US releases, US Treasury auctions, quarterly expiry and trader-positioning reports.
Gold: US releases, US Treasury auctions and trader-positioning reports.
US dollar pairs and US stock indices also include the weekly crude oil inventories report.
Prefer a different selection? Show everything lists every event, while Custom lets you choose the currencies and categories yourself.
Auto mode on natural gas futures, daily chart:
⚙️ The settings
Double-click the table to open the settings. The small i icons beside them explain each option in more detail.
Mode: Auto, Show everything or Custom.
Timezone: Exchange, UTC, New York, Chicago, London, Frankfurt, Tokyo or Sydney. TradingView does not let an indicator read your chart's timezone, so choose the table's timezone here separately.
Time Format: 24 hour or 12 hour (AM/PM).
Show: Today, This Week (the default), Next Week, This Month, Next Month, This Quarter, This Year, or Custom with your own From and To dates.
News impact: choose which impact levels to include. All five levels are on by default.
The settings, part 1 - mode, timezone, period and impact levels:
Filters: available in Custom mode only. Choose from AUD, CAD, CHF, CNY, EUR, GBP, JPY, NZD and USD, and the categories Economy, Energy, Crops, Bonds, Market and Positioning.
Table: show or hide the table, choose its corner and size, select the columns, and adjust the notices, alert lead time and colours. Sizes are Tiny, Small, Normal and Large, with Small selected by default. Rows controls how many events are displayed, from 10 to 50.
The settings, part 2 - the filters for Custom mode and the table:
🔔 Alerts — a reminder before the release
One alert covers every release that matches your settings.
To create it, click the alarm-clock icon in TradingView's top toolbar, select Catalyst (Gigi) as the condition, and create the alert.
Choose a reminder 5, 15, 30 or 60 minutes before the release under Alert in the settings. The default is 15 minutes. The notification includes the event name, currency, impact level and release time.
Set your currency and impact filters before creating the alert so you only receive reminders for the events you care about.
An alert tells you what is coming — never what to buy or sell.
🌍 What it covers
Catalyst's catalogue includes 128 event types across nine economies: the United States, the euro area, the United Kingdom, Japan, Australia, New Zealand, Canada, Switzerland and China.
The calendar covers central-bank decisions, inflation, employment, economic growth, housing and sentiment. The US has the broadest coverage, with 71 event types. The other eight economies have between 3 and 13 each, focused on releases that matter most to their currencies.
It also includes the EIA's and API's weekly oil and gas inventory reports; the USDA's WASDE, crop progress and grain stocks reports; US Treasury note, bond and bill auctions; the Chicago PMI; the CFTC's trader-positioning report; quarterly index expiry; and US market holidays.
Not every event type has available dates or figures in this version. The coverage and limitations are explained below.
------------------------------------------------------------
🔎 More detail — data sources, coverage and limitations
------------------------------------------------------------
The sections above explain everyday use. Below you will find where the dates and figures come from, why some cells show a dash, and what to expect on longer timeframes, in Bar Replay or on a chart that has stopped trading.
📚 Where the dates and figures come from
Release dates: included with each version
Every date comes from the original publisher's release calendar or, for certain events, its written scheduling rule. A date that the publisher has not supplied is not invented.
The schedule is compiled before each version and included in the open-source companion library CatalystCalendarData. Its format is documented line by line, so anyone can check and decode an individual record by hand.
The sources are:
United States: FRED, the St. Louis Fed's release calendar, which includes the BLS and BEA schedules; the Census Bureau; the Federal Reserve; the EIA; the US Treasury; the USDA; the CFTC; ISM; the University of Michigan; the Conference Board; MNI; NAHB; and the National Association of Realtors.
Euro area: Eurostat, the ECB, ZEW and the European Commission.
United Kingdom: the Office for National Statistics and the Bank of England.
Japan: the Statistics Bureau, Japan Customs, the Cabinet Office and the Bank of Japan.
Australia: the Australian Bureau of Statistics and the Reserve Bank of Australia.
New Zealand: Stats NZ and the Reserve Bank of New Zealand.
Canada: Statistics Canada and the Bank of Canada.
Switzerland: the Swiss Federal Statistical Office, SECO and the Swiss National Bank.
China: the National Bureau of Statistics.
The EIA's and API's weekly reports, bill auctions, FOMC minutes, quarterly expiry, US market holidays and the Conference Board's consumer confidence releases from January to November follow their publisher's written scheduling rule.
Released figures: supplied through TradingView
The figures come from TradingView's own economic data, without a separate outside feed, requests to external services or an API key.
Each figure is matched to the period TradingView assigns it to and is displayed only from its scheduled release time. It is not shown on a past row before that scheduled time.
⏳ Figures can arrive a few minutes after the official release. While Catalyst waits, the Actual cell shows an hourglass, with the previous figure beside it. The row fills in automatically when the new figure becomes available.
The important distinction: release dates are included with the script's data version; supported figures update as they become available through TradingView.
🗓️ How far ahead does the calendar go?
Each version contains the dates that publishers had made available when it was built. Different events therefore have different end dates.
The first public version was built in October 2026. This version covers October 2024 to October 2027, but that does not mean every event is scheduled through October 2027:
• Events based on published scheduling rules and the Federal Reserve's decisions run to the end of the covered period.
• US statistical releases, including jobs, inflation, GDP and retail sales, run to December 2026.
• US Treasury note and bond auctions run to January 2027.
• China's releases run to mid-December 2026.
These limits reflect how far the relevant agencies had published their schedules when this version was built.
The schedule is refreshed every three months. Each refresh extends coverage to the dates published since the previous version. Release notes explain how far each update reaches, and the table's bottom line shows the data version your chart is using.
Seven event types have no dates in this version and are not listed:
• China's loan prime rate: normally set on the 20th of the month, or later when a public holiday intervenes. The full official holiday calendar has not yet been read, so dates are left out rather than guessed.
• China's trade balance: the customs administration publishes a timetable, but its website does not make that document available to automated readers.
• OPEC meetings: OPEC publishes no calendar; each meeting's date is announced at the previous meeting.
• Reuters Tankan: this poll has no published release calendar.
• Baker Hughes rig count: published at noon Central time on the last working day of the week, but the website blocked every automated read.
• Global Dairy Trade auctions: held about every two weeks. Published dates exist but have not yet been read.
• Challenger job cuts: the publisher's release dates have not yet been read.
When an update adds dates for one of these events, its release notes will say so.
❓ Why does a cell show a dash?
A dash means a figure is unavailable for a specific reason. Hover over it to see the explanation.
Hovering a dash shows why it is there:
Date-only events
23 event types are date markers rather than rows with figures.
Six do not have a numerical result by nature: FOMC and ECB press conferences, FOMC minutes, US market holidays, quarterly expiry and OPEC meetings.
For the other 17, TradingView does not supply the figures: ISM Services PMI, ISM Manufacturing Prices, the Conference Board's consumer confidence, the Chicago PMI, the nine Treasury auctions, the CFTC report, WASDE, crop progress and Australia's quarterly CPI. Their published dates and times are still used.
Reporting period not confirmed
Five event types show no figure because a published source could not confirm the period the figure belongs to: the three grain stocks reports, Japan's machinery orders and the Global Dairy Trade price index. Leaving the cell empty avoids displaying a number for the wrong reporting period.
Core PCE month on month
This row shows its date only, by choice. TradingView supplies the index rather than its monthly change. After a revision, it updates only the latest months, so calculating the change between neighbouring months can mix different versions of the data. The yearly rate is shown on a separate row.
Shutdown-delayed US releases
For US releases delayed by the 2025 government shutdown in the October 2025 to early May 2026 period, no figure is shown where the reporting month cannot be established from the release date.
Data-request limits
Catalyst works within a 40-request TradingView budget. It loads at most 36 figures at a time: 36 requests on daily or shorter charts, and 37 on longer charts, where the figures are read through the chart's daily bars.
The highest-impact events get their figures first. When more event types are visible than the script can load figures for — for example, when every US event is shown — the remaining events show dates only. A notice explains how many are affected and which filters to untick.
Not enough chart history
Figures can only reach back as far as your chart's available history. On 1-, 5- or 15-minute charts, or a 1-hour chart with a 5,000-bar history limit, some needed data can fall before the first available bar. This can affect older figures, the previous value of a monthly release, or year-on-year PCE, which needs a value from a year earlier.
Those cells show a dash with an explanation. A 4-hour or daily chart reaches back far enough for these cases.
🔢 Understanding the figures
No Forecast column
There is deliberately no Forecast column. TradingView's economic data does not include a consensus forecast — the figure analysts expect before a release. A forecast stored when the script was built would become outdated for later releases.
Change compares Actual with Previous, not Actual with Forecast. It is calculated from the values as printed in their cells. Its colour reflects the usual interpretation for the currency, not a prediction. Markets can react to the difference from expectations, revisions to older data or other news.
Past figures can be revised
Historical rows show TradingView's revised figures, not necessarily the numbers first announced. TradingView replaces older values when its data is revised.
Later estimates of the same period
A later estimate is identified in the event name, such as “(Q2 3rd est.)” for a third GDP estimate or “(Sep final)” for a final Michigan reading. These rows do not show Previous: TradingView keeps only one value per reporting period, so the earlier estimate it replaced is unavailable.
Euro-area interest rates
The displayed figure is the ECB's main refinancing rate. The deposit facility rate, which is often quoted elsewhere, is set lower.
Year-on-year PCE after revisions
After an annual revision, the displayed year-on-year PCE rate can temporarily differ from the published figure by 0.1, until TradingView also revises the year-earlier month.
Daily currency and futures charts
A release appears on its own day's bar. For example, a Friday Bank of Japan decision appears on Friday, not after the weekend.
Weekly, monthly and other longer charts
Charts with bars longer than one day — including two-day, weekly, monthly and quarterly charts — read each figure from the chart's daily bars inside the longer bar. This accounts for differences in how markets group their trading days.
The result is the same figure, at the same time, as on a daily chart. You do not have to wait for the next weekly or monthly bar to open, and a monthly chart can show every weekly report.
A weekly chart shows the same figures as a daily chart:
🛠️ The table, custom dates and notices
Custom dates include the time
From and To define exact dates and times, not whole calendar days. The defaults are 18:00 New York on 1 January 2026 to 17:00 on 1 January 2027, following the futures trading day.
The date boxes use your chart's timezone, while the table uses Catalyst's Timezone setting. Set both to the same zone to avoid confusion. The table's heading includes the hours whenever either end of the range is not midnight.
The table cannot scroll
It shows the events nearest to now, and its heading tells you how many of the available events are displayed.
When the table is too tall
A table taller than the chart is cut off at the edge furthest from its selected corner. With the default bottom-right position, that means the top is cut off.
In either bottom corner, a long table repeats the column headings beneath the last row so they remain visible. Reduce Rows or choose a smaller table size to fit more comfortably. The main heading and notices stay at the anchored corner edge, where they are not cut off.
Notices explain what to change
The table displays a notice when there are more events than Rows allows, custom dates extend outside the available calendar, From is later than To, too many event types need figures, or the chart's price data has stopped updating.
When a chart has stopped trading
A chart cannot show figures for releases after its last bar. Those rows show a dash. The notice suggests opening the same pair or symbol from another broker or data feed that is still trading.
Bar Replay
Rows before the replay point show their figures; rows after it show a dash. However, the now line, countdown and Today, This Week and This Month ranges follow the real clock, not the replay clock.
💡 In Bar Replay, set Show to Custom and choose the dates you are replaying.
🔓 Open source
Catalyst is published open source under the Mozilla Public License 2.0. The code is commented to make it easier to read, and no code was taken from another script.
Questions, feedback and corrections are welcome in the comments below. 💬
⚠️ IMPORTANT — READ BEFORE USING ⚠️
============================================================
⚠️ Catalyst is an educational and analytical tool. It is not financial advice, a trading system or a signal service. It does not generate buy or sell signals, and nothing it displays is a recommendation to trade.
⚠️ The calendar shows scheduled events and released economic data — not predictions. Impact ratings, colours, figures and alerts do not tell you whether price will rise, fall or reverse. A Critical event does not guarantee a large move, and a favourable data change is not a buy signal.
⚠️ Use this tool to help plan your session, not as a replacement for official sources. Schedules can change, coverage can be incomplete, and figures may be delayed, missing or revised. Accuracy and completeness cannot be guaranteed. Always confirm important releases with their original publisher before relying on them.
⚠️ Past data and past market reactions do not guarantee future results. The same type of announcement can produce a different reaction from one release to the next.
⚠️ Your trading decisions and any resulting losses are your responsibility. Leveraged trading can cause substantial losses and, depending on the product and account protections, losses beyond your initial deposit. Seek advice from an appropriately licensed professional when needed.
------------------------------------------------------------
📅 Catalyst — your economic calendar, right on your chart
What news is coming up, when is it due, and which events relate to the market you are watching? Catalyst brings that information into one simple table on your TradingView chart.
See scheduled interest-rate decisions, inflation reports, jobs data, oil inventories and more, with their release times and colour-coded impact levels. When a supported result reaches TradingView, the table shows the new figure beside the previous one.
In the default Auto mode, change your chart's symbol and the calendar changes with it. Everything stays in one corner of your chart — no extra lines or levels drawn over price.
Whether you are learning to use an economic calendar or already plan your sessions around news, the aim is the same: less switching between screens and a clearer view of what is scheduled.
✨ Why traders add it
📆 See the week at a glance. Quickly spot scheduled releases, with red for Critical, orange for High and yellow for Medium impact.
🎯 Let Auto mode choose the relevant releases. EURUSD shows US and euro-area events, crude oil includes energy reports, and gold includes trader-positioning reports.
🔢 Compare the latest result with the previous one. Actual, Prev. and Change fill in automatically when supported figures become available through TradingView. The Change colour reflects the usual interpretation for the currency — not a trading signal.
⏰ Keep track of what is next. A countdown shows the time until the next release, and you can create an alert to notify you beforehand.
🗓️ Use publisher-based dates. Dates come from the original publisher's calendar or published scheduling rule. Missing dates are not guessed.
🔓 Free and open source. No separate data feed, no API key and no external service to connect.
🚀 Quick start
1. Add Catalyst to your chart. The table appears in the bottom-right corner.
2. You are ready to go: Auto mode selects the releases for your symbol, showing This Week in New York time by default.
3. To change the timezone, date range, impact levels or appearance, double-click the table to open its settings.
👀 Reading the table
Impact dots
🔴 Critical · 🟠 High · 🟡 Medium · ⚪ Low · 🔵 Holiday
Critical includes releases that can move a market on their own, such as interest-rate decisions, US payrolls and US CPI inflation. High is the next tier, including retail sales, business-activity surveys (PMIs) and economic-growth reports (GDP). These labels describe the event's impact category, not a guaranteed market reaction.
Time, Currency and Type
Time follows your chosen timezone — New York by default. Currency identifies the economy behind the release; currencies other than USD appear in bold. Type identifies the event category, such as Economy, Energy or Bonds.
Event
This is the release name. Where available, the reporting period appears in brackets. For example, “CPI (YoY) (Sep)” refers to September's consumer inflation compared with a year earlier, released in October. The month in brackets is the month being measured, not necessarily the release month.
Actual, Prev. and Change
Actual is the released figure. Prev. is the previous figure. Change is the difference between them: Actual minus Previous. Its colour follows the usual interpretation for the currency; for example, rising unemployment is shown as weaker. It does not predict how price will react.
Now and Next
The now line separates past releases from upcoming ones. The Next line counts down to the next release. The table focuses on the events nearest to now, with roughly one-third already released and the rest still to come.
Bottom line
This shows the selected period and how many events it contains.
💡 Hover for help. Hover over an event name to learn what it measures, a Change cell to read its usual interpretation, or a dash to find out why a value is missing.
🎯 Auto mode — a calendar that follows your chart
Auto is the default. It uses your chart's symbol to select the relevant economies and event categories:
Currency pairs: releases for both currencies.
Crude oil and natural gas: US releases, US Treasury auctions, energy reports and trader-positioning reports.
US stock indices: US releases, US Treasury auctions, quarterly expiry and trader-positioning reports.
Gold: US releases, US Treasury auctions and trader-positioning reports.
US dollar pairs and US stock indices also include the weekly crude oil inventories report.
Prefer a different selection? Show everything lists every event, while Custom lets you choose the currencies and categories yourself.
Auto mode on natural gas futures, daily chart:
⚙️ The settings
Double-click the table to open the settings. The small i icons beside them explain each option in more detail.
Mode: Auto, Show everything or Custom.
Timezone: Exchange, UTC, New York, Chicago, London, Frankfurt, Tokyo or Sydney. TradingView does not let an indicator read your chart's timezone, so choose the table's timezone here separately.
Time Format: 24 hour or 12 hour (AM/PM).
Show: Today, This Week (the default), Next Week, This Month, Next Month, This Quarter, This Year, or Custom with your own From and To dates.
News impact: choose which impact levels to include. All five levels are on by default.
The settings, part 1 - mode, timezone, period and impact levels:
Filters: available in Custom mode only. Choose from AUD, CAD, CHF, CNY, EUR, GBP, JPY, NZD and USD, and the categories Economy, Energy, Crops, Bonds, Market and Positioning.
Table: show or hide the table, choose its corner and size, select the columns, and adjust the notices, alert lead time and colours. Sizes are Tiny, Small, Normal and Large, with Small selected by default. Rows controls how many events are displayed, from 10 to 50.
The settings, part 2 - the filters for Custom mode and the table:
🔔 Alerts — a reminder before the release
One alert covers every release that matches your settings.
To create it, click the alarm-clock icon in TradingView's top toolbar, select Catalyst (Gigi) as the condition, and create the alert.
Choose a reminder 5, 15, 30 or 60 minutes before the release under Alert in the settings. The default is 15 minutes. The notification includes the event name, currency, impact level and release time.
Set your currency and impact filters before creating the alert so you only receive reminders for the events you care about.
An alert tells you what is coming — never what to buy or sell.
🌍 What it covers
Catalyst's catalogue includes 128 event types across nine economies: the United States, the euro area, the United Kingdom, Japan, Australia, New Zealand, Canada, Switzerland and China.
The calendar covers central-bank decisions, inflation, employment, economic growth, housing and sentiment. The US has the broadest coverage, with 71 event types. The other eight economies have between 3 and 13 each, focused on releases that matter most to their currencies.
It also includes the EIA's and API's weekly oil and gas inventory reports; the USDA's WASDE, crop progress and grain stocks reports; US Treasury note, bond and bill auctions; the Chicago PMI; the CFTC's trader-positioning report; quarterly index expiry; and US market holidays.
Not every event type has available dates or figures in this version. The coverage and limitations are explained below.
------------------------------------------------------------
🔎 More detail — data sources, coverage and limitations
------------------------------------------------------------
The sections above explain everyday use. Below you will find where the dates and figures come from, why some cells show a dash, and what to expect on longer timeframes, in Bar Replay or on a chart that has stopped trading.
📚 Where the dates and figures come from
Release dates: included with each version
Every date comes from the original publisher's release calendar or, for certain events, its written scheduling rule. A date that the publisher has not supplied is not invented.
The schedule is compiled before each version and included in the open-source companion library CatalystCalendarData. Its format is documented line by line, so anyone can check and decode an individual record by hand.
The sources are:
United States: FRED, the St. Louis Fed's release calendar, which includes the BLS and BEA schedules; the Census Bureau; the Federal Reserve; the EIA; the US Treasury; the USDA; the CFTC; ISM; the University of Michigan; the Conference Board; MNI; NAHB; and the National Association of Realtors.
Euro area: Eurostat, the ECB, ZEW and the European Commission.
United Kingdom: the Office for National Statistics and the Bank of England.
Japan: the Statistics Bureau, Japan Customs, the Cabinet Office and the Bank of Japan.
Australia: the Australian Bureau of Statistics and the Reserve Bank of Australia.
New Zealand: Stats NZ and the Reserve Bank of New Zealand.
Canada: Statistics Canada and the Bank of Canada.
Switzerland: the Swiss Federal Statistical Office, SECO and the Swiss National Bank.
China: the National Bureau of Statistics.
The EIA's and API's weekly reports, bill auctions, FOMC minutes, quarterly expiry, US market holidays and the Conference Board's consumer confidence releases from January to November follow their publisher's written scheduling rule.
Released figures: supplied through TradingView
The figures come from TradingView's own economic data, without a separate outside feed, requests to external services or an API key.
Each figure is matched to the period TradingView assigns it to and is displayed only from its scheduled release time. It is not shown on a past row before that scheduled time.
⏳ Figures can arrive a few minutes after the official release. While Catalyst waits, the Actual cell shows an hourglass, with the previous figure beside it. The row fills in automatically when the new figure becomes available.
The important distinction: release dates are included with the script's data version; supported figures update as they become available through TradingView.
🗓️ How far ahead does the calendar go?
Each version contains the dates that publishers had made available when it was built. Different events therefore have different end dates.
The first public version was built in October 2026. This version covers October 2024 to October 2027, but that does not mean every event is scheduled through October 2027:
• Events based on published scheduling rules and the Federal Reserve's decisions run to the end of the covered period.
• US statistical releases, including jobs, inflation, GDP and retail sales, run to December 2026.
• US Treasury note and bond auctions run to January 2027.
• China's releases run to mid-December 2026.
These limits reflect how far the relevant agencies had published their schedules when this version was built.
The schedule is refreshed every three months. Each refresh extends coverage to the dates published since the previous version. Release notes explain how far each update reaches, and the table's bottom line shows the data version your chart is using.
Seven event types have no dates in this version and are not listed:
• China's loan prime rate: normally set on the 20th of the month, or later when a public holiday intervenes. The full official holiday calendar has not yet been read, so dates are left out rather than guessed.
• China's trade balance: the customs administration publishes a timetable, but its website does not make that document available to automated readers.
• OPEC meetings: OPEC publishes no calendar; each meeting's date is announced at the previous meeting.
• Reuters Tankan: this poll has no published release calendar.
• Baker Hughes rig count: published at noon Central time on the last working day of the week, but the website blocked every automated read.
• Global Dairy Trade auctions: held about every two weeks. Published dates exist but have not yet been read.
• Challenger job cuts: the publisher's release dates have not yet been read.
When an update adds dates for one of these events, its release notes will say so.
❓ Why does a cell show a dash?
A dash means a figure is unavailable for a specific reason. Hover over it to see the explanation.
Hovering a dash shows why it is there:
Date-only events
23 event types are date markers rather than rows with figures.
Six do not have a numerical result by nature: FOMC and ECB press conferences, FOMC minutes, US market holidays, quarterly expiry and OPEC meetings.
For the other 17, TradingView does not supply the figures: ISM Services PMI, ISM Manufacturing Prices, the Conference Board's consumer confidence, the Chicago PMI, the nine Treasury auctions, the CFTC report, WASDE, crop progress and Australia's quarterly CPI. Their published dates and times are still used.
Reporting period not confirmed
Five event types show no figure because a published source could not confirm the period the figure belongs to: the three grain stocks reports, Japan's machinery orders and the Global Dairy Trade price index. Leaving the cell empty avoids displaying a number for the wrong reporting period.
Core PCE month on month
This row shows its date only, by choice. TradingView supplies the index rather than its monthly change. After a revision, it updates only the latest months, so calculating the change between neighbouring months can mix different versions of the data. The yearly rate is shown on a separate row.
Shutdown-delayed US releases
For US releases delayed by the 2025 government shutdown in the October 2025 to early May 2026 period, no figure is shown where the reporting month cannot be established from the release date.
Data-request limits
Catalyst works within a 40-request TradingView budget. It loads at most 36 figures at a time: 36 requests on daily or shorter charts, and 37 on longer charts, where the figures are read through the chart's daily bars.
The highest-impact events get their figures first. When more event types are visible than the script can load figures for — for example, when every US event is shown — the remaining events show dates only. A notice explains how many are affected and which filters to untick.
Not enough chart history
Figures can only reach back as far as your chart's available history. On 1-, 5- or 15-minute charts, or a 1-hour chart with a 5,000-bar history limit, some needed data can fall before the first available bar. This can affect older figures, the previous value of a monthly release, or year-on-year PCE, which needs a value from a year earlier.
Those cells show a dash with an explanation. A 4-hour or daily chart reaches back far enough for these cases.
🔢 Understanding the figures
No Forecast column
There is deliberately no Forecast column. TradingView's economic data does not include a consensus forecast — the figure analysts expect before a release. A forecast stored when the script was built would become outdated for later releases.
Change compares Actual with Previous, not Actual with Forecast. It is calculated from the values as printed in their cells. Its colour reflects the usual interpretation for the currency, not a prediction. Markets can react to the difference from expectations, revisions to older data or other news.
Past figures can be revised
Historical rows show TradingView's revised figures, not necessarily the numbers first announced. TradingView replaces older values when its data is revised.
Later estimates of the same period
A later estimate is identified in the event name, such as “(Q2 3rd est.)” for a third GDP estimate or “(Sep final)” for a final Michigan reading. These rows do not show Previous: TradingView keeps only one value per reporting period, so the earlier estimate it replaced is unavailable.
Euro-area interest rates
The displayed figure is the ECB's main refinancing rate. The deposit facility rate, which is often quoted elsewhere, is set lower.
Year-on-year PCE after revisions
After an annual revision, the displayed year-on-year PCE rate can temporarily differ from the published figure by 0.1, until TradingView also revises the year-earlier month.
Daily currency and futures charts
A release appears on its own day's bar. For example, a Friday Bank of Japan decision appears on Friday, not after the weekend.
Weekly, monthly and other longer charts
Charts with bars longer than one day — including two-day, weekly, monthly and quarterly charts — read each figure from the chart's daily bars inside the longer bar. This accounts for differences in how markets group their trading days.
The result is the same figure, at the same time, as on a daily chart. You do not have to wait for the next weekly or monthly bar to open, and a monthly chart can show every weekly report.
A weekly chart shows the same figures as a daily chart:
🛠️ The table, custom dates and notices
Custom dates include the time
From and To define exact dates and times, not whole calendar days. The defaults are 18:00 New York on 1 January 2026 to 17:00 on 1 January 2027, following the futures trading day.
The date boxes use your chart's timezone, while the table uses Catalyst's Timezone setting. Set both to the same zone to avoid confusion. The table's heading includes the hours whenever either end of the range is not midnight.
The table cannot scroll
It shows the events nearest to now, and its heading tells you how many of the available events are displayed.
When the table is too tall
A table taller than the chart is cut off at the edge furthest from its selected corner. With the default bottom-right position, that means the top is cut off.
In either bottom corner, a long table repeats the column headings beneath the last row so they remain visible. Reduce Rows or choose a smaller table size to fit more comfortably. The main heading and notices stay at the anchored corner edge, where they are not cut off.
Notices explain what to change
The table displays a notice when there are more events than Rows allows, custom dates extend outside the available calendar, From is later than To, too many event types need figures, or the chart's price data has stopped updating.
When a chart has stopped trading
A chart cannot show figures for releases after its last bar. Those rows show a dash. The notice suggests opening the same pair or symbol from another broker or data feed that is still trading.
Bar Replay
Rows before the replay point show their figures; rows after it show a dash. However, the now line, countdown and Today, This Week and This Month ranges follow the real clock, not the replay clock.
💡 In Bar Replay, set Show to Custom and choose the dates you are replaying.
🔓 Open source
Catalyst is published open source under the Mozilla Public License 2.0. The code is commented to make it easier to read, and no code was taken from another script.
Questions, feedback and corrections are welcome in the comments below. 💬
Chart tools built to be read, tested and argued with. If something looks wrong, tell me.
Отказ от ответственности
Информация и публикации не предназначены для предоставления и не являются финансовыми, инвестиционными, торговыми или другими видами советов или рекомендаций, предоставленных или одобренных TradingView. Подробнее читайте в Условиях использования.
Chart tools built to be read, tested and argued with. If something looks wrong, tell me.
Отказ от ответственности
Информация и публикации не предназначены для предоставления и не являются финансовыми, инвестиционными, торговыми или другими видами советов или рекомендаций, предоставленных или одобренных TradingView. Подробнее читайте в Условиях использования.