Jump to content

Template:Finance links/doc: Difference between revisions

From Wikipedia, the free encyclopedia
Content deleted Content added
m Public company: Added comment for the field name
add templatedata
 
(35 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{Warning|Because this template creates external links to websites outside Wikipedia's control, be aware that these websites may change the format of their web addresses at any time.
<p>You are advised to test the links that are created using this template. If you spot any links that no longer work, please update the template or leave a message on the [[Template talk:Finance links|template talk page]] if you need help doing so.</p>}}


This template provides a list of useful links to financial and industry tracking websites for companies, both [[public company|public]] and [[privately held company|private]].
This template provides a list of useful links to several financial and industry tracking websites for companies, both [[public company|public]] and [[privately held company|private]].


=== Usage ===
== Usage ==
This template should be placed in the "External links" section, preferably after any official or specialist links.


;Blank syntax
This template should be placed in the ''External links'' section, preferably after any official or specialist links.
<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Finance links
|name=
|google=
|yahoo=
|reuters=
|sec_cik=
}}
</syntaxhighlight>


===Sites included===
===Sites included===
Depending on availability of information, this template provides links to the following services:
Depending on availability of information, this template provides links to the following services:

# [[Google Finance]]
# [[Google Finance]]
# [[Yahoo! Finance]]
# [[Yahoo! Finance]]
<!--# [[Bloomberg L.P.|Bloomberg]] -->
# [[Hoover's]]
# [[Bloomberg L.P.|Bloomberg]]
# [[Reuters]]
# [[Reuters]]
# [[SEC filings]] at the [[United States Securities and Exchange Commission|Securities and Exchange Commission]]
# [[SEC filing]]s at the [[U.S. Securities and Exchange Commission]]


===Fields===
===Parameters===
; name: (optional, will take the page name) The name of the company as you would like it to appear in each link. This is usually the full, official name of the company, such as Microsoft Corporation or Google, Inc.
; name: (optional, will take the page name) The name of the company as you would like it to appear in each link. This is usually the full, official name of the company, such as Starbucks Corporation or Apple Inc.
; google: Ticker symbol, followed by a colon and the exchange, e.g., SBUX:NASDAQ for Starbucks. Generates a Google Finance link.
; symbol: The stock market symbol for public companies. This is the only field necessary for public companies to generate most of the links, with the exception of Hoover's and corporate filings from the SEC. For example: MSFT for Microsoft or GOOG for Google.
; yahoo: Ticker symbol, including the non-US exchange code if outside of the US. Generates a Yahoo! Finance link.
; sec_cik: The SEC CIK (Central Index Key) is an identifier assigned by the Securities and Exchange Commission to all public companies. To find the CIK for any public company, search for the company name at http://www.sec.gov/edgar/searchedgar/cik.htm. The CIK code is listed directly on the search results page, to the left of the company name. Any leading zeros may be removed from this number. For example, the search results for a query of "microsoft" returns two entries. The relevant entry is listed as "MICROSOFT CORP" and has a CIK of 789019 (with 4 leading zeros removed).
<!--; bloomberg: The Bloomberg symbol: a combination of the symbol, a colon, and a geographic code, e.g., SBUX:US for Starbucks. -->
; hoovers: The Hoover's ID. Because Hoover's does not support linking directly by stock symbol, '''you must manually research this value even for public companies'''. To find a Hoover's Finance ID for a company, search for the company name at the http://www.hoovers.com/. Once you have found the company, if it is listed, check the page address. The Hoover's ID is the value located between the ''www.hoovers.com/company-information/cs/company-profile.'' and ''.html'' portions of the URL. For example, the address for U.S. Robotics Corporation is http://www.hoovers.com/company-information/cs/company-profile.US_Robotics_Corporation.12b5e6ee5bee0096.html, so the Hoover's ID is US_Robotics_Corporation.12b5e6ee5bee0096.
; reuters: The Reuters "RIC code", a combination of the symbol, a period, and a market code, e.g., SBUX.O for Starbucks (here "O" represents "over-the-counter," a legacy from when Nasdaq was an over-the-counter market before it was an exchange).
; google: The Google Finance ID. '''Only use this field for private companies'''; the stock symbol is sufficient for generating the Google Finance link to public companies. To find a Google Finance ID for a private company, search for the company name at http://finance.google.com/. Once you have found the company, if it is listed, check the page address for the ''cid'' variable. If you do not have a ''cid'' variable in your URL, you may need to click on ''Find more results for <company name>'' and re-select the company from the results. The value of the ''cid'' variable is the Google Finance ID. For example, the address for U.S. Robotics Corporation is http://finance.google.com/finance?cid=9605236, so the Google Finance ID is 9605236.
; in all the above cases, the symbol/code should be those of the company's home country.
; yahoo: Ticker symbol. Generates a Yahoo! Finance link.
; sec_cik: The SEC CIK (Central Index Key) is an identifier assigned by the Securities and Exchange Commission for all companies that file reports with the SEC, including all companies traded publicly on US stock exchanges and many large private companies. To find the CIK for any filing company, search for the company name at [https://www.sec.gov/edgar/searchedgar/cik.htm https://www.sec.gov/edgar/searchedgar/cik.htm]. The CIK code is listed directly on the search results page, to the left of the company name. Any leading zeros may be removed from this number. For example, the search results for a query of "microsoft" returns two entries. The relevant entry is listed as "MICROSOFT CORP" and has a CIK of 789019 (with 4 leading zeros removed). While the symbol will also work in this field, the CIK is far preferable as the symbol will lead to a search page that requires additional navigation.


===Examples===
==Examples==
===U.S. Public company===
<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Finance links
| name = Starbucks Corporation <!-- can be removed, will take the page name -->
| google = SBUX:NASDAQ
| yahoo = SBUX
| reuters = SBUX.O
| sec_cik = 829224
}}
</syntaxhighlight>


Appears as:
====Public company====
<pre>
{{Finance links
{{Finance links
| name = Microsoft Corporation <!-- can be removed, will take the page name -->
| name = Starbucks Corporation
| symbol = MSFT
| google = SBUX:NASDAQ
| sec_cik = 789019
| yahoo = SBUX
| yahoo = MSFT
| reuters = SBUX.O
| google = MSFT
| sec_cik = 829224
}}
}}

</pre>
===Non-U.S. Public company===
<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Finance links
| name = Royal Bank of Canada
| reuters = RY.TO
| sec_cik = 1000275 <!-- not every non-U.S. company will have SEC filings-->
| yahoo = RY.TO
| google = RY:TSE
}}
</syntaxhighlight>


Appears as:
Appears as:
{{Finance links
{{Finance links
| name = Royal Bank of Canada
| name = Microsoft Corporation <!-- can be removed, will take the page name -->
| symbol = MSFT
| reuters = RY.TO
<!-- | bloomberg = RY:CN -->
| sec_cik = 789019
| yahoo = MSFT
| sec_cik = 1000275
| google = MSFT
| yahoo = RY.TO
| google = RY:TSE
}}
}}


====Private company====
===Private company===
<syntaxhighlight lang="wikitext" style="overflow:auto;">
<pre>
{{Finance links
{{Finance links
| name = U.S. Robotics Corporation
| name = Boston Consulting Group
| google = 9605236
| sec_cik = 1127932
| yahoo = 101/101968
| hoovers = US_Robotics_Corporation.12b5e6ee5bee0096
}}
}}
</syntaxhighlight>
</pre>


Appears as:
Appears as:
{{Finance links
{{Finance links
| name = U.S. Robotics Corporation
| name = Boston Consulting Group
| google = 9605236
| sec_cik = 1127932
| yahoo = 101/101968
| hoovers = US_Robotics_Corporation.12b5e6ee5bee0096
}}
}}


== TemplateData ==
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
{{TemplateData header}}
<!-- Categories below this line, please; interwikis at Wikidata -->

<templatedata>
{
"params": {
"name": {
"label": "Company Name",
"description": "The name of the company as you would like it to appear in each link. This is usually the full, official name of the company, such as Starbucks Corporation or Apple Inc. Only needed if the page name differs.",
"type": "string"
},
"google": {
"label": "Google",
"description": "Ticker symbol, followed by a colon and the exchange, e.g., SBUX:NASDAQ for Starbucks. Generates a Google Finance link.",
"example": "SBUX:NASDAQ",
"type": "string"
},
"reuters": {
"label": "Reuters",
"description": "The Reuters \"RIC code\", a combination of the symbol, a period, and a market code.",
"example": "SBUX.O",
"type": "string"
},
"sec_cik": {
"label": "SEC CIK",
"description": "The identifier assigned by the Securities and Exchange Commission for this company.",
"example": "829224",
"type": "number"
},
"yahoo": {
"label": "Yahoo!",
"description": "Ticker symbol, including the non-US exchange code if outside of the US. Generates a Yahoo! Finance link.",
"example": "SBUX",
"type": "string"
}
},
"description": "This template provides a list of useful links to several financial and industry tracking websites for companies, both public and private. See the template page for more detailed parameter descriptions, if needed.",
"paramOrder": [
"name",
"google",
"yahoo",
"reuters",
"sec_cik"
],
"format": "inline"
}
</templatedata>

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:External link templates]]
[[Category:External link templates]]
[[Category:Finance templates]]
[[Category:Google templates]]
[[Category:Google templates]]
[[Category:Templates containing multiple external links‎]]
}}</includeonly>
}}</includeonly>

== See also ==
* {{tl|Finance links historical}}, which supports only the <code>name=</code> and <code>sec_cik=</code> parameters and should be used once companies are no longer publicly traded.

Latest revision as of 07:50, 2 February 2025

This template provides a list of useful links to several financial and industry tracking websites for companies, both public and private.

Usage

[edit]

This template should be placed in the "External links" section, preferably after any official or specialist links.

Blank syntax
{{Finance links
|name= 
|google= 
|yahoo= 
|reuters= 
|sec_cik= 
}}

Sites included

[edit]

Depending on availability of information, this template provides links to the following services:

  1. Google Finance
  2. Yahoo! Finance
  3. Reuters
  4. SEC filings at the U.S. Securities and Exchange Commission

Parameters

[edit]
name
(optional, will take the page name) The name of the company as you would like it to appear in each link. This is usually the full, official name of the company, such as Starbucks Corporation or Apple Inc.
google
Ticker symbol, followed by a colon and the exchange, e.g., SBUX:NASDAQ for Starbucks. Generates a Google Finance link.
yahoo
Ticker symbol, including the non-US exchange code if outside of the US. Generates a Yahoo! Finance link.
reuters
The Reuters "RIC code", a combination of the symbol, a period, and a market code, e.g., SBUX.O for Starbucks (here "O" represents "over-the-counter," a legacy from when Nasdaq was an over-the-counter market before it was an exchange).
in all the above cases, the symbol/code should be those of the company's home country.
sec_cik
The SEC CIK (Central Index Key) is an identifier assigned by the Securities and Exchange Commission for all companies that file reports with the SEC, including all companies traded publicly on US stock exchanges and many large private companies. To find the CIK for any filing company, search for the company name at https://www.sec.gov/edgar/searchedgar/cik.htm. The CIK code is listed directly on the search results page, to the left of the company name. Any leading zeros may be removed from this number. For example, the search results for a query of "microsoft" returns two entries. The relevant entry is listed as "MICROSOFT CORP" and has a CIK of 789019 (with 4 leading zeros removed). While the symbol will also work in this field, the CIK is far preferable as the symbol will lead to a search page that requires additional navigation.

Examples

[edit]

U.S. Public company

[edit]
{{Finance links
| name = Starbucks Corporation <!-- can be removed, will take the page name -->
| google = SBUX:NASDAQ
| yahoo = SBUX
| reuters = SBUX.O
| sec_cik = 829224
}}

Appears as:

  • Business data for Starbucks Corporation:

Non-U.S. Public company

[edit]
{{Finance links
| name = Royal Bank of Canada
| reuters = RY.TO
| sec_cik = 1000275 <!-- not every non-U.S. company will have SEC filings-->
| yahoo = RY.TO
| google = RY:TSE
}}

Appears as:

Private company

[edit]
{{Finance links
| name = Boston Consulting Group
| sec_cik = 1127932
}}

Appears as:

TemplateData

[edit]
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Finance links in articles based on its TemplateData.

TemplateData for Finance links

This template provides a list of useful links to several financial and industry tracking websites for companies, both public and private. See the template page for more detailed parameter descriptions, if needed.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Company Namename

The name of the company as you would like it to appear in each link. This is usually the full, official name of the company, such as Starbucks Corporation or Apple Inc. Only needed if the page name differs.

Stringoptional
Googlegoogle

Ticker symbol, followed by a colon and the exchange, e.g., SBUX:NASDAQ for Starbucks. Generates a Google Finance link.

Example
SBUX:NASDAQ
Stringoptional
Yahoo!yahoo

Ticker symbol, including the non-US exchange code if outside of the US. Generates a Yahoo! Finance link.

Example
SBUX
Stringoptional
Reutersreuters

The Reuters "RIC code", a combination of the symbol, a period, and a market code.

Example
SBUX.O
Stringoptional
SEC CIKsec_cik

The identifier assigned by the Securities and Exchange Commission for this company.

Example
829224
Numberoptional


See also

[edit]
  • {{Finance links historical}}, which supports only the name= and sec_cik= parameters and should be used once companies are no longer publicly traded.