Professional Documents
Culture Documents
Data License - SFTP, DLWS - Welcome Documents
Data License - SFTP, DLWS - Welcome Documents
Table of Contents
Bloomberg Enterprise Data – CSC Registration ....................................................................3
For new users who do not have a CSC Login .................................................................3
For users who already have an existing CSC Login........................................................5
Data License (Master Data): Request and Response Mechanism .........................................6
SFTP and Web services .................................................................................................6
Bloomberg Enterprise Access Point (BEAP) ...................................................................6
Request File Format ..............................................................................................................7
Data License Request File (.req file) ...............................................................................7
Bloomberg Enterprise Data – FAQs.....................................................................................11
What are the differences among the various Request Operation Mode
(PROGRAMFLAG)? .....................................................................................................11
How to specify a pricing source for individual instruments or for an entire request file? 11
How to link a DL account to BLOOMBERG terminal in order to take advantage of
personal defaults? ........................................................................................................11
What do the return codes or return values (N.S. / N.D.) mean? ....................................11
How can I access ratings data on Data License? .........................................................12
Best Practices .....................................................................................................................12
Utilize headers TIME and RUNDATE to schedule files .................................................12
Utilize Program “scheduled” to return all files that are scheduled on account ............... 12
Editing Scheduled Requests.........................................................................................13
Customer Service Center – Support resources....................................................................13
Access to Request Builder Training Videos ..................................................................13
Frequently Asked Questions (FAQs) ............................................................................14
Submitting an Inquiry to Bloomberg Enterprise Data CSC Web Portal..........................14
Bloomberg Enterprise Data
4) Under Product Information, choose Data License Account # as Account Type, and enter
the Data License account number (numbers only; Omit “DL”). Click “Submit” to complete the
registration. If you do not know your Data License Account Number, please contact your
Account Manager.
Bloomberg Enterprise Data
Follow the steps below to add the DL Account to your existing CSC Profile:
1) Go to https://service.bloomberg.com/ and Login to CSC website.
2) Click and Select “My Profile” on the top-right hand corner of the screen
Customers can form a request to meet their information needs, and submit it to Bloomberg
through a variety of methods, including Bloomberg Enterprise Access Point (BEAP website),
SFTP and Web Services. Bloomberg processes these requests and sends a response
containing the requested data values.
• All data requests are to be submitted to Bloomberg with a header, security and fields
format. Files will not run if the format is inaccurate.
Section Definition
• This section contains pertinent information that identifies the customer, the type of
request to run, the time to run the request, and other options that are detailed in the
referenced DL Guide. The order of the headers do not matter.
• The full list of file headers available and explanation for each header option can be
found in the corresponding sub-sections within the referenced section in the DL
Guide.
• The Fields section may or may not be needed in a request, depending upon the
program being run by the client. Fields section is mandatory for getdata or gethistory
requests.
Bloomberg Enterprise Data
• List of fields is used to specify the fields that will be retrieved in response to this Per
Security request.
• The list of fields must be after the header and before the list of securities. A
maximum of 500 fields can be specified in any request.
• The Data Dictionary (fields.csv) contains the universe of fields available to Per
Security Users. This file can be found on the CSC Portal under “Documentation” ->
“Data License Documentation” -> Data Dictionary (Fields.csv). Refer to Column AD
in the Data Dictionary (fields.csv) for identifying the corresponding data category of
each data field mnemonic.
START-OF-FIELDS
NAME
ID_BB_GLOBAL Example: The data license category of field EQY_BETA is
ID_BB_UNIQUE “Derived - End of Day”. In order to obtain the EQY_BETA data on
COUNTRY response file, the request file should include the header line
EQY_SH_OUT DERIVED=yes. Otherwise, the data field will return N.S. (Not
EQY_SH_OUT_DT Subscribed).
CRNCY
PX_LAST
VOLUME_AVG_30D
EQY_BETA
EPS_GROWTH
SALES_REV_TURN
END-OF-FIELDS
• This section will be where you list the securities to be requested. The identifiers are
inserted between section tags START-OF-DATA and END-OF-DATA .
• The list of securities must be after the list of fields. There may only be one security
identifier per line.
• Yellow Key is case sensitive and it should be in mixed Case, such as “Equity”,
“Corp”, “Index” etc. “equity” or “EQUITY” will not be recognized.
WRONG CORRECT
IBM US equity IBM US Equity
AUD curncy AUD Curncy
AV9074619 corp AV9074619 Corp
Format Example:
START-OF-DATA
INTC US Equity
EQ0010172900001000|BB_UNIQUE| --------------- Specifying this as a ID_BB_UNIQUE identifier
44932HAK9|CUSIP|--------------------------------------- Specifying this as a CUSIP identifier
US44932HAK95|ISIN|------------------------------------ Specifying this as an ISIN identifier
BBG00MNY1DJ1|BB_GLOBAL|----------------------- Specifying this as an ID_BB_GLOBAL identifier
END-OF-DATA
Clients can refer to below section for the Program flag values description:
REFERENCE: DL Guide Section - Request Operation Mode
https://service.bloomberg.com/track_download/assets/data-license/#Per-Security-Request-Operation-Mode
Clients whose firms subscribe to the BLOOMBERG PROFESSIONAL service have the
option of linking their data license account to their BLOOMBERG terminal to take advantage
of personal defaults. This can be hard-coded for a permanent link by contacting our technical
support desk, or this can be done on a case-by-case basis by amending the request file
header. Please refer to REFERENCE: DL Guide Section - Links to a Bloomberg Terminal
https://service.bloomberg.com/track_download/assets/data-license/#Per-Security-Links-to-a-Bloomberg-Terminal
for the details.
Please also refer to the below sections for the list of return codes supported for getdata and
their respective meanings:
REFERENCE: DL Guide Section - Return Codes
https://service.bloomberg.com/track_download/assets/data-license/#Per-Security-Program-Names-getdata-
Return-Codes
It is possible to get a good return code, but data for one or more fields did not been returned.
Reason Codes and Reasons for fields not being populated can be found below:
REFERENCE: DL Guide Section - Data not returned
https://service.bloomberg.com/track_download/assets/data-license/#Per-Security-Program-Names-getdata-Data-
not-returned
Best Practices
Utilize headers TIME and RUNDATE to schedule files
REFERENCE: Best Practices - Time and Date
https://service.bloomberg.com/track_download/assets/data-license/#Per-Security-Best-Practices-Time-and-Date
When scheduling files, the TIME and RUNDATE headers should be utilized to set a specific
time and date. Scheduled files without the TIME header will default to run at midnight; heavy
load at this time may cause response delays. Time is set according to the timezone of the
account’s sales region: TO/LO/NY .
START-OF-FILE
FIRMNAME=dl123456
REPLYFILENAME=scheduled.out
PROGRAMNAME=scheduled
Bloomberg Enterprise Data
END-OF-FILE
If there are no scheduled requests found under the account (of any frequency), the response
will return No scheduled nightly requests found. To cancel unwanted scheduled requests,
program “cancel” or “cancel_all” can be used. Please refer to the two sections:
REFERENCE: Cancel
https://service.bloomberg.com/track_download/assets/data-license/#Per-Security-Program-Names-cancel &
REFERENCE: Cancel_all
https://service.bloomberg.com/track_download/assets/data-license/#Per-Security-Program-Names-cancel-all
To edit securities or fields in a scheduled request, the client must send another request,
listing new securities or fields under the same REPLYFILENAME as the original response. A
request with a different REPLYFILENAME will be treated as a new scheduled response and
the original will continue to run without changes.
Training videos in English and other languages are also located in the Data License Guide
REFERENCE: Request Builder - Training Videos
https://service.bloomberg.com/track_download/assets/data-license/#Request-Builder-Request-Builder-Training-
Videos
Bloomberg Enterprise Data
3) The “Create Ticket” screen will appear. Select Type as “Data License”, enter a brief
description of your inquiry in the Summary box and type in your question in the Note box.
Bloomberg Enterprise Data
4) Select the Data License Account, attach relevant Data License files and fill out the
Contact Phone and Emails. If you wish to have any of your colleagues subscribed to your
inquiry, simply add their email address in the Subscribe E-mails box at the bottom of the
page, separated by commas.
Click Submit and your inquiry will be sent to one of our Enterprise Data Customer Support
representatives.
Disclaimer
The BLOOMBERG TERMINAL service and Bloomberg data products (the “Services”) are owned and distributed by Bloomberg Finance L.P. (“BFLP”) except that Bloomberg L.P. and its subsidiaries (“BLP”)
distribute these products in Argentina, Australia and certain jurisdictions in the Pacific islands, Bermuda, China, India, Japan, Korea and New Zealand. BLP provides BFLP with global marketing and
operational support. The following are trademarks and service marks of BFLP, a Delaware limited partnership, or its subsidiaries: BLOOMBERG, BLOOMBERG ANYWHERE, BLOOMBERG MARKETS,
BLOOMBERG NEWS, BLOOMBERG PROFESSIONAL, BLOOMBERG TERMINAL and BLOOMBERG.COM. Absence of any trademark or service mark from this list does not waive Bloomberg's intellectual
property rights in that name, mark or logo. All rights reserved.
Methods for Data License access
There are two methods for requesting data from Bloomberg: SFTP and Web Services.
SFTP – Secure File Transfer Protocol, SFTP, is a network protocol that provides file access, file transfer, and
file management functionalities over any reliable data stream. SFTP is available over the Internet and
Dedicated Line using routers.
Web Services – Web Services provides a programmatic interface to submit and retrieve messages to and
from our servers. Bloomberg will provide a certificate for authentication to our network. Additionally, Bloomberg
will provide sample code written in Java and .Net to assist with the client’s API. Web Services is available over
the Internet only and does not encrypt files.
SFTP Whitelist
You will need to provide Bloomberg a list of IPs that you will be connecting to the DL SFTP site from to allow
access. 6 or more /24 CIDR ranges or unique IP address will require authentication by SSH key. Bloomberg
supports “OpenSSH” version 2 keys with a minimum of 2048bits. Clients must generate the public/private keys.
The public keys(s) should be provided to Bloomberg. The private key will be kept by the client and used for
authentication and should NOT be provided to Bloomberg. Multiple SSH keys can be configured for the same
account to support multiple environments.
• IBM AIX
Requirement Description
JDK 1.5 JVM (for Java) Java based clients must install the latest JVM that is distributed with JDK1.5.
Toolkit for Web Install a toolkit for use in development of client applications
Services Development
Client Development A client application must be developed using the contract defined by the WSDL
https://service.bloomberg.com/assets/dl/dlws.wsdl
Security certificate Install the certificate keystore which is a binary file provided by Bloomberg, at a
keystore known directory
Documentation
Create a login for https://service.bloomberg.com/
Log in with username and password
Select “Documentation” Menu option
Select “Data License Guide” from dropdown
- or, go directly to -
https://service.bloomberg.com/documents/dlguide/data-license/
Contacts - Please provide details of personnel from your firm who should be involved during the technical setup
of the account.
Role Name Number Email
Account Owner
Applications - Please provide details of the application(s) that will consume the data.
Connectivity - Please provide a list of all IPs that will need to be added to the whitelist.
PURPOSE
To ensure the ongoing security of client and other confidential data, Bloomberg is enhancing its
authentication requirements for the file transfer processing. As of June 30, 2016, Bloomberg will require
SFTP accounts to use SSH keys and/or to upgrade to 16-character, complex passwords in cases where
a password is permitted. Bloomberg realizes that yesterday’s mitigation solutions are no longer strong or
complex enough to keep risks at bay. As a result, Bloomberg has decided to strengthen its security
posture by implementing industry best practices to ensure customers’ business data is kept
uncompromised.
Henceforth, the new requirement for passwords will be alphanumeric sixteen characters in length to
increase complexity. What this means is it will take more work for a malicious attacker to decipher the
password to access an account.
Moreover, a stronger asymmetric cryptographic key pair (private and public) with SFTP will add another
robust layer of security for authentication. Key pairs will be mandatory in some cases where the number
of whitelisted IP ranges exceed the maximum requirement. To be specific, the new requirements for SSH
Key Pairs are as follows:
Note: 6 or more CIDR ranges or unique IP address will require authentication by SSH
key and Password will be disabled
ACTION
Password
To upgrade your password to meet the new requirement, contact the Bloomberg Customer Support Line
to obtain your newly generated password via email and to schedule its activation.
The 16-character passwords will have a complex configuration; including upper and lower case letters,
numbers, and special characters and will reset every 18 months.
The Customer account rep will coordinate a date and time of your choosing to activate the password into
your production environment. In the event that you experience any challenges, your legacy password can
be reverted.
1. Putty/Psftp
2. OpenSSH suite (UNIX)
Linux:
1. Open CLI.
2. Type “ssh-keygen -t rsa” (length size is 2048bits by default).
3. Enter filename in which to save the key at location - /home/demo/.ssh/id_rsa.pub.
4. Enter passphrase or Leave empty for no passphrase.
5. Press Enter to continue.
6. Locate your pub file in /home/demo/.ssh/id_rsa.pub
Windows:
1. Download and Launch PuttyGen
2. Make sure that Type of Key to generate is SSH-2 RSA and Number of bits in a generated key is
2048
3. Press the Generate button to generate the key.
4. Once you have generated the key, select Comment Field to enter your identification comment.
5. In the Comment Field, enter your Groupname@Company
6. Press the Save private Key and Save public Key buttons.
7. Submit public key to Bloomberg for implementation.
https://winscp.net/eng/docs/ui_puttygen
The above are two methods of many possible that can be used to generate SSH keys. Bloomberg does
not endorse the approaches above. We strongly advise you consult with your IT Security Team and
security policy experts and follow their guidance on SSH key generation.