exponenta event banner

getbulkdata

Массовые данные с информацией заголовка для подключения Bloomberg B-PIPE V3

Описание

пример

d = getbulkdata(c,s,f) возвращает групповые данные для полей f для списка безопасности s с использованием bloombergBPIPE объект c с интерфейсом Bloomberg ® B-PIPE ® C++.

пример

d = getbulkdata(c,s,f,o,ov) возвращает групповые данные с помощью полей переопределения o с соответствующими значениями переопределения ov.

пример

d = getbulkdata(c,s,f,o,ov,Name,Value) возвращает массовые данные с дополнительными параметрами, заданными одним или несколькими аргументами пары имя-значение для параметров запроса Bloomberg.

пример

[d,sec] = getbulkdata(___) дополнительно возвращает список безопасности sec используя любую из комбинаций входных аргументов в предыдущих синтаксисах.

Примеры

свернуть все

Создайте соединение Bloomberg B-PIPE, используя IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE. В этом примере используется интерфейс Bloomberg B-PIPE C++ и предполагается следующее:

  • Проверка подлинности - это проверка подлинности Windows ® при установкеauthtype кому 'OS_LOGON'.

  • Имя приложения пустое, так как вы не подключаетесь к Bloomberg B-PIPE с помощью приложения.

  • IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE: '111.11.11.112'.

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE: 8194.

c является bloombergBPIPE объект.

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

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

Верните историю дивидендов для IBM ®.

security = 'IBM US Equity';
field = 'DVD_HIST'; % Dividend history field

[d,sec] = getbulkdata(c,security,field) 
d = 

    DVD_HIST: {{149x7 cell}}

sec = 

    'IBM US Equity'

d - структура с одним полем, содержащая массив ячеек с возвращенными массовыми данными. sec содержит имя безопасности IBM.

Просмотр истории дивидендов со связанными данными заголовка путем вызова поля структуры DVD_HIST. Это поле представляет собой массив ячеек, содержащий один массив ячеек. Массив вложенных ячеек содержит данные истории дивидендов. Доступ к содержимому вложенной ячейки с помощью индексирования массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       735536]    [ 735544]    [     735546]    [      735578]    [         0.95]      'Quarter'           
    [       735445]    [ 735453]    [     735455]    [      735487]    [         0.95]      'Quarter'           
    [       735354]    [ 735362]    [     735364]    [      735395]    [         0.95]      'Quarter'           
    ...

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    ...

Первая строка данных истории дивидендов представляет собой информацию заголовка, описывающую содержимое каждого столбца.

Закройте связь с Bloomberg.

close(c)

Создайте соединение Bloomberg B-PIPE, используя IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE. В этом примере используется интерфейс Bloomberg B-PIPE C++ и предполагается следующее:

  • Проверка подлинности - это проверка подлинности Windows при установке authtype кому 'OS_LOGON'.

  • Имя приложения пустое, так как вы не подключаетесь к Bloomberg B-PIPE с помощью приложения.

  • IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE: '111.11.11.112'.

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE: 8194.

c является bloombergBPIPE объект.

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

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

Возврат истории дивидендов для IBM с датами дивидендов с 1 января 2004 года по 1 января 2005 года.

security = 'IBM US Equity';
field = 'DVD_HIST';                        % Dividend history field
override = {'DVD_START_DT','DVD_END_DT'};  % Dividend start and 
                                           % End dates
overridevalues = {'20040101','20050101'};

[d,sec] = getbulkdata(c,security,field,override,overridevalues)
d = 

    DVD_HIST: {{5x7 cell}}

sec = 

    'IBM US Equity'

d - структура с одним полем, содержащая массив ячеек с возвращенными массовыми данными. sec содержит имя безопасности IBM.

Просмотр истории дивидендов со связанными данными заголовка путем вызова поля структуры DVD_HIST. Это поле представляет собой массив ячеек, содержащий один массив ячеек. Массив вложенных ячеек содержит данные истории дивидендов. Доступ к содержимому вложенной ячейки с помощью индексирования массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       732246]    [ 732259]    [     732261]    [      732291]    [         0.18]      'Quarter'           
    [       732155]    [ 732165]    [     732169]    [      732200]    [         0.18]      'Quarter'           
    [       732064]    [ 732073]    [     732077]    [      732108]    [         0.18]      'Quarter'           
    [       731973]    [ 731983]    [     731987]    [      732016]    [         0.16]      'Quarter'           

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash'

Первая строка данных истории дивидендов представляет собой информацию заголовка, описывающую содержимое каждого столбца.

Закройте связь с Bloomberg.

close(c)

Создайте соединение Bloomberg B-PIPE, используя IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE. В этом примере используется интерфейс Bloomberg B-PIPE C++ и предполагается следующее:

  • Проверка подлинности - это проверка подлинности Windows при установке authtype кому 'OS_LOGON'.

  • Имя приложения пустое, так как вы не подключаетесь к Bloomberg B-PIPE с помощью приложения.

  • IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE: '111.11.11.112'.

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE: 8194.

c является bloombergBPIPE объект.

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

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

Возврат цены закрытия и истории дивидендов для IBM с датами дивидендов с 1 января 2004 года по 1 января 2005 года. Укажите формат возврата данных в виде символьного вектора, задав аргумент пары имя-значение 'returnFormattedValue' кому 'true'.

security = 'IBM US Equity';
fields = {'LAST_PRICE','DVD_HIST'};        % Closing price and 
                                           % Dividend history fields
override = {'DVD_START_DT','DVD_END_DT'};  % Dividend start and 
                                           % End dates
overridevalues = {'20040101','20050101'};

[d,sec] = getbulkdata(c,security,fields,override,overridevalues,...
                      'returnFormattedValue',true)
d = 

      DVD_HIST: {{5x7 cell}}
    LAST_PRICE: {'188.74'}

sec = 

    'IBM US Equity'

d - структура с двумя полями. Первое поле DVD_HIST содержит массив ячеек с разделенными историческими данными в качестве массива ячеек. Второе поле LAST_PRICE содержит массив ячеек с ценой закрытия в виде символьного вектора. sec содержит имя безопасности IBM.

Просмотрите цену закрытия.

d.LAST_PRICE
ans = 

    '188.74'

Просмотр истории дивидендов со связанными данными заголовка путем вызова поля структуры DVD_HIST. Это поле представляет собой массив ячеек, содержащий один массив ячеек. Массив вложенных ячеек содержит данные истории дивидендов. Доступ к содержимому вложенной ячейки с помощью индексирования массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       732246]    [ 732259]    [     732261]    [      732291]    [         0.18]      'Quarter'           
    [       732155]    [ 732165]    [     732169]    [      732200]    [         0.18]      'Quarter'           
    [       732064]    [ 732073]    [     732077]    [      732108]    [         0.18]      'Quarter'           
    [       731973]    [ 731983]    [     731987]    [      732016]    [         0.16]      'Quarter'           

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash'

Первая строка данных истории дивидендов представляет собой информацию заголовка, описывающую содержимое каждого столбца.

Закройте связь с Bloomberg.

close(c)

Создайте подключение Bloomberg, а затем запросите данные истории дивидендов. getbulkdata функция возвращает данные для дат в виде datetime массив.

Создайте соединение Bloomberg B-PIPE, используя IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE. В этом примере используется интерфейс Bloomberg B-PIPE C++ и предполагается следующее:

  • Проверка подлинности - это проверка подлинности Windows при установке authtype кому 'OS_LOGON'.

  • Имя приложения пустое, так как вы не подключаетесь к Bloomberg B-PIPE с помощью приложения.

  • IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE: '111.11.11.112'.

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE: 8194.

c является bloombergBPIPE объект.

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

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

Возврат данных в виде таблицы путем установки параметра DataReturnFormat свойства объекта подключения. Если это свойство не задано, getbulkdata функция возвращает данные в виде структуры.

Даты возврата как datetime путем установки DatetimeType свойства объекта подключения. В этом случае таблица содержит даты в переменных, которые datetime массивы.

c.DataReturnFormat = 'table';
c.DatetimeType = 'datetime';

Верните историю дивидендов для IBM.

s = 'IBM US Equity';
f = 'DVD_HIST'; % Dividend history field

d = getbulkdata(c,s,f);

Отображение первых трех строк таблицы.

d.DVD_HIST{1}(1:3,:)
ans =

  3×7 table

        DeclaredDate              ExmDate                RecordDate             PayableDate         DividendAmount    DividendFrequency     DividendType 
    ____________________    ____________________    ____________________    ____________________    ______________    _________________    ______________

    31-Oct-2017 00:00:00    09-Nov-2017 00:00:00    10-Nov-2017 00:00:00    09-Dec-2017 00:00:00         1.5              'Quarter'        'Regular Cash'
    25-Jul-2017 00:00:00    08-Aug-2017 00:00:00    10-Aug-2017 00:00:00    09-Sep-2017 00:00:00         1.5              'Quarter'        'Regular Cash'
    25-Apr-2017 00:00:00    08-May-2017 00:00:00    10-May-2017 00:00:00    10-Jun-2017 00:00:00         1.5              'Quarter'        'Regular Cash'

Отображение трех объявленных дат. DeclaredDate переменная является datetime массив.

d.DVD_HIST{1}.DeclaredDate(1:3)
ans = 

  3×1 datetime array

   31-Oct-2017 00:00:00
   25-Jul-2017 00:00:00
   25-Apr-2017 00:00:00

Закройте связь с Bloomberg.

close(c)

Входные аргументы

свернуть все

Соединение Bloomberg B-PIPE, указанное как bloombergBPIPE объект.

Список безопасности, заданный как вектор символов или скаляр строки для одной безопасности или массив ячеек из векторов символов или массив строк для нескольких ценных бумаг. Можно указать безопасность по имени или CUSIP, а также с источником цены или без него.

Типы данных: char | cell | string

Поля данных Bloomberg, указанные как вектор символов, скаляр строк, массив ячеек векторов символов или массив строк. Символьный вектор или строка обозначает одно имя поля данных Bloomberg. Массив ячеек из символьных векторов или строкового массива обозначает несколько имен полей данных Bloomberg. Дополнительные сведения о полях, которые можно указать, см. в Руководстве разработчика API Bloomberg с помощью параметра WAPI < GO > на терминале Bloomberg.

Пример: {'LAST_PRICE';'OPEN'}

Типы данных: char | cell | string

Поле переопределения Bloomberg, указанное как вектор символов, скаляр строк, массив ячеек векторов символов или массив строк. Вектор или строка символа обозначает одно имя поля переопределения Bloomberg. Массив ячеек из символьных векторов или строкового массива обозначает несколько имен полей переопределения Bloomberg. Дополнительные сведения о полях, которые можно указать, см. в Руководстве разработчика API Bloomberg с помощью параметра WAPI < GO > на терминале Bloomberg.

Пример: 'END_DT'

Типы данных: char | cell | string

Значение поля переопределения Bloomberg, указанное как вектор символов, скаляр строк, массив ячеек векторов символов или массив строк. Вектор или строка символа обозначает одно значение поля переопределения Bloomberg. Массив ячеек из символьных векторов или строкового массива обозначает несколько значений поля переопределения Bloomberg. Используйте это значение поля для фильтрации результирующего набора данных Bloomberg.

Пример: '20100101'

Типы данных: char | cell | string

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'returnFormattedValue',true

Идентификаторы прав, указанные как пара, разделенная запятыми, состоящая из 'returnEids' и логическое. true добавляет имя и значение для даты идентификатора права доступа (EID) к возвращаемым данным.

Типы данных: logical

Возвращаемый формат, заданный как разделенная запятыми пара, состоящая из 'returnFormattedValue' и логическое. true принудительно возвращает все данные в виде символьного вектора типа данных.

Типы данных: logical

Формат даты и времени, указанный как пара, разделенная запятыми, состоящая из 'useUTCTime' и логическое. true возвращает значения даты и времени как Скоординированное универсальное время (UTC) и false по умолчанию используется настройка Bloomberg TZDF < GO > запрашивающей стороны.

Типы данных: logical

Последние справочные данные, указанные как пара, разделенная запятыми, состоящая из 'forcedDelay' и логическое. true возвращает последние данные до периода задержки, указанного биржей для обеспечения безопасности.

Типы данных: logical

Выходные аргументы

свернуть все

Данные Bloomberg, возвращенные в виде структуры, таблицы или расписания. Тип данных Bloomberg зависит от свойств DataReturnFormat и DatedType объекта подключения. Дополнительные сведения об этих данных см. в Руководстве разработчика API Bloomberg с использованием параметра WAPI < GO > на терминале Bloomberg.

Список безопасности, возвращаемый в виде массива ячеек векторов символов для соответствующих ценных бумаг в s. Содержание sec идентичны по значению и порядку s. Можно вернуть ценные бумаги с любым из следующих идентификаторов:

  • buid

  • cats

  • cins

  • common

  • cusip

  • isin

  • sedol1

  • sedol2

  • sicovam

  • svm

  • ticker (по умолчанию)

  • wpk

Представлен в R2021a