Wealth-Lab Wiki

API ChartStyles Community Components Community Indicators IndexDefinitions Knowledge Base Misc Optimizers Pending Deletion PosSizers Providers Standard Indicators TASC Traders Tips TASCIndicators Tutorial Videos Visualizers
RSS

Navigation


Quick Search
»
Advanced Search »


YCharts Fundamental Data for Securities and Economic Data

RSS

What is it

This is a fundamental data provider for Wealth-Lab version 6 and up that downloads free fundamental and economic data items from the YCharts web site.

The full set of data is available to YCharts paid subscribers only. Note: free trial may not qualify and you won't get any data. However, many fundamental items are downloadable for free even if you don't have a subscription. YCharts restricts free fundamental data to the last 2-3 years. Economic data is available to paid subscribers only.

Setting up

Firstly you need to enter your email address and password in the provider's tab in Data Manager (note: context sensitive!)

Enter username and password - YCharts paid plans only

Enter username and password - YCharts paid plans only


To start collecting 65+ fundamental items and 15+ economic data items provided by YCharts, check the provider's entries in Wealth-Lab's Data Manager tool (at the bottom of the "Update Data" tab). Now, Wealth-Lab will also collect fundamental data for all symbols and/or economic data after it finishes updating static data.

Starting from v2015.03 the provider supports retrieving data through the official Excel Addin API. Should the usual web downloads broke, you may paste your Excel API Key (available in your Profile on YCharts website) and switch to the backup way.

Usage

Fundamental data downloads are available when you click "Update all data..." (and have at least one data provider selected from the list of installed provider) or when "Update DataSet" is selected.

Note: Fundamental items aren't collected when "Update DataSet (Pricing)" is selected.

Be patient while the provider is downloading the data. Although data downloads are multi-threaded, it could be a lengthy process for large portfolios. Since new fundamental data items become available every 3 months, it's recommended that you uncheck the provider's entry in the Data Manager for daily updates! If you fail to do it, you will quickly run out of the monthly quota (which is only 25MB for the cheapest plan). Alternatively, switch to the limited free download mode.

Economic data items are updated only when "Update all data..." was clicked. Downloading this data does not depend on selected data provider, as economic items are global by nature and don't belong to a symbol. Please be patient while the data is downloaded (may take a minute).

Available fundamental items

YCharts makes available up to 30 years worth of quarterly fundamental items for the U.S. securities. The complete list of the available fundamental items is included:

  • Free: Accounts Payable, Accounts Receivable, Asset Utilization, Assets, Book Value Of Equity, Cash Financing, Cash Investing, Cash On Hand, Cash Operations, Current Ratio, Debt Equity Ratio, Dividend, Dividend Yield, Earning Yield, Enterprise Value, EPS, Free Cash Flow, Gross Profit, Gross Profit Margin, Interest Expense, Interest Income, Inventories Net, Liabilities, Market Cap, Net Income, Net PPE, P/E Ratio, PEG Ratio, Price To Book Value, Profit Margin, R&D Expense, Retained Earnings, Return On Assets, Return On Equity, Revenues, SGA Expense, Shareholders Equity, Shares Outstanding
  • Pro (paid subscribers only): all of the "free" items listed above + Accruals, Book Value Of Tangible Equity, Book Value Per Share, Capex, Capex Annual, Cash And Equivalents, Cash Conversion Cycle, Cash Dividend Payout Ratio, Days Inventory Outstanding, Days Payables Outstanding, Days Sales Outstanding, Depreciation Amortization Depletion, EBITDA, EBITDA Margin, Effective Tax Rate, EPS Growth, Expenses, Free Cash Flow Yield, Free Cash Flow Per Share, Gross Profit Annual, Income Before Ex Items And Disc Ops, Long Term Debt, Long Term Investments, Net Total Long Term Debt, Operating Earning Yield, Operating Margin, Operating P/E Ratio, Other Comp Income, Payout Ratio, Quick Ratio, Receivables Turnover, Retained Earnings Growth, Return On Invested Capital, Revenue Growth, Revenue Per Share, Stock Buyback, Tangible Book Value Per Share, Tangible Common Equity Ratio, Times Interest Earned, Total Changes In Assets Liabilities, Total Depreciation And Amortization, Total Long Term Assets

Items in strikethrough have been excluded as of version 2016.02 due to a big consumption of the download quota. They can be easily reconstructed in Strategy code. In pseudo-code:

  • Price-To-Book Ratio = Close / "[yc] book_value_of_equity"
  • P/E Ratio = Close / "[yc] eps"
  • Earnings Yield = FundamentalDataSeriesAnnual("[yc] eps") / Close
  • Market Capitalization = Close * "[yc] shares_outstanding"
  • Dividend Yield = FundamentalDataSeriesAnnual("[yc] dividend") / Close
  • Free Cash Flow Yield = "[yc] free_cash_flow_per_share" / Close
  • P/EG Ratio = (Close / "[yc] eps") / "[yc] eps_growth"

Wealth-Lab customers can request new items from YCharts extensive collection here: Forum support thread.

Fundamental items can be charted from the Fundamental Data dialog at any time by clicking the Fundamentals button in the Navigation or Function toolbars, from the Tools menu, a chart's right-click menu, or simply using the Ctrl+U shortcut.

Available economic items

On their website, YCharts provides hundreds of thousands of economic indicators (worldwide). Through this data provider it's possible to use only the core U.S. economic data items as they consume download quota:

  • 10 Year Treasury Rate, 30 Year Mortgage Rate, 30 Year Treasury Rate, Auto Sales, Consumer Price Index, Durable Goods Orders, Effective Federal Funds Rate, Existing Home Sales, Housing Starts, Initial Claims fo Unemployment Insurance, Personal Consumption Expenditures, Producer Price Index, Purchasing Managers Index, Retail Sales, Total Nonfarm Payrolls, U.S. Inflation Rate, Unemployment Rate

Stock dividends

YCharts provides some extended data fields for dividend items: in addition to the Ex-Dividend date, you can make use of Declaration, Record and Payable dates, as well as Dividend Type. Each dividend item is associated with the ex-dividend date and comes with extra details attached: DeclarationDate, RecordDate, PayableDates, and DividendType. These are available in two forms:

  • In a popup when mousing over an [yc] dividend item on a stock chart
  • In WealthScript Strategoes via the GetDetail or FormatValue methods:

Make sure you've collected the YCharts fundamental data before running this Strategy:

using System;
using System.Collections.Generic;
using System.Text;
using System.Drawing;
using WealthLab;
using WealthLab.Indicators;

namespace WealthLab.Strategies { public class MyStrategy : WealthScript { protected override void Execute() { // Illustrates how to handle YCharts's extended dividend information with GetDetail

const char tab = '\u0009'; string item = "[yc] dividend"; IList<FundamentalItem> fList = FundamentalDataItems(item); ClearDebug(); PrintDebug(Bars.Symbol + tab + "Item Count: " + fList.Count); foreach (FundamentalItem fi in fList) { PrintDebug( fi.Date.ToShortDateString() + tab + fi.Value.ToString() + tab + fi.GetDetail("DeclarationDate") + tab + fi.GetDetail("RecordDate") + tab + fi.GetDetail("PayableDate") + tab + fi.GetDetail("DividendType") + tab); }

} } }

Notes

  • The data are refreshed on each update (like other WL6 fundamental data providers do), so it should be free from adjusting problems. This consumes quota.
  • If some economic items didn't appear after downloading, try repeating the data update.

Images

Here are some screenshots of the provider at work:

Some of the available fundamental data items

Some of the available fundamental data items

Some of the available economic data items

Some of the available economic data items

Economic data items

Economic data items

Important Disclaimer: The information provided by Wealth-Lab is strictly for informational purposes and is not to be construed as advice or solicitation to buy or sell any security.  The owner of Wealth-Lab.com assumes no liability resulting from the use of the material contained herein for investment purposes. By using this web site, you agree to the terms of this disclaimer and our Terms of Use.

Used under license from FMR Corp. Copyright 2008 FMR Corp. All rights reserved.


ScrewTurn Wiki. Some of the icons created by FamFamFam.