blpsrv
Bloomberg Server connection V3
Description
The blpsrv
function creates a blpsrv
object. The blpsrv
object represents a Bloomberg® Server connection.
Other functions connect to different Bloomberg services: Bloomberg Desktop (blp
), and Bloomberg
B-PIPE® (bpipe
). For details about these
services, see Comparing Bloomberg Connections.
For details about Bloomberg connection requirements, see Data Server Connection Requirements. To ensure a successful Bloomberg connection, perform the required steps before executing
blpsrv
. For details, see Installing Bloomberg and Configuring Connections.
Creation
Syntax
Description
c = blpsrv(uuid,ipaddress,port,timeout)
also sets the
TimeOut property.
Caution
To refer to a Bloomberg connection in other functions, use the connection object
created by the blpsrv
function. Otherwise, using
blpsrv
as an input argument opens multiple
Bloomberg connections, causing unexpected behavior and exhausting
memory resources.
Properties
Uuid
— Bloomberg user identity UUID
numeric scalar
Bloomberg user identity UUID, specified as a numeric scalar. To find
your UUID, enter IAM
in the Bloomberg terminal and press GO.
Example: 12345678
Data Types: double
User
— Bloomberg user
Bloomberg user identity object
This property is read-only.
Bloomberg user, specified as a Bloomberg user identity object.
Example: [1x1
com.bloomberglp.blpapi.impl.aT]
Userip
— IP address of the machine running MATLAB®
character vector
This property is read-only.
IP address of the machine running MATLAB, specified as a character vector.
Example:
'111.11.11.111'
Data Types: char
Session
— Bloomberg V3 session
Bloomberg V3 API Session object
This property is read-only.
Bloomberg V3 session, specified as a Bloomberg V3 API Session object.
Example: [1x1 com.bloomberglp.blpapi.Session]
IPAddress
— Bloomberg Server IP address
character vector | string scalar
Bloomberg Server IP address, specified as a character vector or string scalar that identifies the machine running the Bloomberg Server.
Example: '111.11.11.111'
Data Types: char
| string
Port
— Port number
numeric scalar
Port number, specified as a numeric scalar that identifies the port number of the machine running the Bloomberg Server.
Example: 8194
Data Types: double
TimeOut
— Timeout
numeric scalar
Timeout specifying the time in milliseconds that MATLAB attempts to connect to the machine running the Bloomberg Server before timing out, specified as a numeric scalar.
Example: 10
Data Types: double
DatetimeType
— Date and time data type
''
(default) | 'datetime'
Date and time data type, specified as one of these values.
Value | Description |
---|---|
'' (default) | Return date and time values as MATLAB date numbers. |
'datetime' | Return date and time values as a datetime
array. |
You can specify these values using a character vector or string (for example,
"datetime"
).
When you create a blpsrv
object, the
blpsrv
function leaves this property unset. To retrieve
data, you must set this property value manually at the command line or in a script using
dot notation, for example:
c.DatetimeType = 'datetime';
Note
If the
DataReturnFormat
property value is'table'
and theDatetimeType
property value is'datetime'
, then the returned data is a table that contains date and time values as adatetime
array. If theDataReturnFormat
property value is an empty character vector, then setting theDatetimeType
property to'datetime'
returns date and time values for aggregated ticks and historical requests as MATLAB date numbers.
DataReturnFormat
— Data return format
'cell'
| 'structure'
| 'table'
| 'timetable'
Data return format, specified as one of these values, which determine the data type of the returned data.
Value | Data Type of Returned Data |
---|---|
'cell' | cell array |
'table' | table |
'timetable' | timetable |
'structure' | structure |
Note
The default data type of the returned data depends on the executed function.
To specify the default data type, set the DataReturnFormat
property to ''
. For default data types, see the supported
function list.
You can specify these values using a character vector or string (for example,
"table"
).
When you create a blpsrv
object, the
blpsrv
function leaves this property unset. To retrieve
data, you must set this property value manually at the command line or in a script using
dot notation, for example:
c.DataReturnFormat = 'structure';
Supported Function | Valid Data Types for Returned Data |
---|---|
category |
|
eqs |
|
fieldinfo |
|
fieldsearch |
|
lookup |
|
portfolio |
|
getbulkdata |
|
getdata |
|
history |
|
tahistory |
|
timeseries |
|
Note
Regardless of the DatetimeType
property value, if the
DataReturnFormat
property value is
'timetable'
, then the getdata
and
getbulkdata
functions return a table that contains date and
time values as datetime
arrays.
Object Functions
Bloomberg Server Connection
close | Close Bloomberg connection V3 |
get | Properties of Bloomberg connection V3 |
isconnection | Determine Bloomberg connection V3 |
Bloomberg Server Data Retrieval
eqs | Equity screening data for Bloomberg connection V3 |
getbulkdata | Bulk data with header information for Bloomberg connection V3 |
getdata | Current data for Bloomberg connection V3 |
history | Historical data for Bloomberg connection V3 |
portfolio | Current portfolio data for Bloomberg connection V3 |
realtime | Real-time data for Bloomberg connection V3 |
stop | Unsubscribe real-time requests for Bloomberg connection V3 |
tahistory | Historical technical analysis for Bloomberg connection V3 |
timeseries | Intraday tick data for Bloomberg connection V3 |
Bloomberg Server Data Information
category | Field category search for Bloomberg connection V3 |
fieldinfo | Field information for Bloomberg connection V3 |
fieldsearch | Field search for Bloomberg connection V3 |
lookup | Find information about securities for Bloomberg connection V3 |
Examples
Connect to Bloomberg Server
Connect to the Bloomberg Server using the IP address of the machine running the Bloomberg Server. This example assumes the following:
The Bloomberg UUID is
12345678
.The IP address for the machine running the Bloomberg Server is
'111.11.11.111'
.
uuid = 12345678;
ipaddress = '111.11.11.111';
c = blpsrv(uuid,ipaddress)
c = blpsrv with properties: Uuid: 12345678 User: [1x1 com.bloomberglp.blpapi.impl.aT] Userip: '111.11.11.112' Session: [1x1 com.bloomberglp.blpapi.Session] IPAddress: '111.11.11.111' Port: 8194 TimeOut: 0 DatetimeType: '' DataReturnFormat: ''
blpsrv
connects to the machine running the Bloomberg Server using the default port number 8194
.
blpsrv
creates the Bloomberg Server connection object c
with these properties:
Bloomberg user identity UUID
Bloomberg user identity object
IP address of the machine running MATLAB
Bloomberg V3 API Session object
IP address of the machine running the Bloomberg Server
Port number of the machine running the Bloomberg Server
Number in milliseconds specifying how long MATLAB attempts to connect to the machine running the Bloomberg Server before timing out
Date and time data type
Data return format
Request the last and open prices for Microsoft®.
format bank % Display data format for currency s = 'MSFT US Equity'; f = {'LAST_PRICE';'OPEN'}; [d,sec] = getdata(c,s,f)
d = LAST_PRICE: 33.34 OPEN: 33.60 sec = 'MSFT US Equity'
getdata
returns a
structure d
with the last and open prices. Also,
getdata
returns the name of the security in
sec
.
Close the Bloomberg Server connection.
close(c)
Connect to Bloomberg Server with Port Number
Connect to the Bloomberg Server using the IP address of the machine running the Bloomberg Server. This example assumes the following:
The Bloomberg UUID is
12345678
.The IP address for the machine running the Bloomberg Server is
'111.11.11.111'
.The port number of the machine running the Bloomberg Server is
8194
.
uuid = 12345678;
ipaddress = '111.11.11.111';
port = 8194;
c = blpsrv(uuid,ipaddress,port)
c = blpsrv with properties: Uuid: 12345678 User: [1x1 com.bloomberglp.blpapi.impl.aT] Userip: '111.11.11.112' Session: [1x1 com.bloomberglp.blpapi.Session] IPAddress: '111.11.11.111' Port: 8194 TimeOut: 0 DatetimeType: '' DataReturnFormat: ''
blpsrv
connects to the machine running the Bloomberg Server using the port number 8194
and
creates the Bloomberg Server connection object c
with these properties:
Bloomberg user identity UUID
Bloomberg user identity object
IP address of the machine running MATLAB
Bloomberg V3 API Session object
IP address of the machine running the Bloomberg Server
Port number of the machine running the Bloomberg Server
Number in milliseconds specifying how long MATLAB attempts to connect to the machine running the Bloomberg Server before timing out
Date and time data type
Data return format
Request the last and open prices for Microsoft.
format bank % Display data format for currency s = 'MSFT US Equity'; f = {'LAST_PRICE';'OPEN'}; [d,sec] = getdata(c,s,f)
d = LAST_PRICE: 33.34 OPEN: 33.60 sec = 'MSFT US Equity'
getdata
returns a
structure d
with the last and open prices. Also,
getdata
returns the name of the security in
sec
.
Close the Bloomberg Server connection.
close(c)
Connect to Bloomberg Server with Timeout
Connect to the Bloomberg Server using the IP address of the machine running the Bloomberg Server. This example assumes the following:
The Bloomberg UUID is
12345678
.The IP address for the machine running the Bloomberg Server is
'111.11.11.111'
.The port number of the machine running the Bloomberg Server is your default port number.
The timeout value is 10 milliseconds.
uuid = 12345678;
ipaddress = '111.11.11.111';
port = [];
timeout = 10;
c = blpsrv(uuid,ipaddress,port,timeout)
c = blpsrv with properties: Uuid: 12345678 User: [1x1 com.bloomberglp.blpapi.impl.aT] Userip: '111.11.11.112' Session: [1x1 com.bloomberglp.blpapi.Session] IPAddress: '111.11.11.111' Port: 8194 TimeOut: 10 DatetimeType: '' DataReturnFormat: ''
blpsrv
connects to the machine running the Bloomberg Server using the default port number 8194
and a timeout value of 10 milliseconds. blpsrv
creates
the Bloomberg Server connection object c
with these properties:
Bloomberg user identity UUID
Bloomberg user identity object
IP address of the machine running MATLAB
Bloomberg V3 API Session object
IP address of the machine running the Bloomberg Server
Port number of the machine running the Bloomberg Server
Number in milliseconds specifying how long MATLAB attempts to connect to the machine running the Bloomberg Server before timing out
Date and time data type
Data return format
Request the last and open prices for Microsoft.
format bank % Display data format for currency s = 'MSFT US Equity'; f = {'LAST_PRICE';'OPEN'}; [d,sec] = getdata(c,s,f)
d = LAST_PRICE: 33.34 OPEN: 33.60 sec = 'MSFT US Equity'
getdata
returns a
structure d
with the last and open prices. Also,
getdata
returns the name of the security in
sec
.
Close the Bloomberg Server connection.
close(c)
Version History
Introduced in R2014b
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)