Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Version IV
Page 1 of 73
Bloomberg Document...
50 downloads
1298 Views
2MB Size
Report
This content was uploaded by our users and we assume good faith they have the permission to share this book. If you own the copyright to this book and it is wrongfully on our website, we offer a simple DMCA procedure to remove your content from our site. Start by pressing the button below!
Report copyright / DMCA form
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Version IV
Page 1 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
TABLE OF CONTENTS Data Download .................................................................................................................. 1 I. API Brief Introduction............................................................................................. 4 What is API........................................................................................................................ 4 Limitations of the Bloomberg API................................................................................... 4 How to install the API....................................................................................................... 6 Suggestions for Download Data Request Reponses: ...................................................... 7 Relationship to other QCF Documentations: ................................................................. 7 II. Excel Add-in Tools ................................................................................................... 9 1. Table Wizard ................................................................................................... 10 2. Bulk Wizard . .................................................................................................. 14 3. Intra-day History Wizard ................................................................................ 15 3. Intra-day History Wizard ................................................................................ 16 4. History Wizard ................................................................................................ 18 5. Fill Range ........................................................................................................ 22 6. Field Search..................................................................................................... 24 III. Bloomberg Worksheet Functions in Excel........................................................... 27 1. BLP Function .................................................................................................. 27 Note III.1.1: ............................................................................................................... 28 Note III.1.2: ............................................................................................................... 29 2. BLPH Function ............................................................................................... 31 Note III.2.1: ............................................................................................................... 33 Tips III.2.1:................................................................................................................ 34 3. BLPSH Function ............................................................................................. 35 Tips III.3.1:................................................................................................................ 36 4. BLPI Function ................................................................................................. 37 5. BLPB Function................................................................................................ 41 6. General Tips .................................................................................................... 43 IV. Practical Examples................................................................................................. 45 1. Download Data for Corporate Bonds....................................................................... 45 Find Corporate Securities Ticker: ............................................................................. 45 Download Data in Excel File: ................................................................................... 48 2. Download Data for Required Index ......................................................................... 49 Find Index Securities Ticker: .................................................................................... 50 Download Data in Excel File: ................................................................................... 52 3. How to save the Bloomberg Download Data without formulas .............................. 54 V. API Error Library ................................................................................................. 59 Introduction ............................................................................................................... 59 1. #N/A ................................................................................................................ 60 2. #N/A Auth ....................................................................................................... 60 3. #N/A Auth -3001............................................................................................. 60 4. #N/A Auth -4001............................................................................................. 60 5. #N/A Com ....................................................................................................... 61 6. #N/A Data CTRL .......................................................................................... 61 7. #N/A End ........................................................................................................ 61
Page 2 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
8. #N/A FLD ....................................................................................................... 61 9. #N/A Hist Fld .................................................................................................. 62 10. #N/A History ................................................................................................... 62 11. #N/A N Ap ...................................................................................................... 62 12. #N/A N.A. ....................................................................................................... 62 13. #N/A N/A ........................................................................................................ 63 14. #N/A NA ......................................................................................................... 63 15. #N/A NtrdVal.................................................................................................. 63 16. #N/A Nested.................................................................................................... 63 17. #N/A Period .................................................................................................... 64 18. #N/A Perm ...................................................................................................... 64 19. #N/A RevOrd .................................................................................................. 64 20. #N/A Rl Tim ................................................................................................... 64 21. #N/A Sec ......................................................................................................... 65 22. #N/A Shntrd .................................................................................................... 65 23. #N/A Size ........................................................................................................ 65 24. #N/A Start ....................................................................................................... 66 25. #N/A Tim ........................................................................................................ 66 26. #N/A Trd ......................................................................................................... 66 27. #N/A Unknown ............................................................................................... 66 28. #N/A Sec Tp.................................................................................................... 67 29. #N/A Neg ........................................................................................................ 67 30. #N/A OvrdVal ................................................................................................. 67 31. #N/A Full ........................................................................................................ 67 32. #N/A ShYieldFlg............................................................................................. 67 33. #N/A BulkFld.................................................................................................. 67 34. #N/A Ccy ........................................................................................................ 68 35. #N/A Dberr...................................................................................................... 68 36. #N/A InvalidRepl ............................................................................................ 68 37. #N/A ShDates.................................................................................................. 68 38. #N/A MD Limit............................................................................................... 68 39. #NAME? ......................................................................................................... 69 40. #REF! .............................................................................................................. 69 41. #VALUE! ........................................................................................................ 69 Examples: .................................................................................................................. 70 VI. Appendix ................................................................................................................. 71
This guide is intended to provide a brief introduction to the Bloomberg data download methods, including the API as well as direct download from Bloomberg window methods.
Page 3 of 73
Bloomberg Documentation By Rasheed Abad
I.
Master of Finance
Data Download
API Brief Introduction
What is API Bloomberg Application Program Interface (API) offers clients the ability to bring Bloomberg data and analytics into their Excel spreadsheets or proprietary applications. Bloomberg s API allows you to: - Access over 7000 fields of data from the vast Bloomberg database - Create custom applications with Microsoft Excel or your own proprietary models. - Run over 20 Bloomberg Analytical Calculations within your custom application thereby getting the values you would expect to see from common Bloomberg functions such as Yield Analysis (YA), Option Adjusted Spread (OAS1) and historical fundamentals (FA) for a portfolio of securities. API contents: - Excel Add-in Tools Table Wizard, History Wizard, Intra-day Wizard and Bulk Wizard. - Excel Formula writing command statements that include BLP, BLPH, BLPSH, BLPI, and BLPB - Calculation Overrides or Bloomberg Analytical Calculation formulas Note: 1) Bloomberg data download wizards: These provide step by step assistance for retrieving over 9000 types of data including real time, historic and analytical fields. 2) Bloomberg Excel Worksheet Functions: You can write simple functions to retrieve and manipulate data. This method is highly flexible and efficient. This draft would explain in details on how to illustrate API contents such that you can achieve the API functions. In chap II you will learn how to download data by using five excel build-in wizards (Table Wizard, Bulk Wizard, Intra-day History Wizard, History Wizard) and two special excel build-in tools (Fill Range, Field Search). Chap III provides the structure and detailed information on all parameters in each Bloomberg downloading function. Chap IV describes how to get the ability to perform Bloomberg s financial calculations in a customizable sheet. Chap V shows the cause and solution actions for all error messages. Limitations of the Bloomberg API Many of the Bloomberg API limitations are due to certain limitations imposed by the environment in which the API is being used. Such instances are noted in each of the following categories.
Page 4 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
DDE Limitations -- Depending upon the version of Microsoft Windows you are running, you will encounter the following DDE limitations when using Microsoft DDE Links: - Windows NT: There is a maximum limitation of approximately 14,000 open DDE Links at any given time. If this limitation is exceeded, the DDE sub-system breaks and requires the user to reboot his/her machine. This is a known bug in the DDE implementation by Microsoft. - Windows 2000: There is a maximum limitation of approximately 10,000 open DDE Links at any given time. If this limitation is exceeded, the DDE sub-system breaks and requires the user to reboot his/her machine. This is a known bug in the DDE implementation by Microsoft and is reported on Microsoft's MSDN website (http://msdn.microsoft.com) in Article #326591: "Maximum NT User Hanldes Per Process Is 10,000 in Windows 2000" (Knowledge Base). For information on how to fix this bug, search the MSDN site's Knowledge Base using the article number as the keyword. - Windows 9x: The Windows 9x (95/98/ME) Operating Systems possess a limit to the overall length of all combined DDE links to 48K. The link will break if this value is surpassed. If the limit is surpassed, all future links will not display data and you may encounter a "Low on Memory" error message. In order to help you remain below the 48K limitation, a minimized DDE Window displays the updated length of all combined DDE links. If you happen to surpass this limit you can recover by removing all DDE links above the limit without the need to reboot your PC. DDE Limitations -- Each DDE Link cannot be greater than 256 characters. This is a Microsoft limitation and can be calculated by adding up all characters and spaces in your link. Historical BLP DDE Link (BLP|H! Link) Limitations -- Since we are using Microsoft DDE Links, we have to rely on formats supported by the DDE system and supported by Microsoft Excel. For various reasons, the most suitable data format to be utilized with Excel DDE links is XL Table. However, due to a 32K limitation of the XL Table, the Historical BLP link is also affected by the same limitation. -
BLP() and BLPSH() Functions: This limitation is dependent upon which version of Microsoft Excel you are using. If you are using any supported version of Excel earlier than Excel 2002, then the BLP() function uses DDE links and possesses a limit equal to those described in the DDE Limitations topic earlier on this page. However, if you are using the BLP() function in Microsoft Excel 2002, or greater, then there is no limitation to the size of your request, other than the limitation of Microsoft Excel (see below), as well as your CPU speed,
Page 5 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
bandwidth and memory. RTD is a new Microsoft technology introduced in Microsoft Office XP.
Microsoft Excel -- There is a limitation of 65,536 (64K) rows and 256 columns for a Microsoft Excel worksheet. This applies to Microsoft Excel 97, 2000 and 2002. For versions before Excel 97, the maximum number of rows is 16,384 (16K) and 256 columns.
Note:
All Bloomberg API functions can be run on Microsoft Excel at the Bloomberg machine in the Skiles Building room 133. How to install the API Step one: Log in the Bloomberg Machine in Skiles Room 133 using your math/QCF user name and password. Step two: Go to START EXCELL BUILD-IN
ALL PROGRAMS
BLOOMBERG
INSTALL
You will get the following message window Page 6 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Step three: In the pop up Installing Bloomberg Excel Add-In window, press INSTALL Now you are ready to download data from Bloomberg into excel spreadsheets. Suggestions for Download Data Request Reponses: For different type of data download request, you can use different methods. If you need to download some information on a particular date and only once, I will recommend using the Wizard to download those data. Because it will easy for you to follow the simple steps and get the result data. Especially for historical data download, since the Excel function for this type data download is really complicated. If you want to have a Excel sheet which can be used again and also can be distributed to other users. I will recommend using the Excel function, because in the following study you will explore the flexibility to customize your data set. Also you can make a fancy Excel template. For different financial market, you can refer to the IV Practical Examples to get more ideas. In the practical experience, please learn to use the Field Search Wizard and Fill Range Wizard will help you to get the request data in fast way. Relationship to other QCF Documentations: Please refer to the http://www.qcf.gatech.edu/academic/Bloomberg/bloomberg.html for other good Bloomberg Documents. If you are new to the Bloomberg System, please see the Quick Start Guide-PartI and PartII first. And if you have any particular financial market request, there are some documents about Equities and Fixed Income Guide. You also will see a Quick Start document for Data download, which is a good document to give you a brief idea about the data download methods. But in the full version data download documents, you will get more detail in every related method and also you will
Page 7 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
get error table with possible solving actions. Also more practical examples will be shown in the document.
Page 8 of 73
Bloomberg Documentation By Rasheed Abad
II.
Master of Finance
Data Download
Excel Add-in Tools
The simplest way to download data is using the Excel Add-in Tools. The first operation procedure is to open a Microsoft Excel in a Bloomberg machine, Then, in Toolbar you can find the following five wizards:
or in the Bloomberg drop down menu,
1.
Table Wizard
to download current prices and descriptive information.
2.
Bulk Wizard to download blocks of data such as company description, the members of an index, the cash flows for a bond or the dividend history for a stock.
3.
Intra-Day History Wizard to download intra-day intervals for a security or a list of securities.
4.
History Wizard to download historical prices and fundamentals for a security or securities of your choice such as Volume or Net Income over time.
5.
Weather Wizard to download real time weather information for various geographic locations such as High/Low/Mean temperatures.
The other tools are Fill Range , Field Search and Enable Real time updates , which are mostly useful in the Bloomberg Worksheet Functions Data Download section.
Tip II: If you have any questions about the Bloomberg Excel Add-in Tools, go to the Bloomberg drop down menu and choose the Bloomberg Add-in Help,
Page 9 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
1. Table Wizard to download current prices and descriptive information. Step One Open Table Wizard Open a new or existing work book in Microsoft Excel, click on or choose the Table Wizard under the Bloomberg submenu. The introduction page can be skipped in future sessions by selecting the option (Please do not show this page again). Then press Next>.
Tip II.1.1: Press green button Help to go to the Bloomberg Add-in Help dialog for more information.
Step Two
Select Securities Enter a valid ticker or ticker/exchange combination flowed by the relevant yellow market sector key (either click on the appropriate yellow key in the wizard or use your keyboard to select the appropriate yellow key) under Ticker. You can also use identifiers such as CUSIPS or ISINs to choose from the Ticker Type drop down menu followed by the relevant sector key if the identifier parameter is specified. Press Add. Repeat for additional
securities, then press Next>.
Tip II.1.2: If you do not know the ticker information you can click the to find out the right ticker for your request securities. Enter the search key word of the security under Name then choose the relevant yellow market sector key (either click on the appropriate yellow key in the wizard or use your keyboard to select the appropriate yellow key). Press GO. Double click the selected security or press Done to add it to the ticker list. press Next>.
Page 10 of 73
Bloomberg Documentation By Rasheed Abad
Step Three
Master of Finance
Data Download
Select Fields Choose a folder and double click to reveal the contents. Select the field(s) of choice and press Next>. To view the description of a field, right click on it and select the Extended Description.
Tip II.1.3: In order to find a particular field, just click on the for a keyword search dialog. Back to the original complete fields list, just click on Reset then click OK.
Step Four
Layout Options In the Orientation box, you can indicate if you would like your data to be displayed horizontally or vertically. In the Chart Options box, you can check Display chart then press Next> to create a chart in the following pop up Table wizard dialog. Otherwise, press Finish and the data will populate your spreadsheet. In the Spreadsheet Link Type box, please select one suitable for you by referring to the Note
II.1.1.
Page 11 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Note II.1.1: Add and Speed of Data changes by remove update? changing the columns? field? Single-cell Yes Slower BLP Yes Multi-cell No Faster DDE No It indicates a trade-off between speed and flexibility. Summarizing these features Single-cell BLP Slowest, most flexible DDE Flexible column changes only
Step Five (Option)
Speed of update? Slower Faster
Multi-cell Flexible field changes only Fastest, least flexible (fill region uses this one)
Chart Setup In the Chart Setup dialog, you can give the chart a title in the Chart Title box. In the Option box, you can choose the location and type of the chart. Also you can select and deselect the Securities and Fields appear on the chart in the Information For Charting box. Press Finish.
Example: Step Two: Securities:(Enter IBM under Ticker Add; Enter YHOO under Ticker Add)
Click on yellow key EQUITY Click on yellow key EQUITY
Click on Click on
Step Three: Fields: (in the Price folder, select Ask Price (PX_ASK), Bid Price (PX_BID) and Last Price (PX_LAST))
Step Four: Check Display chart Options.
Step Five: Chart Title: IBM & YHOO PRICE
Page 12 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Note II.1.2: you will see a select Overrides dialog after the Select Fields dialog, just press Next> to the Layout Option dialog. I will give detail information about Overrides in the Calculation Overrides section in this document.
Result: You will get the following table in Sheet1 and IBM & YHOO PRICE figure in Chart1.
Page 13 of 73
Bloomberg Documentation By Rasheed Abad
2.
Master of Finance
Data Download
Bulk Wizard
to download blocks of data such as company description, the members of an index, the cash flows for a bond or the dividend history for a stock.
Step One
Open Table Wizard
Open a new or existing work book in Microsoft Excel, click on or choose the Bulk Wizard under the Bloomberg submenu. The introduction page can be skipped in future sessions by selecting the option (Please do not show this page again). Then press Next>.
Step Two
Select Securities
Same as Step Two in the Table Wizard section
Step Three
Select Fields
Same as Step Three in the Table Wizard section
Step Four
Layout Options If you select the use Excel BLPB function as link type, you will have option to aggregate the bulk information in a single cell. Press Finish. If you select more than one security in the Select Securities dialog, you also have options to choose how to display the bulk information in the worksheet. Please see the Multisheet box.
Example: Step Two: Securities:(Enter IBM under Ticker Add; Enter YHOO under Ticker Add)
Click on yellow key EQUITY Click on yellow key EQUITY
Click on Click on
Step Three: Fields: (in the Descriptive Info folder, select Company Address (Company Address) and Company Description (Cie Des Bulk))
Step Four: Spreadsheet Link Type: select Use Excel BLPB function; Decorations: check Aggregate in a single cell; Multi-sheet: check all the items.
Page 14 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Result: You will get the following Table 1 in IBM Equity sheet and Table 2 in YHOO Equity sheet.
Page 15 of 73
Bloomberg Documentation By Rasheed Abad
3.
Intra-day History Wizard
Master of Finance
Data Download
to download intra-day intervals for a
security or a list of securities.
Step One
Open Intra-day History Wizard
Open a new or existing work book in Microsoft Excel, click on or choose the Intra-Day History Wizard under the Bloomberg submenu. The introduction page can be skipped in future sessions by selecting the option (Please do not show this page again). Then press Next>.
Step Two
Select Securities
Enter a valid ticker or ticker/exchange combination flowed by the relevant yellow market sector key (either click on the appropriate yellow key in the wizard or use your keyboard to select the appropriate yellow key) under Ticker. You can also use identifiers such as CUSIPS or ISINs choosing from the Ticker Type drop down menu followed by the relevant sector key if the identifier parameter is specified. Press Add. Repeat for additional securities, then press Next>.
Step Three
Select Fields Choose the fields you want to show on the table with the combination of the primary fields and aspect fields. Press Next>.
Step Four
Time Options In the time option dialog, you can set the Bar Size in minutes, Start Time, End Time. Also you can choose the order in which the returned data points are presented in the spreadsheet. Press Finish. Filler selection is to format the type of data returned for times where no trades have been executed.
Page 16 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Note II.3.1: intraday history is available for up to 50 business days. Any prior requests will be met with the #N/A History Error. (For the error information, see the Error Library in this document)
Example: Step Two: Securities:(Enter IBM under Ticker Add; Enter YHOO under Ticker Add)
Click on yellow key EQUITY Click on yellow key EQUITY
Click on Click on
Step Three: Fields: (in the Choose Primary Fields, select Trade and Bid. In the Choose Aspect Fields, select Volume, Close and Number of Ticks.
Step Four: Bar Size: 5 minutes; Start Time 07/13/2005 00:00; End Time 07/14/2005 00:00; Time ordering: Reverse chronological; Select all the Options; Filler: Only active days;
Result: You will get the following table in Sheet1
Page 17 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
4.
History Wizard to download historical prices and fundamentals for a security or securities of your choice such as Volume or Net Income over time. Step One
Open History Wizard
Open a new or existing work book in Microsoft Excel, click on or choose the History Wizard under the Bloomberg submenu. The introduction page can be skipped in future sessions by selecting the option (Please do not show this page again). Then press Next>.
Step Two
Select Securities
Same as Step Two in the Table Wizard section
Step Three
Select Fields
Same as Step Three in the Table Wizard section
Step Four
Select Time Parameters Choose specific start/end date, time periods, or a combination of both. For relative dates (calendar, fiscal, or actual) select Custom Time Settings (Equities) (CUSTOM). This option is only available for Equity .
Note II.4.1: current refers to the date you open the spreadsheet. So using the options labeled as current will continue to update the historical values as time goes forward. (e.g. Fixed timeperiod from current)
Step Five (option)
Select Custom Time Settings (Equities Only) After selecting Custom Time Settings (Equities) (CUSTOM), you will be able to specify a Date Type for both start and end date (either Fixed or Relative). Fixed date type will allow you choose a Specific Date or a specific financial /calendar period such as FQ22005, CQ32005.
Page 18 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Relative date type allows you to move backward or forward a certain number of periods from the As Of selection. For example, in the End date, choose a Date Type of Relative, set the As Of selection to Custom then check Fiscal, set Calendar, Semi-Annual, 2, 2004. Under Move, select Back, 10, Actual, Months. This allows you to go back 10 actual months from the financial period at 2004 calendar semi-annual second period.
Step Six
Select General Parameters Choose a Periodicity for your download. When a custom time parameter has been select in step four, you can adjust the periodicity on a calendar, fiscal, or actual basis. You can also select chronological or reverse chronological order, a Currency (see appendix for whole list) for the data to be converted to and whether or not to display the non-trading weekdays and
weekends. Press Next>.
Step Seven
Layout Options You can indicate if you would like your data to be displayed horizontally or vertically. By selecting the Display chart option, a new dialog will be available which will allows you to create a chart. If you select the use Excel BLPB function as link type, you will have option to aggregate the bulk information in a single cell.
If you select more than one security in the Select Securities dialog, you also have options to choose how to display the bulk information in the worksheet. Please see the Multi-sheet box. If you have checked Display Chart, press Next>. Otherwise. Press Finish> and data will populate your spreadsheet.
Page 19 of 73
Bloomberg Documentation By Rasheed Abad
Step Eight (Option)
Master of Finance
Data Download
Chart Setup In the Chart Setup dialog, you can give the chart a title in the Chart Title box. In the Option box, you can choose the location and type of the chart. Also you can select and deselect the Securities and Fields appear on the chart in the Information For Charting box. Press Finish.
Example: Step Two: Securities:(Enter IBM under Ticker Add; Enter YHOO under Ticker Add)
Click on yellow key EQUITY Click on yellow key EQUITY
Click on Click on
Step Three: Fields: (in the Price folder, select Last Price and Volume).
Step Four: Select Custom Time Settings(Equities).
Step Five: Start date: Date Types: check Fixed; select Fisc/Calendar: Fiscal, Quarter, 2, of 2003; (FQ22005) End Date: Date Types: check Relative; As Of: Check Custom and Fiscal, Fiscal, Semi-Annual, 1, 2005; Move: Back, 5, Actual, Months; (FS1220055AM)
Step Six: Periodicity: Acutal, Daily; Currency: Default; Time ordering: Chronological; Quote: Yield; Quote Calculation: Closing quote; Non-trading days and weekends: Include non-trading weekday: Display #N/A N/A.
Step Seven: Multi-sheet: check both options; Orientation: check Fields along the row; check the Display chart;
Step Eight: Chart Title: Example for History Wizard; Location: New Chart Sheet; check both securities; only check Volume in the Fields box.
Result: You will get the following table in Sheet1
Page 20 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Page 21 of 73
Bloomberg Documentation By Rasheed Abad
5.
Master of Finance
Data Download
Fill Range
The Fill Range command can automatically create an updating table of prices from column and row headers. It can create various kinds of supported link types without requiring the user to explicitly type them into cells. There are two ways to call up the Fill Range tool: Select Fill Range|Go option from the Bloomberg submenu on the Excel s main menu. Click on the Fill Range button on the Bloomberg Tool Bar.
Step One
Enter Securities Enter a list of securities in Excel. Be sure to add the yellow market sector key.
Step Two
Enter Fields Enter the desired fields to return the desired data, you can using the Field Search Tool. (See the Field Search Tool section)
Step Three
Click the Home cell and call up Fill Range Click the Home Cell above the first Bloomberg recognized security and to the left of the first Bloomberg recognized data field (A1). Call up Fill Range by the above 2 ways.
Step Four
Choose the data link type Select the data link type, and then press OK. For data link type information please see the Note in the Table Wizard Step Four Layout Option.
Page 22 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Example: Step One: Enter SPX INDEX, IBM EQUITY, CBM Govt, 373406BW6 Muni, ED799190 Corp in the Cell A2:A6.
Step Two: Enter Name, PX_LAST in the Cell B1:C1
Step Four: Select Single cell DDE links Result: you will get the following table in Excel
Page 23 of 73
Bloomberg Documentation By Rasheed Abad
6.
Master of Finance
Data Download
Field Search
The Field Search tool is the best way to find fields which can help you to find the name of the Bloomberg field for the particular information about some security you are looking for. You can choose one or more keywords to describe the information you are looking for and use the Field Search tool. It will search the Bloomberg Data dictionary for you and show you all the fields that have one or more of these key words in their mnemonics or names. Note II.6.1: Mnemonic is a shortened nick name of a Bloomberg field that is used as its identifier on the spreadsheets. For example, Bid Price Value Of A Basis Point field has BID_PX_VAL_BP mnemonic. There are two ways to call up the Fill Range tool: Select Field Search option from the Bloomberg submenu on the Excel s main menu. Click on the Field Search
button on the Bloomberg Tool Bar.
Note II.6.2: You also can search the Bloomberg name of the information you are looking for in every wizard, just click on Fields Search button positioned just above the Available Fields List on Fields Search page of every wizard (See Tip II.1.2)
Step One
Select the Field Search Tool Click on the Field Search button or Select the Field Search from the Bloomberg submenu.
Page 24 of 73
Bloomberg Documentation By Rasheed Abad
Step Two
Master of Finance
Data Download
Select Market Sector(s)
Click on the Yellow sector button to choose the single or combination of sector(s). You can choose All market to select all market sectors. Note: Red Button Label Indicates Selected.
Step Three Keywords
Enter
Enter the desired keywords into the Show fields that contain box. If the selected option to the right of Show fields that contain is All then only the fields that contain all of the search words are displayed in the Found Fields List. If the option Any is used then all of the fields that contain at least one of the search words are displayed in the Found Fields List.
Step Four
Select Fields Catalog Check Monitoring fields and Static fields to see all of the fields available in the Table wizard. Check Historical fields to see all of the fields available in the History Wizard Bulk Formatted Fields Only box will all you to see only the fields that are available in the Bulk Wizard. Then press Search.
Step Five
Select fields and Choose Position
Select the desired fields by simply click on them in the Found Fields List or click the Select All button to choose all found fields. A checkmark will appear next to the selected fields. You can click on the selected fields again in order to deselect them. You also can select the fields display position in the Position mnemonics option box. Then click Apply to place the data field on the spread sheet.
Page 25 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Tips II.6.1: You can look the detail information about the found field by pointing on the desired field and clicking the mouse RIGHT button. Example: Point to the Volume and click the mouse right button. A small box of the Extended Description of Volume will pop up.
There is a legend figure in front of each field; you can click the Legend button on the top right corner in the Fields Search Tool window to know the detail information of different legend figure.
Page 26 of 73
Bloomberg Documentation By Rasheed Abad
III.
Master of Finance
Data Download
Bloomberg Worksheet Functions in Excel
Bloomberg s Worksheet functions work consistently as Excel s own worksheet functions (SUM, AVERAGE). It is a flexible and efficient way to retrieve data dynamically in Excel. This section describes in details about functions provided by Bloomberg. Bloomberg offers five worksheet functions defined as follows: BLP BLPH BLPSH BLPI BLPB
1.
Current data on hundreds of fields (replicates Table Wizard) Historical data sets on a subset of fields (replicates History Wizard) Single history data point. Powerful complement to BLPH Historical Intraday data sets Bulk data (replicates Bulk Wizard)
BLP Function
= BLP (SECURITY, FIELD(S),OVERRIDES*,IDENTIFIER*) Note: * denotes option parameter; BLP is not case sensitive for any of the parameters. Purpose: To bring in current data for a range of fields, and used to perform Calculation overrides (See Calculation Overrides section for more detail) Note: BLP Function is the only function to get the real time data which will update on the screen without you doing anything). And the only subset of fields are real time and these are visible through the TABLE WIZARD fields folder named REAL TIME QUOTES ( refer to the CHAP II SECTION ONE STEP THREE). Tip: You can use the FIELDS SEARCH TOOL select the Monitoring fields and Static fields to get the mnemonics for Real Time Quotes fields (refer to the CHAP II SECTION SIX) Parameters: SECURITY
A valid ticker or ticker/exchange combination followed by relevant yellow market sector key (Please see the NOTE). You can also use identifiers such as CUSIPS or ISINs followed by the relevant sector key if the identifier parameter is specified. Tip: only one security allowed. Example: IBM US EQUITY, DBR 04 09 GOVT FIELDS One or more recognized field mnemonics representing the data you want to bring in. To find field mnemonics, you can use the field search wizard on the Bloomberg Excel Add-in Tools (See Field Search subsection under the Excel Add-in Tools section) Example: PX_ASK (Ask price), YLD_CNV_ASK (Ask yield according to convention) OVERRIDES There are values which user assigns to particular fields so that Bloomberg s (optional) financial calculations can be performed in Excel. The detail information will be described in a whole section called Calculation Overrides. You also can go to the BBXL menu for more information.
Page 27 of 73
Bloomberg Documentation By Rasheed Abad
IDENTIFIER (optional)
Master of Finance
Data Download
The security identification type if the security is not entered as ticker or ticker/exchange combination. You can also stipulate the identifier type from the security parameter. The whole list of available identifiers will be listed in appendix. Example: CUSIP, ISIN. Note: The identifier may be passed to the system via the security parameter. Eg. 459200101 Equity Cusip is same as IBM US Equity, but the first format means you do not have to give an identifier parameter to BLP for it to work. Note that the identifier comes after the yellow market sector key. ie. =BLP( 459200101 Equity Cusip , PX_ASK ) is same as =BLP( 459200101 Equity , PX_ASK , Cusip )
Note III.1.1: All parameters may be embedded in the function or referenced via cells. How to referencing Parameters via cells Referencing the parameters via cells provides you with a way of dynamically changing the data you see by changing the contents of the referenced cells. Example one: =BLP( IBM EQUITY , LAST PRICE ) VS =BLP(A1,A2) If A1 = IBM EQUITY and A2 = LAST PRICE then the above two phase will give the same value. But if you change A1 to YHOO EQUITY then =BLP(A1,A2) will give the last price for Yahoo equity not IBM Equity any more. Now it will be a good time to talk about one of the key points to bringing in data into excel is the ability to bring in data over multiple securities. One of the key time saving features of a spreadsheet is the ability to copy functions down (or across) and have the cell references adjust automatically depending on the direction in which you copy. This would allow you to copy a function over multiple securities with little difficulty. To copy a function, select the cell containing the function, move the mouse pointer over the bottom right hand corner of the border of this cell, press and hold down the left mouse button and drag the mouse down through all the cells you want to copy to. Suppose you have a list of securities in the A column starting at A1. in B1, you write the function: =blp(A1,"px last"). You can then copy this function from B1 down through to wherever the securities finish and you will bring in PX_LAST for all the securities in the A column - Excel automatically adjusts A1 cell reference to A2, A3, A4 etc as you copy down so you are referencing the correct security. Absolute Referencing: stopping the auto adjustment of cell references when copying formulas As we have seen, Excel automatically adjusts cell references when you copy a formula. In most cases this is fine, but suppose we want to keep referencing the
Page 28 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
SAME cell as we copy down the formula - for example if there is a field there, or a date for BLP or BLPSH. To do this we have to tell Excel to fix the reference to the cells containing the fields. Assuming we have a security in A3 and fields in B2 and C2, compare the following two formulas which we would type into B3 =blp(A3, B2:C2) =blp(A3, $B$2:$C$2)
Relative referencing of B2:C2 Absolute referencing of B2:C2
When we copy the SECOND formula down from row 3 to row 4 for example, the security is taken from A4, but the reference to the fields remain as B2:C2.. The first formula however will adjust down the reference to the fields B3:C3 which will result in an error. Note that instead of typing in the cell addresses into the above formula, you can actually click on them. (Once you have typed in the '=' before the blp, Excel recognizes you are giving it a formula). This said, after you have selected the range B2:C2, you can easily insert the $ signs by hitting the F4 key - a simple shortcut for absolute referencing. KEY NOTEs: 1. Referencing parameters via cells provides much greater flexibility 2. No double quotes were required when you enter the text into the cell A1 and A2. For more Tips about referencing parameters please refer to All the valid sector keys: Yellow market sector keys are ALWAYS required for the security Parameter. Unfortunately they do not exactly match the text on the yellow key buttons on the Bloomberg keyboard. For convenience they are included the Govt, Corp, Mtge, Muni, Pfd, Equity, Comdty, Index, Curncy, Client. Notice: the extra 'o' and 'u' in Comdty and Curncy as compared with the yellow key mnemonics on your keyboard Note III.1.2: New with the installation of Office XP, Microsoft installs a new technology called RTD*, which is currently being incorporated into the Bloomberg BLP() function for Microsoft Excel 2002 users. In the Skiles Rm 133, the Bloomberg machine has this function. So when the BLP function is entered into cells on an Excel worksheet, RTD will be automatically used instead of DDE. For example, if you type the BLP formula =BLP( ("IBM equity","last price") in a cell then the BLP function will now look something like this:
Page 29 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
=blp("IBM equity","last price",,,RTD("BLOOMBERG.RTD","","IBM Equity","LAST PRICE") You also can get the same result if you type in the =RTD("BLOOMBERG.RTD","","AA Equity", "LAST_PRICE"). *RTD (Real Time Data): Retrieves real-time data from a program that supports COM automation. The RTD COM Automation add-in must be created and registered on a local computer. No RTD servers are shipped with Microsoft Office XP, so if you haven't installed a real-time data server, you will get an error message in a cell if you try to use the RTD function. When the server has been programmed to continually update results, unlike other functions, RTD formulas will change when Microsoft Excel is in AUTOMATIC calculation mode. See {WAPI} for more information on RTD Technology
Examples of BLP: You can copy and paste the following in a particular cell Content Cell =blp( IBM US EQUITY , PX LAST ) A3 =blp( DBR 04 09 GOVT , PX ASK ) A5 =blp( DBR 04 09 GOVT , PX BID, PX ASK ) A7 =blp(A11,B10) B10 =blp(A15,$B$14:$C$14) B14
Result:
Page 30 of 73
Bloomberg Documentation By Rasheed Abad
2.
Master of Finance
Data Download
BLPH Function
= BLPH (SECURITY, FIELD(S), START DATE, END DATE*, POINTS*, REVERSE*, PERIOD*, NON-TRADING DAYS*, FILLER*, DATES*, ROWS, COLUMNS, DIRECTION*, SHOW PRICE*, CURRENCY*, GPA*) Note: * denotes option parameter; BLPH is not case sensitive for any of the parameters. Purpose: To retrieval of multiple historical data points on a range of fields (pricing and fundamentals) in a more flexible manner than the History Wizard. The API now allows for the retrieval of data using relative dates, as well as the calendarization of fundamental fields so comparison of companies with a typical fiscal periods are easily aligned on a calendar basis. Parameters: SECURITY A valid ticker or ticker/exchange combination followed by relevant yellow market sector key (Please see the NOTE). You can also use identifiers such as CUSIPS or ISINs which you would stipulate following the yellow market sector key. Example: IBM US EQUITY, DBR 04 09 GOVT, 459200101 US EQUITY CUSIP FIELDS One or more recognized field mnemonics representing the data you want to bring in. To find field mnemonics, you can use the field search wizard on the Bloomberg Excel Add-in Tools (See CHAP II SECTION SIX) Example: PX_ASK (Ask price), NET INCOME (net income). Note: if a field is not available historically, #N/A Hist is return. (See Error Library for more error information) Tip: Fields available for use with BLPH are the fields that appear in the History wizard. START DATE
A fixed or relative date to indicate the beginning of the historical download. Make sure the entered format matches the setting in Start Control Panel Regional Settings. Usually MM/DD/YYYY. Be sure the format of the cell is Date format (see below note for help the format setting). Please see using Relative Start & End Dates to request historical data in the below notes. Note: #N/A Start is returned where start date is not valid (e.g. a weekend) (See Error Library for more error information)
END DATE (optional)
POINTS (optional)
A fixed or relative date to indicate the end of the historical download Make sure the entered format matches the setting in Start Control Panel Regional Settings. Usually MM/DD/YYYY. Be sure the format of the cell is Date format (see below note for help the format setting). If omitted, data comes through to current date. Please see using Relative Start & End Dates to request historical data in the below notes. The maximum number of periods to download from the end date going back in time. See PERIOD to indicate Days, Weeks, Month, Quarters or Years
Page 31 of 73
Bloomberg Documentation By Rasheed Abad
REVERSE (optional)
Master of Finance
Data Download
A Boolean value where TRUE represents a reversal in chronological order (most recent first). Note: No double quotes required. Default setting is FALSE. #N/A RevOrd occurs, where you have entered TRUE or FALSE in double quotes
PERIOD (optional)
Sets the periodicity of the data. Based periods: D-daily, W-weekly, Mmonthly, Q-quarterly, S-semi-annually or Y-yearly as well as relative periodicity options(see the blow notes for more information). Notes: 1. Default setting is the most frequent available. 2. The periodicity you indicate will determine the frequency and calendar type (C-calendar, F-Fiscal(only with Q,S and Y), Aactual) of the output. Actual Periods (AD, AW, AM, AQ, AS, AY), These revert to the actual date form today (if the end date is left bank) or from the End Date. For example if the end date is 07/01/2005. Using AM as the PERIOD displays the 1st of each month. Calendar Periods(CD,CW,CM,CQ,CS,CY). For pricing fields, these revert to the last business day of the specified calendar period. For fundamental fields however, when requesting CQ(Calendar Quarter), CS(Calendar Semiannual) and CY(Calendar Year), fundamentals are adjusted as follows: o CQ1 The quarter reported between Feb 16 and May 15 o CQ2 The quarter reported between May 16 and Aug 15 o CQ3 The quarter reported between Aug 16 and Nov 15 o CQ4 The quarter reported between Nov 16 and Feb 15 of the following year o CS1 The semi-annual reported between April 16 and Oct 15 o CS2 The semi-annual reported between Oct 16 and April 15 of the following year o CY -- The annual figure report between July 16 and Jul 15 of the following year Fiscal Periods(FQ,FS,FY). These periods revert to the fiscal period end for the company
NONTRADING (optional) FILLER (optional)
Sets whether to include Non-trading days. N All weekdays(show Mon-Fri), C All calendar days(everyday). If omitted, it will show all trading days Formats the type of data returned for non-trading days, where you have selected to display non trading days. N display #N/A NA , C Carries over last available data(show the previous trading day s value) Default is Carry Over. Page 32 of 73
Bloomberg Documentation By Rasheed Abad
DATES (optional) ROWS
COLUMNS
DIRECTION (optional)
SHOW PRICE (optional) CURRENCY (optional) GPA (optional)
Master of Finance
Data Download
A Boolean value to set whether or not to return the dates alongside the data. FALSE represents no dates, TRUE show date (Default setting). Number of rows downloaded. Please skip this parameter (mark with comma if using additional parameter eg. DIRECTION, SHOW PRICE, CURRENCY, GPA Number of columns downloaded. Please skip this parameter (mark with comma if using additional parameter eg. DIRECTION, SHOW PRICE, CURRENCY, GPA A Boolean value where TRUE displays the values HORIZONTALLY and FALSE display the data vertically(Default setting). Selecting the FIELDS vertically will download the data horizontally. Please see the below examples. Enter P to display price for bonds which are quoted in yield (Only applicable to fixed income securities) Enter the 3 letter ISO code, in quotation marks or currency. (see the appendix for the whole Currency list) Default is the local currency for the security) Choose to use the average or closing price for the period. G request the average pricing for the choosing PERIOD. Leave empty for default.
Note III.2.1: All parameters may be embedded in the function or referenced via cells For a list of fields available historically, refer to the History Wizard all fields that are available once a security is entered are historical fields. All or some of the optional parameters maybe left out (in which case the default values will be used). Leave an extra comma in lieu of the parameter you are excluding. Example: The closing price of Microsoft form 1/1/00 through 1/1/02 in reverse chronological order would be requested through the following statement: =BLPH( MSFT Equity , PX LAST , 1/1/00 , 1/1/02 ,,TRUE) BLPH uses ActiveX technology to retrieve data (as opposed to DDE which was default for History wizard with versions 2.2 or older) this is quicker and more efficient than a DDE link via the History Wizard. How to format the cell to be Date setting Step one: choose the target cell and click the right button on your mouse. Select the Format Cells (To choose the whole column or row by clicking the top letter or left number of it) Step Two: Under the Number section, choose the Date in the Category and Type. Press OK.
Page 33 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Tips III.2.1: You can use BLPTODAY() or TODAY() and BLPNOW() in the START OR END DATE parameters to get historical data. Eg. =BLPH( IBM EQUITY , LAST PRICE ,BLPNOW()). Also you can get a rolling history of 50 days in the Start or End date, you could use =BLPTODAY()-50, =TODAY()-50 or BLPNOW()-50 as the start or end date. Important note: please do not use NOW(), it will make the excel run all the time. You can try the TIP III.2.1 Example in the related Excel file named Examples for download document under sheet named Example for BLPH . Use REFERENCE CELL to get ride of the sequence calculate errors. You can use reference cell to fill the option parameters, to omit them you just leave them blank instead of giving the value of the parameter. (See the Example for download document Example for BLPH Tips III.2.1 Example Example: =BLPH(A20,A22:A24,B20,C20,D20,E20,F20,G20,H20,I20,4,25,L20,M20,N20,O20) Note: You have to enter the Required Parameters.
Page 34 of 73
Bloomberg Documentation By Rasheed Abad
3.
Master of Finance
Data Download
BLPSH Function
=BLPSH(SECURITY, FIELDS, DATE, NON-TRADING DAYS*, FILLER*,[OMIT], CURRENCY*) Purpose: To bring in a single point of historical data for a specified date and field Parameters: SECURITY A valid ticker or ticker/exchange combination followed by relevant yellow market sector key (Please see the NOTE). You can also use identifiers such as CUSIPS or ISINs which you would stipulate following the yellow market sector key. Example: IBM US EQUITY, DBR 04 09 GOVT, 459200101 US EQUITY CUSIP FIELDS One or more recognized field mnemonics representing the data you want to bring in historically. To find field mnemonics, you can use the field search wizard on the Bloomberg Excel Add-in Tools (See Field Search subsection under the Excel Add-in Tools section) Example: PX_ASK (Ask price), PE_RATIO (Price/Earning ratio). Note: if a field is not available historically, #N/A Hist is return. (See Error Library for more error information) DATE
A specific date, entered in the format that matches the settings in the control panel (Start --> Control Panel --> Regional Settings. Usually MM/DD/YY or MM/DD/YYYY.) Tip: To always display a date 20 days ago (for example) you can use the =BLPTODAY()-20 formula.
NONTRADING (optional) FILLER (optional)
Be sure to format the cell is Date format (see Note III.2.1 for help the format setting). Sets whether to include Non-trading days. N All weekdays only (show Mon-Fri), C All calendar days (everyday). If omitted, it will show all active trading days only. Formats the type of data returned for non-trading days, where you have selected to display non trading days. N display #N/A NA , C Carries over last available data (show the previous trading day s value) Default is Carry Over. Note: Using the formula:=blpsh("IBM US EQUITY","LAST PRICE","08/06/05","c","c") you will get the last available price even if the specified date falls on a Saturday or Sunday. (See the Example for more detail). However, BLPSH WILL ONLY GO BACK BY 20 DATA POINTS so if there are no prices in the last 20 working days you will get #N/A Hist. (See Error Library for more error information)
CURRENCY (optional)
Enter the 3 letter ISO code, in quotation marks or currency. (see the appendix for the whole Currency list) Default is the local currency for the security) Page 35 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Tips III.3.1: You can use BLPNOW() or NOW() and BLPTODAY() or TODAY() in the DATE parameters to get single point historical data for the most recent value. Eg. =BLPSH( IBM EQUITY , LAST PRICE ,BLPNOW()). Also you can use BLPNOW()-1 to get the previous day close price. You can try the TIP III.3.1 Example in the related Excel file named Examples for download document under sheet named Example for BLPSH .
Examples of BLPSH: You can copy and paste the following in a particular cell Content =blpsh( IBM US EQUITY , PX LAST , 08/22/05 ) DBR 04 09 GOVT PX BID PX ASK 08/22/05 =blpsh(A4,B4:C4,D4) =blpsh( IBM US EQUITY , PX LAST , 08/06/05 , c , c )
Cell A3 A5 B5 C5 D5 A6 A8
Result:
Page 36 of 73
Bloomberg Documentation By Rasheed Abad
4.
Master of Finance
Data Download
BLPI Function
=BLPI?(SECURITY, FIELD(S), START DATE TIME, END DATE TIME*, BAR SIZE*, REVERSE ORDER*, DATE TIME*,ROWS, COLUMNS, DIRECTION*, FILLER*) Note: ? = T (BLPIT) indicates that the values returned should be from Traded values ? = A (BLPIA) indicates that the values returned should be from Ask values ? = B (BLPIB) indicates that the values returned should be from Bid values = BLPI (BASE FIELD, SECURITY, FIELD(S), START DATE TIME, END DATE TIME*, BAR SIZE*, REVERSE ORDER*, DATE TIME*,ROWS, COLUMNS, DIRECTION*, FILLER*) Note: The difference with BLPI? And BLPI BLPI? use T, A, B indicates Trade, Ask and Bid values BLPI use first parameter BASE FIELD to indicate the information (See Parameter BASE FIELD for more information) Purpose: To provide historical intra-day data for a specified time period, bar size and field. Parameters: BASE Side of the market for which you are requesting Intraday data. Examples: FIELD BEST_BID, BEST_ASK, LAST TRADE. #NA Base Fld occurs because of the incorrect base field value. SECURITY A valid ticker or ticker/exchange combination followed by relevant yellow market sector key (Please see the NOTE). You can also use identifiers such as CUSIPS or ISINs which you would stipulate following the yellow market sector key. Example: IBM US EQUITY, DBR 04 09 GOVT, 459200101 US EQUITY CUSIP FIELDS A valid field mnemonic. Any of the following may be used: OPEN, HIGH, LOW, LAST_PRICE, NUMBER_TICKS, VOLUME. #NA Fld occurs because of the incorrect field value. START A start date followed by a space followed by a time. The date should be DATE TIME entered in the format that matches the settings in the control panel (Start --> Control Panel --> Regional Settings. Usually MM/DD/YY or MM/DD/YYYY.) The time format should be in the format: HH:MM. Note: Intraday history is available for up to 50 business days. Any prior requests will be met with the #N/A History error. #NA Start occurs if start date is not a date, or in the future. Be sure to format the cell is Date format (see Note III.2.1 for help the format setting). END DATE An end date followed by a space followed by a time. Sets the End Date TIME Time for the data, refer to the above for formatting requirements. If (optional) omitted, data downloads until present. #NA End occurs if End date is not
Page 37 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
a date, or before start.
BAR SIZE (optional)
Sets the granularity of the data received. Entered as a whole number which represents minutes. If omitted, defaults to 1 min which is the lowest level of granularity possible. Note: The maximum bar size is 1440 (60min*24hr). #N/A Unknown occurs, where you have entered bar size bigger than 1440.
REVERSE (optional)
DATES TIME (optional)
Note: No double quotes required. Default setting is FALSE. #N/A RevOrd occurs, where you have entered TRUE or FALSE in double quotes. A Boolean value where TRUE represents a reversal in chronological order. A Boolean value where FALSE indicates the date time will not be shown. Note: No double quotes required. Default setting is TRUE (show dates).
ROWS
Number of rows downloaded. Please skip this parameter (mark with comma if using DIRECTION for horizontal download) COLUMNS Number of columns downloaded. Please skip this parameter (mark with comma if using DIRECTION for horizontal download) DIRECTION A Boolean value where TRUE displays the values HORIZONTALLY while (optional) FALSE displays the data vertically (defaults to FALSE). Selecting the FIELDS vertically will download the data horizontally. (See Example for more detail) FILLER Formats the type of data returned for times where no trades have been (optional) executed. N display #N/A NA , C Carries over last available data (show the previous trading day s value) Default is Carry Over. CURRENCY Enter the 3 letter ISO code, in quotation marks or currency. (see the (optional) appendix for the whole Currency list) Default is the local currency for the security)
Examples of BLPI?: You can copy and paste the following in a particular cell Content =BLPTODAY() =BLPIT("YHOO US EQUITY","LAST_PRICE","09/01/05 15:00","09/01/05 16:00",5) =BLPIB("YHOO US EQUITY","LAST_PRICE","09/07/05 16:00",,10) =blptoday()-100 =blptoday()-99
Cell C1 A3 A17 A21 A22
Page 38 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
=BLPIA("YHOO EQUITY","LAST PRICE",A21,A22) =BLPIT("YHOO EQUITY","LAST PRICE",A21,,1440)
A23 A25
Result:
Examples of BLPI: You can copy and paste the following in a particular cell Content =BLPTODAY() =BLPI("LAST TRADE","YHOO US EQUITY","LAST_PRICE","09/01/05 15:00","09/01/05 16:00",5) =BLPI("BEST_BID","YHOO EQUITY","LAST PRICE","09/07/05 16:00",,10) =blptoday()-100 =blptoday()-99 =BLPI("BEST ASK","YHOO EQUITY","LAST PRICE",A21,A22)
Cell C1 A3 A17 A21 A22 A23
Result: Page 39 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Page 40 of 73
Bloomberg Documentation By Rasheed Abad
5.
Master of Finance
Data Download
BLPB Function
= BLPB (SECURITY, FIELD, [OMIT], [OMIT], ROWS, COLUMNS, AGGREGATE IN ONE CELL*) Purpose: To generate bulk data calls in a highly customizable manner Parameters: SECURITY A valid ticker or ticker/exchange combination followed by relevant yellow market sector key (Please see the NOTE). You can also use identifiers such as CUSIPS or ISINs which you would stipulate following the yellow market sector key. Example: IBM US EQUITY, DBR 04 09 GOVT, 459200101 US EQUITY CUSIP Note: #N/A MultiSecs is returned when more than one security is selected. FIELD
The data field mnemonic that Bloomberg provides bulk data for. Examples: INDX_MEMBERS, FLT_CPN_HIST Note: #N/A MultiFlds occurs when more than one field is selected.
ROWS
Number of rows downloaded. Please skip this parameter (mark with comma if using DIRECTION for horizontal download) COLUMNS Number of columns downloaded. Please skip this parameter (mark with comma if using DIRECTION for horizontal download) AGGREGATE Optional Boolean flag that must be set if return data is to be placed in IN ONE CELL one cell. TRUE displays the data in one cell. (optional) Note III.5.1: The BLPB function has a 10,000 character buffer.
Examples of BLPB: You can copy and paste the following in a particular cell Content =BLPB("IBM US Equity","OPT_CHAIN") =BLPB("UKX Index","INDX_MEMBERS") =BLPB("IBM 7 11/05/07 Corp","CALL_SCHEDULE")
Cell A3 D5 F8
Result:
Page 41 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Page 42 of 73
Bloomberg Documentation By Rasheed Abad
6.
Master of Finance
Data Download
General Tips
1. The Bloomberg worksheet functions are NOT CASE SENSITIVE and UNDERSCORES are NOT required. Hence PX_ASK, Px_ask, px ask, pX_ask etc all achieve the same thing. 2. REAL TIME DATA i. BLP Function is the only function to get the real time data which will update on the screen without you doing anything). And the only subset of fields are real time and these are visible through the TABLE WIZARD fields folder named REAL TIME QUOTES ( refer to the CHAP II SECTION ONE STEP THREE). ii. You can use the FIELDS SEARCH TOOL select the Monitoring fields and Static fields to get the mnemonics for Real Time Quotes fields (refer to the CHAP II SECTION SIX) iii. Any field with a PX in it is NOT a real time field iv. Fields which are not real time can be updated by refreshing links. Method 1: double click the formula and press Enter/Go ; Method 2: Clicking on the yellow lightning bolt on the Bloomberg toolbar ; 3. In practice it is far more effective to reference cells containing parameters rather than 'embedding' them within the statement. See the section below for details. Note that embedding parameters within the statement means that double quotes are required around all text and date parameters. 4. SECURITY SECTOR KEY Yellow market sector keys are ALWAYS required for the security Parameter. Unfortunately they do not exactly match the text on the yellow key buttons on the Bloomberg keyboard. For convenience they are included the Govt, Corp, Mtge, Muni, Pfd, Equity, Comdty, Index, Curncy, Client. Notice: the extra 'o' and 'u' in Comdty and Curncy as compared with the yellow key mnemonics on your keyboard 5. IDENTIFIERS: The default identifier for the security is TICKER/EXCHANGE. However any of the following can be used: AIBD, AUSTRIA, BELG, CEDEL, COMNUM, CUSIP, DENMRK, DUTCH, EUROCLR, FRENCH, ISIN, ISMA, ITALY, JNCOMNUM, JAPAN, LUXEMBRG, NORWAY, RGA, SEDOL1, SEDOL2, SPAIN, SWEDEN, VALOREN, WERTP. The identifier always comes after the yellow market sector key as the security parameter, unless you are stipulating it separately as the identifier parameter using BLP(refer to CHAP III SECTION ONE). 6. OPTIONAL PARAMETERS
Page 43 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
As you will have seen, some parameters for the Bloomberg Excel Functions are marked * as an option. For those parameters you can pass it, and then the default value will be chosen. If you want to set some value to one parameter and omit other parameters which are in the middle of a parameter sequence, you must add comma to maintain the correct sequence of the parameters. Example 1: In the EXAMPLE OF BLPI?, we want to get the 1440 min interval Yahoo trade data from 100 days ago till current time. We omitted the END DATE TIME parameter which is the 4th parameter is in the parameter sequence, but need to set the bar size to 1440 minutes. So we write the formula as =BLPIT( YAHOO EQUITY , LAST PRICE ,A21,,1440), there are two comma between A21 and 1440 . You can use the flexibility of REFERENCE CELL to get ride of the sequence calculate errors. You can use reference cell to fill the option parameters, to omit them you just leave them blank instead of giving your value. Example 2: In the EXAMPLE OF BLPH REFERENCE CELL, We use the BLPH function and refer all the parameters to cells. =BLPH(A20,A23:A25,B20,C20,D20,E20,F20,G20,H20,I20,4,26,L20,M20,N20,O20) Giving all the required parameters, we can choose to give some optional parameters value and leave the other blank. If we want to set the PERIOD to W for weekly, but did not want to set any of the other optional parameters, we could achieve this by setting F20 to be W (note: without ).
Page 44 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
IV. Practical Examples 1. Download Data for Corporate Bonds In order to download some information about corporate bond, we need to know the target bond ticker in the Bloomberg system then using the Table wizard or Excel function methods to download the requested data to the excel file. So in this section, I will introduce the step by step method to find a corporate bond ticker and the easiest method to download the requested data. NOTE: Please see the Excel file named CorpBondExample.xls for the result table.
Find Corporate Securities Ticker: Step one: Go to the Bloomberg page CORP page type Corp TK
1
1 OR go to any Bloomberg
Step two: Type in the known information for example the corporate name GE, IBM or YAHOO
Step three: Choose the TICKER you are looking for, in the example, GE will be the ticker we are looking for. So just choose anyone with the ticker name GE, for example 22).
Page 45 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
In this result table, you have a lot of options to choose OPTION 1: coupon type under Cpn Typ draw down table.
OPTION 2: Maturity Type under Mty Typ draw down table.
OPTION 3: Exclude Type under Exclude draw down table.
Page 46 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Also in the result Bloomberg screen you can sort the table based on different column. You can choose Issuer , Coupon , Maturity , Series , Rating , Maturity Type , Country , or Currency by right click the mouse on the corresponding name. In the example, we choose to sort based on Maturity .
EXAMPLE: In the data download example, we will choose the GE ticker, Floating coupon type, Callable bond, and exclude all the Matured or called bond. We will get the following Bloomberg Screen.
Use Page Down we will see the following screen:
Page 47 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
If I want to choose all the securities in those two Bloomberg screens to the download some information, we will use the right top PIN . Hold the PIN and drop to the target excel sheet. For the PAGE 1/2 , hold the PIN and drop to the cell A2 in a opened excel file. For the Page 2/2 , hold the PIN and drop to the cell A22. Because there are total 20 securities in the page 1/2, we want to start the security from page two from A 22. Then in the Excel file, we can use excel functions or FILL RANGE method to download data for the target securities. In this example, I will show you how to construct a table similar to the previous Bloomberg Screen which give us all the description of the corporate bond.
Download Data in Excel File: Step one: find the FIELDS using Field Search
wizard :
Go to cell B1, Click , choose the Corp , choose all fields except Bulk formatted fields only , type issuer , then . Select the issuer under the category Descriptive Info . Now, make sure you click the Position mnemorics option with Horizontally which in the left end corner of the wizard window. *: Type coupon type in the Show fields that contain , then . Select the Coupon Type under the category Descriptive Info .
Page 48 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Do the same procedure as * for all the fields search. To get the following excel table. NOTE: Refer to the FIELD SEARCH WIZARD section for detailed information.
Step two File in the table using the Fill Range Go to HOME cell A1, click the will get the following result table.
wizard :
, choose one fill in method, then . You
NOTE: Refer to the FILL RANGE WIZARD section for detailed information.
2. Download Data for Required Index In order to download some information about Index, we need to know the target index ticker in the Bloomberg system then using the Table wizard or Excel function methods to download the requested data to the excel file. So in this section, I will introduce the step by step method to find an Index ticker and the easiest method to download the requested data. NOTE: Please see the Excel file named IndexExample.xls for the result table.
Page 49 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Find Index Securities Ticker: Step one: Go to the Bloomberg page click the INDEX yellow key 1 OR click the INDEX yellow key SEARCH. You will get the following INDEX search page, type in the key word of the target index. Eg. Treasury Strips US to search the US treasury strips index.
Step two: We will see the following Bloomberg window result, in this window we choose the 12) INDICES/STATISTICS
Page 50 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Step three: You will see the following result page. In the right top corner of the page, you can see the total results and pages. You can narrow down the result to give more information key word in the yellow tab and search again. In this example, suppose we want to get the ticker of US Treasury Strips 1 year then we will click the 14).
Step four: Then we can get the following Bloomberg Page. The ticker will be the left top corner. We will input this ticker to the Excel sheet to get the required information.
NOTE: usually you can guess the other similar INDEX ticker based on the ticker. For example, C0792Y Index will be the ticker for BFV USD US Treasury Strips 2 Year.
Page 51 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Step five (option): If you want to get similar index ticker for different parameters, you can use the ALLQ after step four. In the example we will get the following Bloomberg window.
Download Data in Excel File: Step one: Input the Ticker Write the Ticker to the Excel file cell. In the Excel example, we will try to construct the US Treasury Strips term Structure. So we will use the 3 months, 6 months, 1 year, 2 year, 3 year, 4 year, 5 year, 7Y, 8Y, 9Y, 10Y, 15Y, 20Y, 25Y, 30Y. we will use the right top PIN
. See Corp bond section for more detail.
Step two: find the FIELDS using Field Search
wizard :
Go to cell B1, Click , choose the Index , choose all fields except Bulk formatted fields only , type last price , then . Select the PX_PRICE under the category Pricing . Now, make sure you click the Position mnemorics option with Horizontally which in the left end corner of the wizard window. NOTE: Refer to the FIELD SEARCH WIZARD section for detailed information.
Page 52 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Step three File in the table using the Fill Range Go to HOME cell A1, click the will get the following result table.
Data Download
wizard :
, choose one fill in method, then . You
NOTE: Refer to the FILL RANGE WIZARD section for detailed information.
Page 53 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
3. How to save the Bloomberg Download Data without formulas When you finish download all the data using the above methods to the Excel. In order to keep those data in text format and can not be updated from Bloomberg automatically, you need to save those data without formulas. The easiest way to do that is using COPY (Ctrl+c) and PASTER SPECIAL function in the Excel. I will use the USD INTEREST RATE SWAP excel file as example. Please follow the 3 steps: STEP ONE: Create or open the file which has connection with Bloomberg to download the data. Select the data area you want to save from the original download sheet. E.g. Open the excel file USD INTEREST RATE SWAP and update the data of the file in the white cell of square area A1 to E71. Assume we want to save the download data of square area A1 to E15, select the area as following figure:
The cell with formula
Page 54 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
STEP TWO: Copy those data Method one: use [Ctrl] + [c] from the keyboard Method two: Click right button of the mouse you will see a list, choose Copy and click the LEFT button of the mouse. As following figure:
NOTE: After the copy command, the solid boundary of the selected area will become flash moving dash line. STEP THREE: (the most important step) Paste special the data: Go to the file or sheet where you want to store those data. Choose one cell then click the RIGHT button of the mouse, select the Paste Special
Page 55 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
You will see the Paste Special Selection Table as following figure; choose the Values then click ok
Page 56 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Then those selected data will be stored as test without formula. As shown in the following data:
The cell without formula
Note: If you have download bunch of data in one sheet and want to save all the data, you can uses the little tricky to do that. Instead of choose the cell area to copy you can choose the LEFT TOP cell as marked in the following figure in the STEP ONE, and also in the STEP THREE, you can choose the LEFT TOP cell in the new sheet or file to do the Paste Special step.
Page 57 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
The LEFT TOP cell to select the whole sheet
Page 58 of 73
Bloomberg Documentation By Rasheed Abad
V.
Master of Finance
Data Download
API Error Library
Introduction When you make a request for Bloomberg data either via a Wizard or one of the worksheet functions, you expect to see data returned. If you do not see data returned, an error will appear instead. These errors are like messages describing as accurately as possible what has gone wrong. Understanding these messages is the key to taking appropriate measures to resolve the problem. The API Error Library will give you description of all Bloomberg API errors and some related Excel errors and also this library will give the proposed actions to Note: If you have any question during the data download, don t forget to double hit the key and write a brief note of the problem and the action you have taken to the Bloomberg help desk. resolve the problem. Especially when you use the Bloomberg Excel functions to request data. You may meet two broad groups of errors Bloomberg API software errors & Excel errors. Bloomberg handled errors are all preceded by a #N/A. There are three Excel errors that can be invoked when trying to retrieve Bloomberg data. These are #NAME?, #REF! And #VALUE!. These are dealt with in the library. It is important to note that these errors can be brought about for a range of other reasons NOT related to Bloomberg API software.
Bloomberg Handled Errors List 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14.
#N/A #N/A Auth #N/A Auth -3001 #N/A Auth -4001 #N/A Com #N/A Data CTRL #N/A End #N/A FLD #N/A Hist Fld #N/A #N/A N Ap #N/A N.A. #N/A N/A #N/A NA
15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28.
#N/A NtrdVal #N/A Nested #N/A Period #N/A Perm #N/A RevOrd #N/A Rl Tim #N/A Sec #N/A Shntrd #N/A Size #N/A Start #N/A Tim #N/A Trd #N/A Unknown #N/A Sec Tp
29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41.
#N/A Neg #N/A OvrdVal #N/A Full #N/A ShYieldFlg #N/A BulkFld #N/A Ccy #N/A Dberr #N/A InvalidRepl #N/A ShDates #N/A MD Limit #NAME? #REF! #VALUE!
Page 59 of 73
Bloomberg Documentation By Rasheed Abad
1.
Master of Finance
Data Download
#N/A
Bloomberg handled error / Communication Type: The request for the field is in transition Cause: Action: Wait for the data to be retrieved. If, after a number of minutes, no data is retrieved and no other error is displayed, there is a communication error. Close down Excel, shut down the Bloomberg DDE server, then go to START RUN and type BBSTOP and click to stop the BBCOMM. Then re-open DDE Server from START PROGRAMS BLOOMBERG DDE SERVER(lightning bolt) followed by Excel. If the problem persists, contact the Help Desk.
2. Type: Cause:
#N/A Auth Bloomberg Handled error / Authorization #N/A Auth indicates the user is not getting permission to receive data via the API and hence into Excel. This is because the user clicked 'No' when asked if they agree to abide by the terms of the Data Feed Addendum, or, because the Addendum was never signed.
Action: Shut Down Excel, the DDE and reboot your machine. When prompted with: 'do you agree to abide by the terms of the Data Feed Addendum?' or a similar message, make sure you click 'Yes'. If this fails to resolve, use the BREP and contact ALYSSA LEWIS who can advise you on signing the Addendum if necessary or offer further help.
3. Type: Cause:
#N/A Auth -3001 Bloomberg Handled error / Authorization #N/A Auth -3001 indicates the user has exceeded the 3500 security limitation of real-time data download per user. This limit only applies to realtime streaming data. The request of data will be displayed until the limit is reached and then the error message #N/A Auth -3001 will be displayed with each subsequent request.
Action: As this is a daily limit, the user's can shorter the list of securities for which real-time data is being requested.
4. Type: Cause:
#N/A Auth -4001 Bloomberg Handled error / Authorization 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 Auth -4001 will be displayed with each subsequent request for both static and real-time data requests.
Page 60 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Action: As this is a daily limit, the user's hit count is reset around midnight regionally. After the limitation is reset they can begin to receive data again. The limit implemented is 500,000 pieces of data per user per day.
5. Type: Cause:
#N/A Com Bloomberg Handled error / Communication 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.
Action: Since the connection may be jammed, it is best to restart it. Close down Excel, shut down the Bloomberg DDE server, then go to START->RUN and type "BBSTOP" and click to stop the BBCOMM. Then re-open DDE Server from START>PROGRAMS->BLOOMBERG->DDE SERVER (lightning bolt) followed by Excel. If the problem persists, contact the Help Desk.
6. Type: Cause:
#N/A Data CTRL (never happened) Bloomberg Handled error / Installation 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 operating system - or any system which has neither Microsoft IE5 or higher or Microsoft Office2000 installed.
Action: If running Windows 95, ask your PC Support department to install either Microsoft IE5 or higher or Office2000, then, re-install the Bloomberg API software. Check minimum and preferred pc Desktop requirements on BBPC 2 1 . If problem persists, contact the Help Desk.
7. Type: Cause:
#N/A End Bloomberg Handled error / Parameter Mis-specification - BLPH / BLPI Exclusive to BLPH and BLPI functions where the End Date parameter is not valid or is set before the Start Date
Action: Change the end date parameter so that it is valid.
8.
#N/A FLD
Bloomberg Handled error / Field Mis-specification Type: The field mnemonic you have used is invalid Cause: Action: Check the field mnemonic. The best way to find valid fields is to use the Field Search tool (see Chap II Section 6 Field Search tool). If you have been recommended a field that appears unavailable to you, make sure you are running the latest version of the Data Dictionary(see Note V.8.1). Note that field mnemonics are not case sensitive and underscores are not required
Page 61 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Note V.8.1: How to check Software Versions? Type UPGR to view the versions of API software that you are currently running. Or, you may contact our Technical Support department at the number displayed when you hit the key on your Bloomberg.
9. Type: Cause:
#N/A Hist Fld Bloomberg Handled error / Field Mis-specification The field for which you have requested historical data is not a history field Occurs primarily with BLPH function and BLPSH functions
Action: Change the field to one which is history enabled. For a list fields which are history enabled, open the History wizard, enter a security and hit Next. The fields listed under the categories displayed are history fields which can be used in conjunction with BLPH.
10. Type: Cause:
#N/A History Bloomberg Handled error / Parameter Mis-specification BLPH/BLPSH There is no Historical data available for the Date(s) specified. Occurs primarily with BLPH and BLPSH functions.
Action: Adjust the Date / Date Range as necessary and also confirm that the data is available historically on a Bloomberg screen.
11. Type: Cause:
#N/A N Ap Bloomberg Handled error / Field Mis-specification 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.
Action: Change the security or the field so that they are appropriately matched.
12. Type: Cause:
#N/A N.A. Bloomberg Handled error / Data Data for the specified derived field is not available. There are a number of reasons why this can occur. Of the thousands of fields available to the API, many are derived from contributed data. While Bloomberg System endeavor to calculate and display all fields as soon as the necessary data is made available to us, not all data may be available for a particular field to hold non-null values at all times. 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.
Page 62 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Action: If you suspect the data should be available, contact the Help desk detailing the field and security<s> you are using. Check values assigned to overridable fields.
13. Type: Cause:
#N/A N/A Bloomberg Handled error / Data The data for the specified history, intraday or real time field is not available. Again, there are potentially a number of causes for this. Some exchanges may not allow data into the API at all if it is not on a real time basis. 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.
Action: Check if you are signed up for real time data. You can use the EXCH function on the Bloomberg for this. Contact the Help desk detailing the field and security<s> you are using.
14. Type: Cause:
#N/A NA Bloomberg Handled error / Data To be distinguished from #N/A N.A. and #N/A N/A outlined above, #N/A NA occurs exclusively with the BLPH function when the user has requested the inclusion of Non-trading days, and specifically requested the 'filler' for the non-trading days to be #N/A NA. I.e.: The user has stipulated N for the ninth parameter of the BLPH function. (See Chap III Section 2 FILLER parameters)
Action: Since this is a user stipulated, no action would be necessary.
15. Type: Cause:
#N/A NtrdVal Bloomberg Handled error / Parameter Mis-specification - BLPH Exclusive to the BLPH function where the value passed to the optional 'FILLER' parameter (the ninth parameter of BLPH) is invalid. (See Chap III Section 2 FILLER parameter)
Action: Edit the setting for this parameter to either N or C.
16. Type: Cause:
#N/A Nested (never happened) Bloomberg Handled error / Historical data May occur when an excel generated date, e.g. =today(), is used within a BLPSH and BLPH formulas.
Action: This error occurred in a older version of the software and should no longer arise. Therefore if you see this problem please contact the HELP Desk.
Page 63 of 73
Bloomberg Documentation By Rasheed Abad
17. Type: Cause:
Master of Finance
Data Download
#N/A Period Bloomberg Handled error / Parameter Mis-specification - BLPH Exclusive to the BLPH function where the value passed to the optional 'PERIOD' parameter (the seventh parameter of BLPH) is invalid. (See Chap III Section 2 PERIOD parameter)
Action: Edit the setting for this parameter.
18. Type: Cause:
#N/A Perm Bloomberg Handled error / Permission User is not permitted 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. many IBES fields (see Note V.18.1).
Action: Contact third parties to ensure you are subscribed / got permission for the data. If you feel you should be permitted for the field, contact the Help Desk. Note V.18.1 N.B effective 01-Aug-00, only a limited subset of IBES fields will be available through the API without a subscription to IBES. The 'free' fields are outlined on pages 3 & 4 of a letter to affected clients as at June 24. See BBXL 14 8 . All questions regarding subscriptions should be made to IBES: New York: 646 822 2800.
19. Type: Cause:
#N/A RevOrd Bloomberg Handled error / Parameter Mis-specification - BLPH Exclusive to the BLPH function where the value passed to the optional 'REVERSE' parameter (See Chap III Section 2 REVERSE parameter) is invalid. There are only two settings for this parameter -TRUE and FALSE. Any deviation from this will result in this error. Note V.19.1: this parameter is peculiar in the fact that it is a 'Boolean' variable. This means, if you are using it from WITHIN a BLPH function it does NOT require quotation marks around it.
Action: Edit parameter to either TRUE or FALSE. Remove quotation marks if used from within a BLPH function.
20. Type: Cause:
#N/A Rl Tim Bloomberg Handled error / Data 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 Intra-day basis.
Page 64 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Action: Check that the pricing provider is pricing on an intraday or executable basis using the ALLQ or PCS screens on the Bloomberg. API, by default will use the price provider selected in your default settings on Bloomberg (FMPS) * Also note that if a provider's price or yield is in Grey on the ALLQ screen that the value Does not monitor real-time as indicated in the note at the bottom of ALLQ screen.
21. Type: Cause:
#N/A Sec Bloomberg Handled error / Security Mis-specification 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.
Action: Check the spelling of the security. If using equity tickers, ensure that you include the exchange ticker. If using identifiers (e.g cusips, isins etc), ensure that they are correct, and that you have stipulated that you are using such identifiers. Ensure that you have stipulated an appropriate yellow market sector key. See Note III.1.1 for all valid sector keys. Note: for Equities the CNDF setting will affect whether an Equity is recognized by Bloomberg in API.
22. Type: Cause:
#N/A Shntrd Bloomberg Handled error / Parameter Mis-specification - BLPH Exclusive to the BLPH function. The value passed to the 'Non-Trading Days' parameter (the eighth parameter of BLPH) is invalid. The only valid values for this parameter are "N" for Non-Trading Days and "C" for All Calendar Days.
Action: Edit the setting for this parameter to either N or C. (See Chap III Section 2 NONTRADING parameter)
23. Type: Cause:
#N/A Size Bloomberg Handled error / Miscellaneous 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.
Page 65 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Action: Ensure that you select "Use BLPH" type request on the last step of the History Wizard instead of DDE type request. Another alternative is to adjust time series chosen in the "Select Time Parameters" step within the History Wizard. Note: Choosing the "Select Fix Time from Current" selection in the "Select Time Parameters" step of the History Wizard will ONLY allow the use of the DDE type request.
24. Type: Cause:
#N/A Start Bloomberg Handled error / Parameter Mis-specification - BLPH Exclusive to the BLPH function where the value passed to the compulsory parameter 'Start Date' (the third parameter of BLPH) is invalid, usually because it is not a valid date format, or because it is a date set in the future.
Action: Change the Start date parameter so that it is valid. (See Chap III Section 2 START DATE parameter)
25. Type: Cause:
#N/A Tim Bloomberg Handled error / Communication 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).
Action: Close down Excel, shut down the Bloomberg DDE server, then go to START->RUN and type "BBSTOP" and click to stop the BBCOMM. Then re-open DDE Server from START->PROGRAMS->BLOOMBERG->DDE SERVER (lightning bolt) followed by Excel. If the problem persists, contact the Help Desk.
26. Type: Cause:
#N/A Trd Bloomberg Handled error / Data 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.
Action: For fixed income securities, check you pricing provider using FMPS or PCS . Contact the Help Desk for further assistance.
27. Type: Cause:
#N/A Unknown Bloomberg Handled error / Miscellaneous An error for which there is no other programmed error handler. Occurs infrequently when our development team adds new errors between versions of the DDE software.
Page 66 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Action: Contact the Help Desk with details of security, field and details of the request.
28. Type: Cause:
#N/A Sec Tp Bloomberg Handled error / Security Mis-specification The specified security type is not among the valid security types (not ticker exchange nor SEDOL nor CUSIP).
Action: Check that the security is a valid security type and follows the proper syntax.
29. Type: Cause:
#N/A Neg Bloomberg Handled error / Miscellaneous The specified field is a numeric field that cannot be negative but the calculated value is negative.
Action: Check that the data is field is applicable for the security indicated.
30. Type: Cause:
#N/A OvrdVal Bloomberg Handled error / Calculation Override Invalid override value has been entered for user input within a calculation override BLP statement.
Action: Check that the proper value is entered into the calculation override.
31. Type: Cause:
#N/A Full Bloomberg Handled error / Miscellaneous Indicates that the BLPB function has failed to insert the necessary number of columns due to the final sheet column being occupied.
Action: Create the BLPB formula on a spreadsheet that has the necessary number of columns available.
32. Type: Cause:
#N/A ShYieldFlg Bloomberg Handled error / Miscellaneous Indicates that the BLPH function recognized that the Price/Yield flag parameter is not correct.
Action: Be sure that the proper input is utilized for the Show Price parameter of the BLPH function. (See Chap III Section 2 Show Price parameter)
33. Type: Cause:
#N/A BulkFld Bloomberg Handled error / Field Mis-specification within the BLPB function Indicates that the BLPB function or Bulk DDE link is attempting to use a field that does not conform to the Bloomberg Bulk format. Page 67 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
Action: Be sure that a Bloomberg Bulk field is used in the BLPB function.
34.
#N/A Ccy
Bloomberg Handled error / Miscellaneous Type: Indicates that the currency specified does not exist Cause: Action: Be sure that the currency is a 3 letter ISO code. Use the History Wizard to get a list of valid currencies or refer the Valid Currencies List in the Appendix
35. Type: Cause:
#N/A Dberr Bloomberg Handled Error / Security Mis-specification 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.
Action: Check the spelling of the security. If using equity tickers, ensure that you include the exchange ticker. If using identifiers (e.g CUSIPS, ISINS etc), ensure that they are correct, and that you have stipulated that you are using such identifiers.
36.
#N/A InvalidRepl
Bloomberg Handled Error / Miscellaneous Type: Indicates that an unspecified error has been identified. Cause: Action: Contact the Bloomberg 24 hour Help Desk via to troubleshoot.
37. Type: Cause:
#N/A ShDates Bloomberg Handled error / Parameter Mis-specification - BLPH Exclusive to the BLPH Function. This error message occurs when the value passed to the "Dates" parameter (the tenth parameter of BLPH) is invalid. The only valid values for the "Dates" parameter are TRUE and FALSE.
Action: Edit the setting for this parameter to either TRUE or FALSE. The entry of "TRUE" of "FALSE" with quotation marks will also cause this error. (See Chap III Section 2 DATES parameters)
38. Type: Cause:
#N/A MD Limit Bloomberg Handled Error / Data Limit Exclusive to the Market Depth fields in API, when you go over the 500 security monitoring limit, this is the error message received.
Action: Adjust the number of securities being monitored for Market Depth information.
Page 68 of 73
Bloomberg Documentation By Rasheed Abad
39.
Master of Finance
Data Download
#NAME? Excel Handled Error Text comprising the formula name is not recognized. Specific Cause in relation to Bloomberg Software Either one of the worksheet functions has been mis-spelt, or the Add-In has been disabled, or one of the files BLP.XLA or BLPH.XLA has been deleted or the software has not been installed.
Type: Cause:
Action: Check the spelling of the function. Check that between the Window and Data menu options in Excel, you can see the Bloomberg menu option (indicating the Add-In has been installed) From the Excel menu, select Tools --> Add-Ins, and ensure that the Bloomberg Add-In is checked. Note V.39.1:: The BLPH function requires a minimum of DDE 2.2 and the BLPI, a minimum of DDE 3.0 otherwise #NAME? will result. Search for the files BLP.XLA and BLPH.XLA In extreme cases where these have been deleted, a re-installation of the DDE will be necessary.
40.
#REF!
Type: General Cause: Specific Cause:
Excel Handled Error Where a cell reference is not valid. Rin relation to Bloomberg Software. Referencing a Dynamic Data Exchange (DDE) topic which is unavailable. This means that the Add-In BLP.XLA is not correctly referenced in the spreadsheet. This error will only occur when using the BLP function, and is only supported insofar as it relates to the BLP function.
Action: Check that the Bloomberg DDE Server is open (located on the Windows Taskbar). Note V.40.1::If this is not open, click on START PROGRAMS BLOOMBERG DDE SERVER. Click the Lightning Bolt icon at the top of Excel to "Enable Real-Time Links". If #REF! persists, click on START FIND FILES OR FOLDERS and search for BLP.XLA. Once located, go back to Excel, click on EDIT LINKS CHANGE SOURCE and navigate to the directory where the BLP.XLA resides and select it.
41.
#VALUE!
Type: General Cause: Specific Cause:
Excel Handled Error A parameter used contains data of the 'wrong type' e.g text where a number is Expected. Relation to Bloomberg Software. The problem here is that Excel uses this error as a capture-all error where a
Page 69 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download
parameter has been mis-specified. Bloomberg Add-In will override this error for specific problems i.e most of the Errors outlined above give errors which are different to #VALUE! because Bloomberg have programmed them that way. There are instances where the #VALUE! error can sneak through e.g leaving out the quotation marks around a field when embedding within a BLPH. This said, the Cause for this Error remains the same for our functionality - namely parameter mis-specification of some kind. Action: Check that the parameters are correctly specified and of the right 'type'.
Examples: In the following examples, I will show you some common error and the solving method.
In this example, we can see five common errors. For the #N/A Sec, that because IBM and IBM corp are invalid security name. So if you change them to be IBM equity then we can get the right solution. First, check the missing market yellow key. Second, check the right market yellow key. For the #N/A Fld, that because BID price is not the right field name. Go to the Field Search Wizard to check the right field name. But please see the Cell F4, it has wrong security name and field name. But you can see the field error has higher priority than the security error problem. For the #N/A N/A, the data is not available. In the IBM Equity example, IBM is traded in the NYSE which does not allow a delayed user to download any BID & ASK data for NYSE listed securities. #N/A N.A. which means data for the specified derived field is not available. The reason for that is NYSE does not apply this bid information for us. We need to buy some silences to get the information. If you suspect the data should be available, contact the Help desk detailing the field and security<s> you are using. #N/A Rl Tim which means the security for which real time data is being requested is not being priced in real time. For EQUITY you can type the TICKER EQUITY ALLQ to check the data availability. But in the example INDEX you can not use this function to get the right answer.
Page 70 of 73
Bloomberg Documentation By Rasheed Abad
VI.
Master of Finance
Data Download
Appendix
I. Valid Security sector Key: Govt, Corp, Mtge, Muni, Pfd, Equity, Comdty, Index, Curncy, Client. II. Valid Identifiers: TICKER/EXCHANGE, AIBD, AUSTRIA, BELG, CEDEL, COMNUM, CUSIP, DENMRK, DUTCH, EUROCLR, FRENCH, ISIN, ISMA, ITALY, JNCOMNUM, JAPAN, LUXEMBRG, NORWAY, RGA, SEDOL1, SEDOL2, SPAIN, SWEDEN, VALOREN, WERTP III. State Code: ALABAMA AL MASSACHUSETTS MA SOUTH DAKOTA SD ALASKA AK MICHIGAN MI TENNESSEE TN ARIZONA AZ MINNESOTA MN TEXAS TX ARKANSAS AR MISSISSIPPI MS UTAH UT CALIFORNIA CA MISSOURI MO VERMONT VT COLORADO CO MONTANA MT VIRGINIA VA CONNECTICUT CT NEBRASKA NE WASHINGTON WA DELAWARE DE NEVADA NV WEST VIRGINIA WV FLORIDA FL NEW HAMPSHIRE NH WISCONSIN WI GEORGIA GA NEW JERSEY NJ WYOMING WY HAWAII HI NEW MEXICO NM D. OF COLUMBIA DC IDAHO ID NEW YORK NY PUERTO RICO PR ILLINOIS IL NORTH CAROLINA NC VIRGIN ISLANDS VI INDIANA IN NORTH DAKOTA ND OTHER TERR OT IOWA IA OHIO OH TRUST TERR TT KANSAS KS OKLAHOMA OK AMER SAMOA AS KENTUCKY KY OREGON OR CANAL ZONE CZ LOUISIANA LA PENNSYLVANIA PA GUAM GU MAINE ME RHODE ISLAND RI MARYLAND MD SOUTH CAROLINA SC IV. Valid Currencies List SO STAN DARD
COUNTRY
SO STAN DARD
COUNTRY
SO STAN DARD
CU
CUBA
KI
KIRIBATI
PZ
AE
ANDORRA UNITED ARAB EMIRATES
COUNTRY PANAMA CANAL ZONE
CV
KM
QATARI
AFGHANISTAN
CX
RE
REUNION
AG
ANTIGUA AND BARBUDA
CY
YPRUS
KP
RO
AI
ANGUILLA
CZ
ZECH REPUBLIC
KR
COMOROS ST. KITTS AND NEVIS KOREA, DEM. PEOPLE'S REP.(NORTH) KOREA, REPUBLIC OF (SOUTH)
QA
AF
APE VERDE HRISTMAS ISLAND
ROMANIA RUSSIAN FEDERATION
AD
COUNTRY
SO STAN DARD
KN
RU
Page 71 of 73
Bloomberg Documentation By Rasheed Abad AL AM
Master of Finance
Data Download
DE DJ
ERMANY JIBOUTI
KW KY
KUWAIT CAYMAN ISLANDS
RW SA
RWANDA SAUDI ARABIA
AN
ALBANIA ARMENIA NETHERLANDS ANTILLES
DK
ENMARK
KZ
SB
SOLOMON ISLANDS
AO
ANGOLA
DM
LA
SC
SEYCHELLES
ANTARCTICA ARGENTINA AMERICAN SAMOA AUSTRIA AUSTRALIA
DO DZ
DOMINICA DOMINICAN REPUBLIC LGERIA
KAZAKHSTAN LAOS PEOPLE'S DEMOCRATIC REP.
LB LC
LEBANON ST. LUCIA
SD SE
SUDAN SWEDEN
EC EE EG
CUADOR STONIA EGYPT
LI LK LR
LIECHTENSTEIN SRI LANKA LIBERIA
SG SH SI
EH ER
ESTERN SAHARA RITREA
LS LT
LESOTHO LITHUANIA
SJ SK
SINGAPORE ST. HELENA SLOVENIA SVALBARD AND JAN MAYEN ISLANDS SLOVAKIA
ES ET
PAIN THIOPIA
LU LV
SL SM
SIERRA LEONE SAN MARINO
LY MA
LUXEMBOURG LATVIA LIBYAN ARAB JAMAHIRIYA MOROCCO
SN SO
SENEGAL SOMALIA
MC
MONACO
SR
SURINAME
MD MG
AQ AR AS AT AU AW AZ BA BB
ARUBA ZERBAIJAN OSNIA AND HERZEGOVINA ARBADOS
BD BE
ANGLADESH ELGIUM
FI FJ
BF
URKINA FASO
FK
BG BH
BULGARIA AHRAIN
FM FO
NLAND JI ALKLAND ISLANDS (MALVINAS) MICRONESIA (FEDERATED STATES OF) AEROE ISLANDS
BI
RUNDI
FR
RANCE
MH
BJ
ENIN
GA
GABON
MK
MOLDOVA, REPUBLIC OF MADAGASCAR MARSHALL ISLANDS MACEDONIA, FORMER YUGOSLAV REP.
BM
GB
UNITED KINGDOM
ML
MALI
TC
BN
BERMUDA RUNEI DARUSSALAM
GD
GRENADA
MM
MYANMAR
TD
BO BR
BOLIVIA RAZIL
GE GF
GEORGIA RENCH GUIANA
MN MO
TF TG
BS BT BV BW BY
GG GH GI GL GM
GUERNSEY, C.I. GHANA BRALTAR REENLAND GAMBIA
MP MQ MR MS MT
TJ TK TL TM
THAILAND TAJIKISTAN TOKELAU TIMOR LESTE TURKMENISTAN
BA BB
AHAMAS HUTAN OUVET ISLAND BOTSWANA ELARUS OSNIA AND HERZEGOVINA ARBADOS
MONGOLIA MACAU NORTHERN MARIANA ISLANDS MARTINIQUE MAURITANIA MONTSERRAT MALTA
GN GP
MU MV
MAURITIUS MALDIVES
TN TO
TUNISIA TONGA
BD BE
ANGLADESH ELGIUM
GQ GR
GUINEA GUADELOUPE EQUATORIAL GUINEA GREECE
MW MX
MALAWI MEXICO
ST SV SY
SZ
TH
TR TT
SAO TOME AND PRINCIPE EL SALVADOR SYRIAN ARAB REPUBLIC
SWAZILAND TURKS AND CAICOS ISLANDS CHAD FRENCH SOUTHERN TERRITORIES TOGO
TURKEY TRINIDAD AND
Page 72 of 73
Bloomberg Documentation By Rasheed Abad
Master of Finance
Data Download TOBAGO
BF BG
URKINA FASO BULGARIA
GS GT
BH BI BJ BM
AHRAIN RUNDI ENIN BERMUDA
GU GW GY HK
BN BO
RUNEI DARUSSALAM BOLIVIA
BR
S. GEORGIA AND S. SANDWICH ISL. UATEMALA
MY MZ
MALAYSIA MOZAMBIQUE
TV TW
TUVALU TAIWAN TANZANIA, UNITED REPUBLIC OF UKRAINE UGANDA UNITED STATES
NA NC NE NF
NAMIBIA NEW CALEDONIA NIGER NORFOLK ISLAND
TZ UA UG US
HM HN
GUAM GUINEA-BISSAU GUYANA HONG KONG HEARD AND MCDONALD ISLANDS HONDURAS
NG NI
NIGERIA NICARAGUA
UM UZ
RAZIL
HR
CROATIA
NL
NETHERLANDS
VA
BS BT
AHAMAS HUTAN
HT HU
AITI HUNGARY
NO NP
NORWAY NEPAL
VC VE
BV BW BY BZ
OUVET ISLAND BOTSWANA ELARUS ELIZE
ID IE IL IM
INDONESIA IRELAND ISRAEL ISLE OF MAN
NR NU NZ OM
NAURU NIUE NEW ZEALAND OMAN
VG VI VN VU
CA
IN
PA
PANAMA
WF
IO
INDIA BRITISH INDIAN OCEAN TERRITORY
PE
WS
SAMOA
IQ
IRAQ
PF
PERU FRENCH POLYNESIA
YE
YEMEN
IR IS IT
IRAN (ISLAMIC REPUBLIC OF) ICELAND ITALY
PG PH PK
PAPUA NEW GUINEA PHILIPPINES PAKISTAN
YT YU ZA
MAYOTTE YUGOSLAVIA SOUTH AFRICA
CI
ANADA COCOS (KEELING) ISLANDS CONGO, THE DEMOC. REP. OF ENTRAL AFRICAN REPUBLIC CONGO SWITZERLAND TE D'IVOIRE (IVORY COAST)
U.S. MINOR OUTLAYING ISLANDS UZBEKISTAN HOLY SEE (VATICAN CITY STATE) ST. VINCENT AND THE GRENADINES VENEZUELA VIRGIN ISLANDS, BRITISH VIRGIN ISLANDS, U.S. VIETNAM VANUATU WALLIS AND FUTUNA ISLANDS
JE
JERSEY, C.I.
PL
ZM
ZAMBIA
CK CL CM CN CO CR
OOK ISLANDS CHILE CAMEROON CHINA COLOMBIA COSTA RICA
JM JO JP KE KG KH
JAMAICA JORDAN JAPAN KENYA KYRGYZSTAN CAMBODIA
PM PN PR PT PW PY
ZW
ZIMBABWE
CC CD
CF CG CH
POLAND ST. PIERRE AND MIQUELON PITCAIRN PUERTO RICO PORTUGAL PALAU PARAGUAY
Page 73 of 73