Main Content

portfolio

Current portfolio data for Bloomberg B-PIPE connection V3

Description

example

d = portfolio(c,p,f) returns current portfolio data for the fields f in the portfolio p using the bloombergBPIPE object c.

example

d = portfolio(c,p,f,o,ov) returns current portfolio data using override field o and override value ov.

example

[d,plist] = portfolio(___) also returns the portfolio list plist using any of the input argument combinations in the previous syntaxes.

Examples

collapse all

Create a Bloomberg® B-PIPE® connection using the IP address of the machine running the Bloomberg B-PIPE process. This example uses the Bloomberg B-PIPE C++ interface and assumes the following:

  • The authentication is Windows® authentication when you set authtype to 'OS_LOGON'.

  • The application name is blank because you are not connecting to Bloomberg B-PIPE using an application.

  • The IP address for the machine running the Bloomberg B-PIPE process is '111.11.11.112'.

  • The port number of the machine running the Bloomberg B-PIPE process is 8194.

c is a bloombergBPIPE object.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bloombergBPIPE(authtype,appname,ipaddress,port);

Request portfolio data for a custom portfolio with portfolio identifier U335877-1 Client. Request data using all fields f.

p = 'U335877-1 Client';
f = {'PORTFOLIO_MEMBERS','PORTFOLIO_MPOSITION',...
     'PORTFOLIO_MWEIGHT','PORTFOLIO_DATA'};

d = portfolio(c,p,f)
d = 

    PORTFOLIO_MPOSITION: {{0x1 cell}} 
      PORTFOLIO_MWEIGHT: {{0x1 cell}} 
         PORTFOLIO_DATA: {{0x1 cell}} 
      PORTFOLIO_MEMBERS: {{0x1 cell}} 

d is a structure that contains portfolio data. Each structure field corresponds to data for each portfolio field.

Close the connection.

close(c)

Create a Bloomberg B-PIPE connection using the IP address of the machine running the Bloomberg B-PIPE process. This example uses the Bloomberg B-PIPE C++ interface and assumes the following:

  • The authentication is Windows authentication when you set authtype to 'OS_LOGON'.

  • The application name is blank because you are not connecting to Bloomberg B-PIPE using an application.

  • The IP address for the machine running the Bloomberg B-PIPE process is '111.11.11.112'.

  • The port number of the machine running the Bloomberg B-PIPE process is 8194.

c is a bloombergBPIPE object.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bloombergBPIPE(authtype,appname,ipaddress,port);

Request portfolio data for a custom portfolio with portfolio identifier U335877-1 Client. Request data using all fields f. Filter the portfolio data by specifying the date of November 3, 2014 using the override value REFERENCE_DATE equal to 20141103.

p = 'U335877-1 Client';
f = {'PORTFOLIO_MEMBERS','PORTFOLIO_MPOSITION',...
     'PORTFOLIO_MWEIGHT','PORTFOLIO_DATA'};
o = {'REFERENCE_DATE'};
ov = {'20141103'};

[d,plist] = portfolio(c,p,f,o,ov)
d = 

    PORTFOLIO_MPOSITION: {{0x1 cell}} 
      PORTFOLIO_MWEIGHT: {{0x1 cell}} 
         PORTFOLIO_DATA: {{0x1 cell}} 
      PORTFOLIO_MEMBERS: {{0x1 cell}} 

plist = 

    'U335877-1 Client'

d is a structure that contains portfolio data. Each structure field corresponds to data for each portfolio field.

plist is a cell array that contains the portfolio identifier.

Close the connection.

close(c)

Input Arguments

collapse all

Bloomberg B-PIPE connection, specified as a bloombergBPIPE object.

Portfolio, specified as a character vector or string scalar. Specify the portfolio by the ID that you can find in the upper-right corner of the portfolio display page. Append the text ' Client' (without quotes) to the ID. For example, if the ID is U335877-1, then specify 'U335877-1 Client'.

Access the portfolio display page by using the PRTU<GO> option from the Bloomberg terminal. For details, see the Bloomberg API Developer’s Guide using the WAPI <GO> option from the Bloomberg terminal.

Example: 'U335877-1 Client'

Data Types: char | cell | string

Portfolio fields, specified as one of the preceding values for one field. To specify multiple fields, use a cell array of these values.

Bloomberg Field Name

Bloomberg Field Description

'PORTFOLIO_DATA'

Returns a list of the identifiers, positions, market values, cost, cost date, and cost foreign exchange rate of each security in a custom portfolio.

'PORTFOLIO_MEMBERS'

Returns a list of identifiers for the members of a custom portfolio.

'PORTFOLIO_MPOSITION'

Returns a list of identifiers and the position for each security in a custom portfolio.

'PORTFOLIO_MWEIGHT'

Returns a list of identifiers and the percentage weight for each security in a custom portfolio.

Data Types: char | cell

Bloomberg override field, specified as a character vector, string scalar, cell array of character vectors, or string array. The Bloomberg value 'REFERENCE_DATE' denotes returning Bloomberg data for a specific date.

Data Types: char | cell | string

Bloomberg override field value, specified as a character vector, string scalar, cell array of character vectors, or string array. A character vector or string denotes one Bloomberg override field value. A cell array of character vectors or string array denotes multiple Bloomberg override field values. Use this field value to filter the Bloomberg data result set.

Example: '20100101'

Data Types: char | cell | string

Output Arguments

collapse all

Portfolio data, returned as a structure or table. The data type of the portfolio data depends on the DataReturnFormat property of the connection object.

Portfolio list, returned as a cell array of character vectors for the corresponding portfolio identifiers in p. The contents of plist are identical in value and order to p.

Introduced in R2021a