BLOOMBERG
USER MANUAL
Help x2
Press the HELP key twice for instant live assistance.
Frankfurt +49 69 92041 0
New York +1 212 318 2000
Singapore +65 6212 1000
Hong Kong +852 2977 6000
San Francisco +1 415 912 2960
Sydney +61 2 9777 8600
London +44 20 7330 7500
São Paulo +55 11 3048 4500
Tokyo +81 3 3201 8900
bloomberg.com
©2007 Bloomberg L.P. All rights reserved. 22538703 0207
GETTING STARTED
02 The Bloomberg Keyboard Keyboard and navigation 04 Creating a Login Name and Password 06 Finding Information The <HELP> key 06 The Global Help Desk: 24/7 Interact with the Bloomberg Help Desk 08 Broad Market Perspectives Top recommended functions 09 Analyzing a Company Basic functions for Bonds and Equities 10 Communication The BLOOMBERG PROFESSIONAL service message system 11 Tips, Tricks and Fun 12 Customer Support
If you are not utilizing a Bloomberg-provided keyboard, press the Alt + K buttons simultaneously to view an image of your keyboard. This will enable you to position your Bloomberg keyboard stickers accurately.
NAVIGATE THE BLOOMBERG PROFESSIONAL SERVICE ®
The Bloomberg keyboard has been color-coded for ease-of-use. Red keys are STOP keys
Green keys are ACTION keys
CONN DFLT
CANCEL
PANEL
Press once to log-In to the system. Press once to log-out of the system.
GO
The <GO> key is equivalent to the ‘Enter’ key on a traditional keyboard and is essential to activate each function. Simply press it after you enter a command.
MENU
The <MENU> key is essential in the navigation process. This is equivalent to the ‘Back’ key to return you to the previous screen.
Equivalent to the traditional ‘Escape’ button Press <Cancel> to reveal Bloomberg’s Global Customer Support numbers.
Leverage all four BLOOMBERG PROFESSIONAL service windows. Press <PANEL> to rotate between the windows.
PAGE FWD
Yellow keys correspond to Market Sectors EQUITY
02
GO
Press any of the yellow keys for a main menu for that specific sector; e.g. <EQUITY> <GO> will bring you to a complete menu of equity-related news, data and analytics.
HELP
PAGE BACK
Press <Page Fwd/Back> to access the next/previous screen.
Press <PRINT> to print a one-page screen. Enter {# of pages} <PRINT> for consecutive pages. Keyword Search: enter a keyword at the top of the BLOOMBERG PROFESSIONAL service screen and press <HELP> to search our entire database of information.
Press <HELP> once for more detailed information on the function you are viewing. Press <HELP> twice to interact with the Bloomberg Help Desk, 24 hours a day, seven days a week.
HDSK <GO> to access your previously sent Help Desk queries and answers.
03
Creating a login name and password Changing your Password 1. Once the Bloomberg software has been installed, use the mouse to double click on the Bloomberg icon that appears on your desktop to launch the application.
Once the login name has been chosen it is fixed permanently, however the password may be changed as often as you like. Please use the function UUF <GO>.
2. Press the RED <Conn Default> key once (equivalent to the pause break key on a traditional keyboard). Leave the login and password fields blank and press <GO>.
Once your login has been validated we recommend that you define the personal defaults associated to your login. These settings include time zone, base currency, country, etc and will impact other functions. Simply type PDFQ <GO> and enter your choices in the boxes provided.
3. Answer the five basic questions to complete the login creation process. 4. A member of Bloombergâ&#x20AC;&#x2122;s Global Customer Support team will call you shortly to validate your new login. At this point, they can also assist with other initial questions you may have, including setting up a training session. Please note: It is important that your login is validated within five days. If we are unable to contact you and validate your details, the login will expire. Should this happen, please repeat the instructions above to create a new login.
04
If you are a Bloomberg AnywhereSM, subscriber, your final step is the registration of your B-unit authentication device. Type BA <GO> and follow the instructions on the screen or refer to the documentation included with the B-unit device. ANY <GO> provides on-line documention for account setup and enrollment. Sm
For technical assistance you can always call our Global Customer Support. Press the RED <CANCEL> key for a list of local technical support numbers.
05
Finding Information and Keyword Searches The <HELP> key is your gateway to finding all information on the BLOOMBERG PROFESSIONAL service. Whether you are looking for company ticker codes, indices, new stories by subject, biographies, and more the <HELP> key will find it for you. At the top of the screen, type a keyword(s) associated with your subject of interest followed by the <HELP> key. Here are some examples: 1. Company Ticker Search: Intel <HELP> Select # 10, ‘Companies/Govts/Orgs’ to display all the companies with the name of Intel 2. People Search: Warren Buffett <HELP> Select # 7, ‘People’ to access the Profiles database and display a complete biography of Warren Buffett 3. Earnings Estimates: Earning Estimates <HELP> Select # 3 ‘Functions/Analytics/Internet’ to display a comprehensive list of relevant earnings functionality
The Bloomberg Help Desk is available 24 hours a day, seven days a week and provides immediate assistance to our customers worldwide. The INSTANT BLOOMBERGSM (IB) communication platform allows any Bloomberg user to send an enquiry to the Help Desk and receive a response in real time. Press the <HELP> key twice to open a ‘LIVE HELP’ chat window. In the orange box type your query and press <GO> to send.
06
07
BROAD Market perspectives
Analyzing a company
Many of these screens are customizable so that you can change the parameter to suit your needs.
If you are already familiar with the ticker of the security, enter:
MAIN <GO> Menus for market sectors, customer support and more TOP <GO> Display today’s top business and general news headlines READ <GO> Most popular news stories AV <GO>
BLOOMBERG NEWS® audio/video reports
N <GO>
The main news menu
ECO <GO>
Displays a calendar of economic releases
IM <GO>
Display a menu of treasury/money market and international bond monitors
WEI <GO>
Monitor worldwide returns for Equity indices
WB <GO>
World Government bond monitor
ACDR <GO> Display an earnings announcement calendar MOST <GO> Monitor the most active securities by volume, up, down and value IBQ <GO>
Industry overview: choose from more than 68 industries
CBQ <GO>
Country overview: choose from more than 46 countries
QSRC <GO> Scan the Bloomberg Equity universe to find companies that match your selected criteria BLP <GO>
BLOOMBERG LAUNCHPADSM, The ultimate customizable desktop monitor
TICKER <YELLOW KEY> Function <GO> to bring you to that function An Equity example: BUD <Equity> DES <GO> A Bond example: BUD 9 12/1/09 <CORP> DES <GO> Descriptive page including a snapshot of fundamental data and management information BQ <GO> Display price, trade, earnings, relative value data on a single screen CN <GO> Display all Company News GPO <GO> Graph historical prices and moving averages RELS <GO> Related Securities — The capital structure CRPR <GO> Credit Profile — Current and historical credit ratings for an issuer RV <GO> Relative Value — Perform customized peer group analysis ISSD <GO> Display issuer information, capital structure and cash flow breakdown COMP <GO> Comparative returns for your chosen security to its benchmark index and its industry group DES <GO>
Equity Specific ANR <GO> Displays analyst recommendations EEB <GO> Display Bloomberg Earnings Estimates Bond Specific YAS <GO> Yield and Spread Analysis ALLQ <GO> A liquidity platform of price and yield quotes from contributed sources
To view a Launchpad display: From the Launchpad toolbar, click ‘Tools’ and then sample views
08
09
Communication
Tips, Tricks and Fun
MSGM <GO> The main message menu which outlines the function codes needed to send a message, retrieve incoming messages, set up message defaults and more.
Need to find a good restaurant? Want to check out the weather or view a flight schedule? In addition to the best business and financial data, use Bloomberg as a resource for all your personal and lifestyle information.
Shortcuts and FAQs MSG JOHN BROWN or MSG jbrown@aol.com <GO> Enter the BLOOMBERG PROFESSIONAL service customer’s name, group or Internet address
BERRY <GO> Access the BLOOMBERG PROFESSIONAL service on your BlackBerry®
MSG1 FROM JOHN BROWN <GO> View all messages received from a specific user
MUSE <GO>
Arts and culture
POSH <GO>
Classified adverts
BSP <GO>
Bloomberg sports menu
DINE <GO>
Restaurant search and reviews
FLY <GO>
Flight schedules
WEAT <GO>
Regional weather forecasts
MSG1 UNREAD <GO> View all unread incoming messages
BBXL <GO>
Bloomberg data and calculations in Excel — Download sample spreadsheets
MSG4 UNREAD <GO> View all unread outgoing messages
JOBS <GO>
Bloomberg career center
EASY <GO>
Ease-of-use tips and shortcuts
SPDL <GO> Create and maintain a speed-dial list that serves as your address book. Store information for each user, including job title, company, address, phone and fax numbers
PSET <GO>
Printer settings
EXCH <GO>
Real-time exchanges and request form
HDSK <GO>
Historical archive of all your Help Desk enquiries and corresponding answers
MSG4 TO JOHN BROWN <GO> View all messages sent to a specific user MSG1 FROM INTERNET <GO> View all messages received from an Internet address MSG4 TO INTERNET <GO> View all messages sent to Internet addresses
GRAB <GO> Send a single BLOOMBERG PROFESSIONAL service screen shot as a message attachment IB JOHN BROWN <GO> Chat in real time via Instant Bloomberg
10
NI WNEWS <GO> Who’s who? Movers and shakers, hires and fires PEOP <GO>
People Search
11
Customer Support
The outstanding level of customer and product support provided by Bloomberg will ensure you are always up-to-date with the latest features and benefiting from the full value of the BLOOMBERG PROFESSIONAL service. The following options are available for your use: BREP <GO> Display the name of your dedicated Bloomberg Account Representative. BU <GO> BLOOMBERG UNIVERSITY速 provides you with a menu of training resources that can help you better navigate the BLOOMBERG PROFESSIONAL service. View all on-line training manuals, register to attend Bloomberg seminars and events, request on-site training, or read about new functions and enhancements. CERT <GO> The Product Certification program has been designed to equip financial professionals with the power of the BLOOMBERG PROFESSIONAL service. Participate in well-structured classes to improve your knowledge and proficiency of Bloomberg, optimize your job performance, and differentiate yourself from your peers. NEXT <GO> Stay up-to-date with new and enhanced functionality. <HELP> <HELP> Contact the LIVE 24/7 Global Help Desk to send enquiries and receive help in real time.
12
Bloomberg LP Enhanced Excel New Excel Add-in 2007
1
WHAT’S NEW ............................................................................................. 3 ACCESSING THE NEW & PREVIOUS ADD-INS ....................................... 4 USING THE WIZARDS................................................................................ 5 IMPORT DATA WIZARD .......................................................................................................... 6 1. MARKET DATA (most recent data) and BULK DATA....................................................... 7 2. HISTORICAL DATA ............................................................................................................. 12 3. INTRADAY DATA ................................................................................................................. 19 5. FIELD SEARCH TOOL......................................................................................................... 23 6. FUNDAMENTALS WIZARD ............................................................................................... 25 7. POPULATE TABLE............................................................................................................... 26 8. FORMULA BUILDER ........................................................................................................... 27
FORMULA WRITING ................................................................................ 31 1. BDP........................................................................................................................................... 32 2. BDS ........................................................................................................................................... 34 3. BDH .......................................................................................................................................... 35 HISTORICAL TIME SERIES .................................................................................................. 36 INTRADAY HISTORICAL TIME SERIES ............................................................................ 37 3.
OVERRIDES....................................................................................................................... 38
APPENDIX A: OPTIONAL ARGUMENTS FOR BDH FORMULAS.......... 41 APPENDIX B: ERRORS ........................................................................... 44
2
WHAT’S NEW The Bloomberg Excel Add-In product has been enhanced to simplify your spreadsheets and proprietary model needs. More than the ever the Bloomberg Excel Add-in wizards and functionality integrates seamlessly with the Microsoft look and feel. Functions: • BDP replaces the BLP formula • BDH replaces BLPH, BLPSH, BLPI • BDS replaces BLPB Nesting now supported: • Nesting of formulas is now supported. This can be done in 2 ways: • An Excel function nested in a Bloomberg function; =BDP(IF • A Bloomberg function nested in an Excel function; =IF(BDP • =NOW() and =TODAY() functions are now compatible [no need to use =blptoday() and =blpnow()] Wizards: • “Import Data” tool consolidates the History, Intraday, Bulk and Table wizards • Table wizard AND Bulk wizard type information is downloaded via “Market, Reference, Analytical, Data Sets” option • Intraday wizard data is downloaded via “Historical Intraday” • History wizard data is downloaded via “Historical End of day” • Better field search logic derived from FLDS<GO> has been implemented Help: • There is now a comprehensive HELP file for the add-ins that can be accessed via the Bloomberg Menu • Fx function toolbar also has a Bloomberg component describing each new formula type. To access it click on the Excel fx box next to the Excel formula bar then under “Or select a category:” choose “Bloomberg”. Errors: • Errors have been consolidated/ simplified to facilitate interpretation BBXL: • BBXL will be revised and there will be a link to the previous BBXL Arrays Automatic array creation will no longer be supported in this add-in. Cell locking rules are as follows: • =B6 : relative row and column reference • =$B6 : column is anchored or absolute and row is relative • =B$6 : row is anchored or absolute, column is relative • =$B$6: Both column and row are anchored and absolute
*** BLP FORMULAS AND PREVIOUS WIZARDS WILL STILL WORK!***
3
ACCESSING THE NEW & PREVIOUS ADD-INS
• • •
The previous Bloomberg Add-ins will still work. This includes the previous wizards as well as the BLP, BLPI, BLPH and BLPSH They can be accessed via the “Bloomberg” menu on the excel Toolbar under “Previous Bloomberg Menu” The weather wizard, Performance wizard and IBES conversion tool will only be accessible via the previous Bloomberg menu
4
USING THE WIZARDS There are 6 Items on the new Bloomberg Add-in Toolbar.
1. 2. 3. 4. 5. 6. 7. 1. Import Data - A tool which allows retrieval of all data types (current, intraday, historical and bulk) 2. Function Builder- A tool for building formulas- provides a quick link to the Excel fx box which serves the same function. 3. Fundamentals Reports- A tool for bringing in Fundamentals data in a report format 4. Field Search â&#x20AC;&#x201C; A tool for looking up field mnemonics 5. Populate Table- A tool for populating current data once a field mnemonic and security identifier are placed in the sheet 6. Refresh All Workbooks- A tool for refreshing links in the sheet 7. Contact Bloomberg- A button which launches a chat with the HELPDESK
CLICK INTO ANY TOOL TO LAUNCH IT
5
IMPORT DATA WIZARD Click the
icon on the toolbar to open the wizard.
Import data This wizard combines the former Table, Bulk, Historical and Intraday Wizards. The advantage of this is that all sorts of data are accessible via one wizard. Each option is a distinct data path i.e. the outcome depends on the data type selected. On the first page you have the option to choose what sort of data you want to download. • • •
Market, Reference, Analytical, Data Sets- pulls in current data and Bulk information (combines previous Table wizard and Bulk wizard) Historical End of Day- pulls in historical data (equivalent of previous History wizard) Historical Intraday- pulls in intraday data (equivalent of previous Intraday Wizard)
Notes on using wizard: Use the “?” icon in the top left corner of the wizard to get help on any component. Click on the “?” then use the cursor to point and click on the part of the wizard you have a question on. You will be taken to a page of the add-in HELP files describing how to use this component.
6
1. MARKET DATA (most recent data) and BULK DATA
7
MOST RECENT DATA
Step 1- Select Securities
3 different ways to select securities: 1. Hand type each security and hit ADD in the wizard (or hit ENTER/GO from the keyboard) • Market sector is selected from the “market sector” dropdown. The yellow keys on the keyboard can also be used. 2. Click on the “From” Box and select “Equity indices” • Select from a list of pre-populated equity indices listed in the “indices” box 3. Click on the “From” Box and select “Spreadsheet” • Highlight a range of securities in your sheet by clicking into your workbook.
Notes on using this page: To remove one of all of the securities use the “Remove” and “Remove all” fields respectively, located on the bottom right hand side of the wizard. Combinations of the above 3 security selection methods can be used. Dragging in securities from Bloomberg pages using the pushpin icon is still supported.
8
MOST RECENT/BULK DATA
Step 2- Field Selection
2 ways to select fields: 1. Field source “Spreadsheet” • Highlight a range of cells in your worksheet then click “Import” • Selected fields appear in the box on the right hand side 2. Field source “Bloomberg Fields” a. Keyword Search • Type a keyword then hit “Search” or hit “GO” on the keyboard. • A list of fields is returned on the LIST tab and will be ranked from most to least popular/ relevant. This search runs on the same logic as the page FLDS<GO>. • Click on the field you want and hit “ADD” or <GO>. b. Manual search: • On the “Categories tab” double click on “+” signs to expand folders and find the field of interest • Locate the field of interest and hit “ADD” • Notes on using this page: When you click on a field its definition will be listed in the gray area at the bottom of the wizard. Selecting “More field details” at the bottom left will show the definition of each field along with the mnemonic and name in the top part of the wizard. To remove one of all of the fields use the “Remove” and “Remove all” fields respectively, located on the bottom right hand side of the wizard. You can use CNTL-Click or SHIFT-Click to select multiple fields.
9
MOST RECENT/BULK DATA
Step 2- Field Selection cont…
Filter option • Allows you to filter for DataSets (bulk), RealTime or Static fields and to filter fields by market sector dependent on security choices on first page. Field types &icons Different field types will have icons under the “Type” header indicating what sort of data they will retrieve. denotes real time fields denotes bulk/data set type fields Any fields with no icon are static fields
10
MOST RECENT DATA
Step 3- Layout Options
Data placement: • Existing worksheet- allows you to designate the cell where the results are outputted in the current sheet • New worksheet- data will be populated in a new worksheet Show Labels Options: • Security- When selected outputs the names of the securities into excel • Field- When selected outputs the Field mnemonics into excel Orientation Options: • Horizontal Fields- Field names are aligned horizontally • Vertical Fields- Field names are aligned vertically Data set aggregation: • Aggregate in a single cell – for bulk fields this option will place all of the bulk information in one cell when checked Table Layout Applies to the layout of the different data types; bulk and static/real time. A graphical data orientation in excel appears on the right hand side of the wizard. Bulk information is shown in blue and static/realtime data is shown in grey. • Horizontal- the bulk fields will be aligned horizontally to the right of the data for the static/real time fields • Vertical- the bulk fields will be aligned vertically below the data for the static/real time field CLICK FINISH TO OUTPUT RESULTS TO EXCEL 11
2. HISTORICAL DATA
12
HISTORICAL DATA
Step 1- Select Securities
3 different ways to select securities: 1. Hand type each security and hit ADD in the wizard (or hit ENTER/GO from the keyboard) • Market sector is selected from the “market sector” dropdown. The yellow keys on the keyboard can also be used. 2. Click on the “From” Box and select “Equity indices” • Select from a list of pre-populated equity indices listed in the “indices” box 3. Click on the “From” Box and select “Spreadsheet” • Highlight a range of securities in your sheet by clicking into your workbook. Notes on using this page: To remove one of all of the securities use the “Remove” and “Remove all” fields respectively, located on the bottom right hand side of the wizard. Combinations of the above 3 security selection methods can be used. Dragging in securities from Bloomberg pages using the pushpin icon is still supported.
13
HISTORICAL DATA
Step 2- Field Selection
2 ways to select fields: 1. Field source “Spreadsheet” • Highlight a range of cells in your worksheet then click “Import” • Selected fields appear in the box on the right hand side 2. Field source “Bloomberg Fields” a. Keyword Search • Type a keyword then hit “Search” or hit “GO” on the keyboard. • The returned list of fields on the LIST tab will be ranked from most to least popular/ relevant. This search runs on the same logic as the page FLDS<GO>. • Click on the field you want and hit “ADD” or <GO>. b. Manual search: • On the “Categories tab” double click on “+” signs to expand folders and find the field of interest • Locate the field of interest and hit “ADD” Notes on using this page: When you click on a field its definition will be listed in the gray area at the bottom of the wizard. Selecting “More field details” at the bottom left will show the definition of each field along with the mnemonic and name in the top part of the wizard. To remove one of all of the fields use the “Remove” and “Remove all” fields respectively, located on the bottom right hand side of the wizard. You can use CNTL-Click or SHIFT-Click to select multiple fields.
14
HISTORICAL DATA
Step 3- Periodicity and Time Frame Selection
To select your periodicity and time frame: 1) Periodicity options: Â&#x192;
Calendar Type :
Calendar
Returns results based on the fiscal year for the specified securities. Returns results based on calendar intervals.
Actual
For example, if you ask for monthly data and the end date is 2/15, you will see data for each month in the interval on the last calendar day of that month. Returns results based on the actual date specified.
Fiscal
For example, if you ask for monthly data and the end date is 2/15, you will see data for each month in the interval on the
15
HISTORICAL DATA
Step 3- Periodicity and Time Frame Selection cont…
Periodicity: Fiscal Calendar & Actual
Yearly, Semi-Annual, and Quarterly Yearly, Semi-Annual, Quarterly, Monthly, Weekly, Daily
2) Time Frame options:
Fixed Time Series: o Date options: select a specific start and end date or check off the “Current” box to have data come in from start date until current date. o Period options: Select a start and end period: Example: Start date: FQ1 2001 ; End date: FQ4 2006 Relative Time Series: o End date options: Today (current date) , Date (a specific date chosen by user), Period (a specific fiscal, calendar or actual period) o Note: When using the Period option for the End date option, the options in the dropdown are dependent on what you selected for “Calendar type” under “Periodicity”. If you choose Actual, then your period options will be AQ1, AQ2, AQ3, AQ4 if you chose fiscal: FQ1FQ4 and so on o Number of periods: number and type of periods you want to view relative to the end date. Example: 4 years relative to today
16
HISTORICAL DATA
Step 4- Optional Parameters
Currency: Select what currency to download data in Non trading days: Choose whether to exclude or include non trading days. Options are: • Exclude- excludes non trading days • Include all non-trading weekdays • Include all calendar days – includes non-trading weekdays and weekends If you select “Include all calendar days” or “Include all non-trading weekdays” you are presented with the following filler options: o “Carry over last price” o “#N/A N/A” o Custom
Quote: For yield quoted securities only- select if you want to download the data in price or yield
17
HISTORICAL DATA
Step 5- Layout Options
Data placement: • Existing worksheet- allows you to designate the cell where the results are outputted in the current sheet • New worksheet- data will be populated in a new worksheet Show Labels: • Security- When selected outputs the names of the securities into excel • Field- When selected outputs the Field mnemonics into excel • Date- When selected displays the dates alongside the data Field Orientation: • Horizontal - Field names are aligned horizontally • Vertical - Field names are aligned vertically Multi-sheet: • Single security per sheet- when selected distributes data in different sheets in the workbook on a per security basis Time Ordering: • Chronological- when selected data is displayed with most recent data first • Reverse Chronological- when selected data is displayed with most recent last CLICK FINISH TO OUTPUT RESULTS TO EXCEL 18
3. INTRADAY DATA
19
INTRADAY DATA
Step 1- Select Securities
3 different ways to select securities: 1. Hand type each security and hit ADD in the wizard (or hit ENTER/GO from the keyboard) • Market sector is selected from the “market sector” dropdown. The yellow keys on the keyboard can also be used. 2. Click on the “From” Box and select “Equity indices” • Select from a list of pre-populated equity indices listed in the “indices” box 3. Click on the “From” Box and select “Spreadsheet” • Highlight a range of securities in your sheet by clicking into your workbook. Notes on using this page: To remove one of all of the securities use the “Remove” and “Remove all” fields respectively, located on the bottom right hand side of the wizard. Combinations of the above 3 security selection methods can be used. Dragging in securities from Bloomberg pages using the pushpin icon is still supported.
20
INTRADAY DATA
Step 2- Select Data Type/Interval
Market Events: Select what sort of intraday data you want to download. Options are: • Trade, Bid, Ask Interval Fields: Select what information you want to download for the specified summary interval. Options are limited to the following: • Open: First tick of each interval • High: Highest tick of each interval • Low: Lowest tick of each interval • Close: Last tick of each interval • Tick count: number of ticks in the interval • Volume: volume traded for the interval Time Frame: Select date and time that you want to download the data for. Hand type of use dropdown. Interval Size: Designate the intervals for which you want to view the tick data. 1 minute is the most granular. Non- trading intervals: Select if you want to include or exclude non-trading days. Filler options are available. 21
INTRADAY DATA
Step 3- Optional parameters
Data placement: • Existing worksheet- allows you to designate the cell where the results are outputted in the current sheet • New worksheet- data will be populated in a new worksheet Show labels: • Security: when selected displays the security name(s) in the sheet • Field: when selected field mnemonics are outputted to the sheet • Date and Time: when selected date and time of intraday data are shown in sheet Field Orientation: • Horizontal - Field names are aligned horizontally • Vertical - Field names are aligned vertically Multi-sheet: • Single security per sheet: when selected distributes data in different sheets in the workbook on a per security basis Time Ordering: • Chronological: when selected data is displayed with most recent data first • Reverse Chronological: when selected data is displayed with most recent l CLICK FINISH TO OUTPUT RESULTS TO EXCEL 22
5. FIELD SEARCH TOOL Click the
icon on the toolbar to open.
To search for Bloomberg API fields: 1. â&#x20AC;˘ â&#x20AC;˘
In the Search text input field, enter one or more keywords or partial words. You can search for the field by field name (for example, Ask Price) or mnemonic (for example, PX_ASK). You can search for multiple fields by using a partial word (for example Price or PX)
2. From the Filter drop-down list, select one or more markets. These markets correspond to the yellow keys on your Bloomberg keyboard. You also have the ability to select the field type from this dropdown. Types include: DataSets, Historical, RealTime and Static
23
Field Search Tool cont… 3. Click Search or hit GO on your keyboard • • •
A list of fields appears the List tab. Note that when you select a field, the field's description appears at the bottom of the categories list. You can use CNTL-Click or SHIFT-Click to select multiple fields. Different field types will have icons under the “Type” header indicating what sort of data they will retrieve. Drill down through the list of fields in the Categories tab and select one or more fields.
denotes real time fields denotes bulk/data set type fields denotes historical fields Any fields with no icon are static fields
4.Click the Add button. This moves the selected fields into the Selected fields section. 5. Choose the desired Field layout option at the bottom of the wizard. • •
Horizontal- fields will be applied horizontally to the sheet Vertical- fields will be applied vertically to the sheet
6.Click Apply to add the fields to your spreadsheet.
24
6. FUNDAMENTALS WIZARD This wizard outputs fundamentals reports of your choice into excel. To open the Fundamentals wizard click on the icon on the toolbar. This wizard has not been modified and will look and function as it did in the previous add-in.
Ticker: Enter the ticker symbol of your security. Display order: • Chronological displays your security with the oldest data first. • Reverse chronological displays your security with the newest data first. • Comparative Periods displays your security's data within the parameters set in the Time Series fields. Filing Status: Select whether to display the Preliminary filing or the Most Recent filing. Currency: Select the 3 letter ISO code of the currency to display your report in. The currency defaults to the default currency for the security selected. From the dropdown list, you can select another currency to override the default. Period Type Fixed Time Series: Choose a start date (month/year) and a end date (month/year) for the period type. Relative Time Series: Choose a relative time for the period type. You can select an end date and then determine how many periods to display historically. You can select a Number of Periods between 1 and 20. Templates: Choose a pre-made template to download to your sheet
25
7. POPULATE TABLE To open the Populate Table wizard click on the icon on the toolbar. This wizard will work the way the Fill Range tool did in the previous add-in: Place your securities and fields in the sheet so that there is one anchor cell separating them to the left of the fields and directly above the securities as shown:
Place your cursor in the anchor cell and then hit the icon. Select the appropriate link type from the window that follows. Your table will then be populated with data.
26
8. FORMULA BUILDER To open the Formula Builder click on the walk the user through creating a formula.
icon on the toolbar. This wizard will work
1. Select the function type you want to create then hit OK. Descriptions of the type of data each function retrieves are provided at the bottom of the wizard once the function is highlighted. See above.
27
2. The above window will appear where the user can enter their required parameters which will differ dependent on the function type chosen (in this case BDH)
2.Optional Parameters/ arguments are denoted as Option1, Option2, Option3 etc. They are listed following the required parameters and are highlighted in blue. Click onto the blue hyperlink for any option to display a list of choices
28
Ă&#x2026; The Diagram to the left is a representation of the Optional argument selection box. The Name column on the left hand side provides the long name of each optional. The Code column on the right hand side lists the short names. (Short and long names can be used interchangeably when writing formulas manually. Short is recommended as they economize character use in the formulas)
Clicking onto any option name listed in the Argument box will display different selections for the option as well as a definition. In this diagram Period is highlighted. The different selections for this argument are listed under Value and the definition can be seen at the bottom of the window.
29
3. Once you select an argument the short name/ code for that optional argument will be placed into the option box (in this case the option â&#x20AC;&#x153;dailyâ&#x20AC;? was selected). To add another option click on the blue hyperlink for one of the unused options and repeat the same process. 4. Once all of the required parameters and desired number of optional arguments are entered click on OK to have the formula and the data outputted in your sheet.
30
FORMULA WRITING The formulas have been consolidated and optional parameters are now more flexible. Formula types: • BDP (Bloomberg Data Point) for current data. This is equivalent to BLP • BDH (Bloomberg Data History) for historical end of day and historical intra day data. This is equivalent to BLPH, BLPSH and BLPI • BDS (Bloomberg Data Set) for large data sets/ bulk data. This is equivalent to BLPB
Array information Automatic array creation will no longer be supported in this add-in. Excel cell locking rules will need to be applied. Cell referencing/ locking rules: =B6 : relative row and column reference =$B6 : column is anchored or absolute and row is relative =B$6 : row is anchored or absolute, column is relative =$B$6: Both column and row are anchored and absolute
31
1. BDP BDP (Bloomberg Data Point) returns the same data as the Market Data/Reference data option in the Data Wizard. This is static or real time current market data. It is the equivalent of the BLP formula from the previous add-in. Note: Previous automatic array creation when using multiple securities or fields is not permitted. Excel cell locking rules apply if using multiple fields/securities.
Syntax 1.One Security, One field: =BDP (security, field) •
•
Cell references when using one security and one field: =BDP(A2,B1) where A1 contains the security and B2 contains the field mnemonic
Literal references (implementation of quotation marks) =BDP(“goog equity”,”px last”)
2. One security, multiple fields •
Cell reference: The column must be locked =BDP($A2,B1)
Note: To lock the column holding the security, hit F4 3x. This locks the relative column.
32
•
Literal reference : Because automatic array creation is no longer supported, literal references with multiple fields will no longer work ie: =bdp(“ïbm equity, “px last, name, crncy”) is not a valid syntax
3. Multiple securities multiple fields: •
Cell reference: The relative row and column must be locked. =BDP($A2,B$1) Note: To lock the security hit F4 3x. This locks the relative column for the security. To lock the row with the field mnemonics hit F4 2x. This locks the relative row for the fields. You can now drag this across:
33
2. BDS BDS (Bloomberg Data Set) returns informational bulk data. It pulls in the same information as the Data Set option in the Data wizard. This replaces the BLPB formula. Syntax =BDS (security, field) Cell Reference: =BDS(A2,B1)
Literal Reference: =BDS(“goog equity”, “cie des bulk”)
34
3. BDH BDH (Bloomberg Data History) returns the historical data for a selected security or set of securities. This is the equivalent of the intraday and historical end of day options in the Data Wizard. It replaces the old BLPI, BLPSH and BLPH formulas Syntax =BDH (security, fields, start date, end date, [optional argument(s)]) ** Please see Appendix A for the optional parameters Required Arguments: • • • •
Security Field Start date (mm/dd/yyyy) End date (mm/dd/yyyy)
35
HISTORICAL TIME SERIES (equivalent of BLPH) There are two methods for entering arguments into the Excel spreadsheet, via a range, or via an absolute value. 1. Specifying optional arguments via a range: Syntax: =BDH(security, field, start date, end date, range of optional argument codes, range of values for optional arguments) In Figure Below:
#1 is the Range of optional arguments #2 is the Range of VALUES for the optional arguments
Example: =BDH(A2,B1,C1,D1,F1:F3,G1:G3) 1.
2.
5. Specifying optional arguments via an literal reference (using quotations): Syntax: =BDH(security, field, Start Date, End date, “optional argument = argument value”) Example: =BDH(security, field, Start Date, End date, “curr=GBP, Days=C, Sort=D”)
**Note: • The optional arguments can be specified in any order and have advanced options. For example the “Fill” argument has a custom option where any desired value can be chosen to display for non-trading days. For more information see Appendix A. • Although End Date is a required parameter, if you cell reference a blank cell for this parameter it will default until current. If you are doing a literal reference use a double set of quotes for this parameter to achieve the same outcome: “” • A BLPSH formula or a formula requesting one historical data point is achieved by using the SAME start and end date in the BDH formula
36
INTRADAY HISTORICAL TIME SERIES For historical intraday requests you must use “Barsz” or “BarTp” in the optional parameters to indicate a request for granular data. Just as with the previous BLPI formulas, only a specific set of fields are valid: OPEN, HIGH, LOW, LAST_PRICE, NUMBER_TICKS, VOLUME
1.
2.
1. Optional Arguments 2. Argument Values In the above example we are requesting opening tick ask data for 5 minute intervals from 2/22/2007 09:00-2/23/2007 16:00 (please see Appendix A for optional arguments and values) Syntax: =BDH(security, field, start date/time, end date/time, range of optional arguments, range of values for optional arguments) 1. Via a Range: =BDH(security, field, start date& time , end date & time, F1:F2, G1:G2) 2. Via literal referencing: =BDH(security, field, start date& time, end date& time, “barsz=5,bartp=a”)
Note: Other optional arguments such as Fill, Orientation and Per will work with the intraday requests. Please see appendix A for other valid optional arguments.
37
3. OVERRIDES Syntax: =BDP(Security, fields, input field, input value cell) **Note: Arrays will NOT be created automatically so cell anchoring is necessary 1. Cell referencing =BDP($A3,B$2,$C$2,$C$1) The above formula: 1. 2. 3. 4.
locks the column holding the security locks the row holding the fields creates an absolute lock for the input field creates an absolute lock for the input value cell
For only getting a value in one cell: =BDP(security, reactive field , input field(s), input value cell(s))
Because we only want to produce one value, we do not drag the formula across and therefore we donâ&#x20AC;&#x2122;t use any cell locking in the above formula shown in the fx toolbar in the above figure: =BDP(A3,B2,C2,C1)
38
Cell referencing with multiple input cells/values:
The formula from the above figure is: = BDP($A3,B2,$C$2:$D$2,$C$1:$D$1) Place your cursor in A3 and hit the F2 Key to see the placement of all the cells in the formula:
2. Literal referencing: Using the index weight override as an example (the index ticker is case sensitive): =BDP("BUD9 Corp","DUR_ASK","PX_ASK","100") Alternatively you can use the syntax: =BDP(Security, field, input field= input value) Example with one input field/value: =BDP("BUD9 Corp","DUR_ASK","PX_ASK=100") Note: using multiple reactive fields is not possible with the literal reference. However, you can use multiple input fields and input values. Example with twp input fields/values: =BDP("BUD9 Corp","DUR_ASK","PX_ASK=100,SETTLE_DT=20070102") Which is the same as the below formula with the alternative syntax: =BDP("BUD9 Corp","DUR_ASK", "PX_ASK, SETTLE DT","100, 20070220")
39
You can also do a combination of literal and cell referencing to derive the same data as in the above examples. See below:
40
Appendix A: Optional Arguments for BDH formulas Argument Description/ Possible Argument Values Currency. Currency of the ISO Code. The 3 letter ISO code, in quotation marks, of the currency (ie. "USD" for US Dollars). Curr
This is NOT available for Intraday. Non-Trading Days. Sets whether to either exclude or include Non-trading days where no data came in. The valid enters are: • • • • •
Days
N - All weekdays C - All calendar days T - Trading W - Weekdays A - all days.
See also: Fill Show Date is the Boolean flag that enables you to turn on/off the trading date. The valid entries are: • •
TRUE = Show the date FALSE = Hide the date.
Dts Date output format. Allows the you to return a date format as either: • •
regular (ie: yyyymmdd) relative date format (ie: FQ12006).
For Historical end of day only
DtFmt 41
Filler value. If Days is set to display Non- trading days, then this is the data to return for that day. The default is C. The valid entries are: • • • • •
C - Carries over the last available data. P - Carries over the previous day's data. E - Returns an error message. B - Returns a blank. Custom option. Example: Fill= 0 will return 0 for each non trading day
Fill Direction/Orientation for how you want the fields to appear in your spreadsheet. Valid entries are: • •
H - Horizontal V - Vertical.
Orientation Periodicity. The periodicity sets the interval within a fixed period of time when data is returned: The base periods are D (Daily), W (weekly), M (monthly), Q (quarterly), S (semi), Y (Yearly) . The Calendar, Fiscal, or Actual modifiers provide greater flexibility when used with the base period. The modifier should precede the base period. Valid modifiers are CD (Calendar Day), CW (Calendar Week), CM (Calendar Month), CQ (Calendar Quarter, CS (Calendar Semi), CY (Calendar Year), FQ (Fiscal Quarter), FS (Fiscal Semi), FY (Fiscal Year), AD (Annual Day), AW (Annual Week), AM (Annual Month), AQ (Annual Quarter), AS (Annual Semi), AY (Annual Year). F should only be used with Q, S, and Y. Per
This is NOT available for Intraday The number of periods to download from the end date. This is set in periodicity (per) according to Days, Weeks, Months, Quarters, or Years.
Points 42
Price/Yield Quote. This defines historical Price or yield for a yield quoted debt instrument. The valid entries are: • •
P - Price Y - Yield.
QtTyp Quote Calculation This defines Historical average price or closing prices. The valid entries are: • • •
G - Golden Mean A - Average C - Close.
Quote Bar Size Indicates the interval for data retrieval. Any number between 1 and 1440. Default is 1 minute. BarSz
For Intraday historical ONLY
Bar Type B, Bid, A, Ask, L, Last Only for Intraday BarTp Order to sort your time or dates. The valid entries are:
Sort
• • • •
C- Chronological A - Ascend R – Reverse D - Descend.
43
Appendix B: ERRORS The errors created by the new add-in consolidate some of the errors from the previous software to make them more intuitive.
Error Code Descriptions The following list defined the new error codes and maps then to the old error codes. There might be certain situations with the new formulas where there was no corresponding error code with the old formulas. In that case, please follow these overriding principles: 1. #N/A Authorization – A permissioning issue exists 2. #N/A Invalid Field – A inapplicable field has been entered in a formula 3. #N/A Invalid Parameter – An invalid override was entered in a formula 4. #N/A Connection – The users has lost the connection to the back-end. 5. #N/A Time Out – The users request has timed out 6. #N/A Limit – A limit of some sort has been reached 7. #N/A N/A – A catch-all error code 8. #N/A Invalid Security – The security is not recognized 9. #N/A Real Time – An error occurred with a real-time request
Error Codes Description
Old Error Codes
New Error Codes
#N/A
#N/A Requesting Data…
#N/A Auth
#N/A Authorization
#N/A Auth -2001
#N/A Authorization
#N/A BulkFld #N/A Ccy
#N/A Invalid Field #N/A Invalid Parameter
#N/A Com
#N/A Connection
#N/A Data Ctrl
Not supported
Communication Error. Displayed either when there is a communication error or while waiting for the formula result to be returned. The user is not permissioned to receive data via the API Indicates the user is disabled because they have a Limited Functionality terminal or login that is not allowed to receive API data. Indicates that the BDS function is attempting to use a field that does not conform to the Bloomberg Bulk format. Indicates that the currency specified does not exist The connection between the BBCOMM (which handles the actual transfer of data from our database to your PC) and the DDE (which passes requests from Excel to the BBCOMM) has been severed The operating system has failed to register the file blpdatax.dll - a file which is critical for the data retrieval in DDE version 2.2 or higher. This commonly occurs with a Windows 95 operatings system - or any system which has neither Microsoft IE5 or higher or Microsoft Office2000
44
#N/A Dberr
Not supported
#N/A DbTimeout
#N/A Time Out
#N/A Derived Limit
#N/A Limit
#N/A Disable
#N/A Limit
#N/A Dly Lmt
#N/A Limit
#N/A End #N/A Fld
#N/A End Date #N/A Invalid Field
#N/A Full
#N/A Limit
#N/A Hist Fld
#N/A Invalid Field
#N/A History
#N/A N/A
#N/A InvalidRepl
#N/A N/A
#N/A Limit
#N/A Limit
#N/A MD Limit
#N/A Limit
#N/A Mth Lmt
#N/A Limit
installed. THIS ERROR IS NO LONGER SUPPORTED. The security for which data has been requested is not recognized. This will be caused by one of two reasons - either the security has been spelled incorrectly or the yellow market sector key which should append the ticker has been omitted. THIS ERROR IS NO LONGER SUPPORTED. Indicates the user's request has timed out during processing. This is typically due to the intensive nature of the necessary calculations. Another reason could the number of fields within one request. This error indicates you have gone over the concurrent subscription limit of 500 securities for the derived real time fields for options. Indicates the user has exceeded the limitation of data download per user. This limit only applies to static data, not real-time streaming data. The request of data will be displayed until the limit is reached and then the error message #N/A Limit will be displayed with each subsequent request for both static and real-time data requests. Indicates the user has exceeded the limitation of data download per day per user. This limit only applies to static data, not real-time streaming data. The request of data will be displayed until the limit is reached and then the error message #N/A Limit will be displayed with each subsequent request for both static and real-time data requests. Exclusive to BDH function where the end date parameter is not valid or is set before the start date. The field mnemonic you have used is invalid. Indicates that the function has failed to insert the necessary number of columns due to the final sheet column being occupied. The field for which you have requested historical data is not a history field. Occurs primarily with BDH function There is no Historical data available for the Date(s) specified. Occurs primarily with BDH functions Indicates that an unspecified error has been identified. #N/A Limit indicates the user has exceeded the security limitation of concurrent real-time security subscriptions. This limit only applies to real-time streaming data. When the user reaches the limit the error message will be displayed with each subsequent request. Exclusive to the Market Depth fields in API, when you go over the 500 security monitoring limit, this is the error message received. Indicates the user has exceeded the limitation of data download per month per user. This limit only applies to static data, not real-time streaming data. The requested data will be displayed until
45
#N/A N Ap
#N/A Invalid Field
#N/A N.A.
#N/A N/A
#N/A N/A
#N/A N/A
#N/A NA
#N/A N/A
#N/A Neg
#N/A Invalid Field
#N/A Nested
Not supported
#N/A NtrdVal
Not supported
#N/A No Ovrd VWAP #N/A OvrdVal
Not supported #N/A Invalid Parameter
#N/A Period
#N/A Invalid Parameter
#N/A Perm #N/A RevOrd
#N/A Authorization #N/A Invalid Parameter
#N/A Rl Tim
#N/A Real Time
#N/A Sec
#N/A Invalid Security
#N/A Sec Tp #N/A ShDates
#N/A Invalid Security #N/A Invalid
the limit is reached and then the error message #N/A Limit will be displayed with each subsequent request for both static and real-time data requests. The field is not applicable for the security. An example would be trying to retrieve the yield on a stock, or the dividend per share on a bond. Data for the specified derived field is not available. This error may also be caused where values stipulated for an overridable field are significantly different from what may be regarded as the 'normal range' of acceptable values. For example assigning the value of 1000 to a yield The data for the specified history, intraday or real time field is not available. An example of this is the New York Stock Exchange does not allow a delayed user to download any Bid & Ask data for NYSE listed securities. Error occurs exclusively with the BDH function when the user has requested the inclusion of Nontrading days, and specifically requested the 'filler' for the non-trading days to be #N/A N/A. The specified field is a numeric field that cannot be negative but the calculated value is negative. May occur when an excel generated date, e.g. =today(), is used within a BDH. THIS ERROR IS NO LONGER SUPPORTED. Exclusive to the BDH function where the value passed to the optional 'Filler' parameter is invalid. THIS ERROR IS NO LONGER SUPPORTED. This message indicates that Real Time VWAP fields do not support overrides. THIS ERROR IS NO LONGER SUPPORTED. Invalid override value has been entered for user input within a calculation override BDP statement. Exclusive to the BDH function where the value passed to the optional 'period' parameter is invalid. User is not permissioned to view the specific field requested, given the security and price provider the user has selected. This error will be returned where the fields requested require third party subscriptions, e.g. IBES fields. Exclusive to the BDH function where the value passed to the optional 'Sort' parameter is invalid. The security for which real time data is being requested is not being priced in real time. Typically occurs for bonds where the existing price provider is not pricing on an intraday basis. The security for which data has been requested is not recognized by Bloomberg. This will be caused by one of two reasons - either the security has been spelled incorrectly or the yellow market sector key which should append the ticker has been omitted. The specified security type is not among the valid security types (not ticker exchange nor SEDOL nor CUSIP). Exclusive to the BDH Function. This error
46
Parameter
#N/A ShYieldFlg
#N/A Invalid Parameter #N/A Invalid Parameter
#N/A Size
Not supported
#N/A Sls Auth
Not supported
#N/A Start
#N/A Start Date
#N/A Tim
#N/A Time Out
#N/A Trd
#N/A Real Time
#N/A Unknown
#N/A N/A
#N/A Shntrd
message occurs when the value passed to the ‘Dts’ parameter is invalid. Exclusive to the BDH function. The value passed to the ‘Days' parameter is invalid. Indicates that the BDH function recognized that the ‘QtTyp’ flag parameter is not correct. Data requested forms part of a DDE request where the number of data points due to be returned exceeds Excel's array limitation of 1600 cells. Occurs when requesting a large number of historic data points using a DDE history request. THIS ERROR IS NO LONGER SUPPORTED. This error indicates you have been manually disabled by the Bloomberg Risk Team. This can also result in a "Time Zone Adjustment: not authorized" error message on the DDE Server. THIS ERROR IS NO LONGER SUPPORTED. Exclusive to the BDH function where the value passed to the compulsory parameter 'Start Date' is invalid, usually because it is not a valid date format or because it is a date set in the future. The request for the field has timed out. After a given period of time (usually 90 seconds) if there is no response from our database, this error will be displayed. It is symptomatic of an underlying communication error (usually caused by the bbcomm failing to make a connection). The security for which real time data was requested has not traded in more than thirty days. Occurs particularly where selected price providers are not actively pricing the security. An error for which there is no other programmed error handler.
47