faq.md

FAQ

Data requirements

Q: In what format should the data be stored?

A: Use plain-text files to store your data:

• Store the price data in CSV files in the data/ directory. Create a separate file for each symbol.
• Store additional symbol information in a JSON file in the symbol_info/ directory. Describe all symbol settings in one file.

Refer to Data structure for more information.

Q: What if I store data in a file with a different extension (not CSV)?

A: In this case, you will not see the data on the chart. Change the file extension to CSV and create a new pull request.

Q: Can only trading data be integrated?

A: The TradingView platform is a handy tool for dealing with trading data. Such data always has a difference between price values. But if your data series has a single value per day, use open = close = high = low, and volume = 0. It is suitable for economic indicators.

20210101T,0.1,0.1,0.1,0.1,0

Q: What is EOD data? How does it differ from intraday data?

A: EOD (End-of-Day) data is the values received at the end of the trading session of a given day. Regardless of the number of changes within the day (intraday), you will see only the last saved value on the chart.

Q: How quickly can I check the result after updating the data?

A: Your EOD data is checked and uploaded to our storage several times a day. On the chart you will see the values for the previous day and earlier. If the data needs to be updated more frequently, you can connect the integration via REST API, but this option is only available for the brokerage integration.

Q: How often do I need to update data from the source?

A: TradingView allows you to watch and analyze the data for any period. If data is not updated, it is no longer useful. If your files have not been updated for three months, the source will be disabled.

Q: What are the limits on the amount of data?

A: EOD data has a limit of 6,000 symbols per repository. You can create another data repository if you have more than 6,000 CSV data files.

TradingView UI

Q: Why can't I find my symbols in the symbol search box?

A: EOD symbols do not show up in the symbol search suggestion field, but you can still open them. Enter the full symbol name (prefix:symbol_name) and press Enter. The chart will switch to the requested symbol.

Q: I added the symbol data first and then the symbol descriptions. All actions were finished successfully, but the chart does not display the data. What should I do?

A: When adding symbols, you first need to add their descriptions in symbol_info/, then ensure that actions run successfully and No data here appears on the chart. If you added the symbol data before these steps, delete data from the CSV file and commit the changes. Then check that No data here appeared on the chart and add the symbol data again. For more information, refer to the How to add symbols to the chart and remove them tutorial.

Note

The steps above only work for the symbols that have just been added. For those symbols whose data is already shown on the chart, you can change the CSV files without waiting for No data here to appear on the chart. Your data will be updated.

Q: What if the maximum amount of time required for the symbol to appear on the chart has passed, but I still do not see it?

A: The maximum time for a symbol to appear on the chart is 30 minutes. If it has not appeared during this time, check the action logs for validation warnings and errors. If you cannot fix the issue, contact us at [email protected]. Our support team is available on weekdays from 6 AM to 3 PM UTC.

Q: Would a candlestick chart be informative?

A: A Line chart is suitable for economic data, which commonly only has a single data source, as it only shows close values. The data that has different OHLC values will be better represented with the Candles chart, which displays each four of these values separately.

Q: Who can use my symbols in the UI?

A: Anyone who knows the full symbol names can access your symbols' EOD data from the Symbol Search.

GitHub

Q: What if I made more than 5 pull requests in a day?

A: Only 5 pull requests (PR) per day can be merged from your personal repository into the main one. If you create more than 5 PRs, the Upload data action will not run until the next day. You will be able to rerun the action 24 hours after the first PR made the day before.

To rerun the action:

1. Go to Actions in your repository.
2. Open the last run action.
3. Click Re-run all jobs.

Q: How to catch errors?

A: Your GitHub repository has a Check data action set-up. Validation warnings and errors can be found in its logs.

Q: What if the Check data action has failed in my repository after adding a symbol description?

A: Check that the JSON file in the symbol_info/ directory has a valid format. Refer to Symbol info format for more information.

Q: What if the Check data action has failed in my repository after adding the symbol data?

A: Check that CSV files in the data/ directory have valid formats. Refer to Data format for more information.

Q: What if the Upload data action has failed in the main repository?

A: Check that you have not exceeded the daily number of pull requests. If not, contact us at [email protected]. Our support team is available on weekdays from 6 AM to 3 PM UTC.

Q: What should I do if I see an error "The pull request cannot be merged. There is probably a data conflict."?

A: Most likely, you made several consecutive commits too quickly. You need to make a new commit, and all previous data changes will be pulled.

Q: What if my pull request was not merged automatically?

A: Check the action logs for validation warnings and errors. If you cannot fix the issue, contact us at [email protected]. Our support team is available on weekdays from 6 AM to 3 PM UTC.

Q: Why is it not possible to load more than 3000 of .csv data files in one commit?

A: Due to technical reasons, we have uploaded such restrictions to checker from our side. So, please load no more than 3000 data files in one commit.