bloombergServer

Подключение к серверу Bloomberg V3

Описание

bloombergServer функция создает bloombergServer объект. The bloombergServer объект представляет Bloomberg® Подключение к серверу с помощью Bloomberg V3 C++ API.

Другие функции подключаются к различным сервисам Bloomberg: Bloomberg Desktop (bloomberg) и Bloomberg B-PIPE® (bloombergBPIPE). Для получения дополнительной информации об этих услугах смотрите Сравнение подключений Bloomberg.

Для получения дополнительной информации о требованиях к соединению с Bloomberg см. раздел «Требования к соединению с сервером данных». Чтобы обеспечить успешное подключение Bloomberg, выполните необходимые шаги перед выполнением bloombergServer. Для получения дополнительной информации см. раздел Установка Bloomberg и Настройка подключений.

Создание

Описание

пример

c = bloombergServer(uuid,ipaddress) создает объект подключения Bloomberg Server c на сервере Bloomberg Server, работающем на другом компьютере, и устанавливает свойства Uuid и IPAddress. Вам нужна лицензия на программное обеспечение Bloomberg Server для компьютера, работающего под управлением Bloomberg Server.

пример

c = bloombergServer(uuid,ipaddress,port) также устанавливает свойство Port.

пример

c = bloombergServer(uuid,ipaddress,port,timeout) также устанавливает свойство TimeOut.

Внимание:

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

Свойства

расширить все

Пользователь Bloomberg тождеств UUID, указанный как числовой скаляр. Чтобы найти свой UUID, введите IAM в терминале Bloomberg и нажмите GO.

Пример: 12345678

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

Это свойство доступно только для чтения.

Пользователь Bloomberg, заданный как объект тождеств личности пользователя Bloomberg.

Пример: [1x1 com.bloomberglp.blpapi.impl.aT]

Это свойство доступно только для чтения.

IP-адрес машины, работающей под управлением MATLAB, задается в виде вектора символов.

Пример: '111.11.11.111'

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

Это свойство доступно только для чтения.

Bloomberg V3 сеанс, заданная как объект Bloomberg V3 API Session.

Пример: [1x1 BLPSession]

IP-адрес сервера Bloomberg, заданный как вектор символов или строковый скаляр, идентифицирующий компьютер, на котором работает сервер Bloomberg.

Пример: '111.11.11.111'

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

Номер порта, заданный как числовой скаляр, который идентифицирует номер порта машины, работающей под управлением Bloomberg Server.

Пример: 8194

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

Тайм-аут, задающий время в миллисекундах, в течение которого MATLAB пытается подключиться к машине, на которой работает сервер Bloomberg, перед истечением времени ожидания, задается как числовой скаляр.

Пример: 10

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

Тип данных даты и времени, заданный в качестве одного из следующих значений.

ЗначениеОписание
'' (по умолчанию)Возвращает значения даты и времени в виде номеров дат MATLAB.
'datetime'Возврат значений даты и времени в виде datetime массив.

Можно задать эти значения с помощью вектора символов или строки (для примера, "datetime").

Когда вы создаете bloombergServer объект, bloombergServer функция оставляет это свойство unset. Чтобы получить данные, вы должны задать это значение свойства вручную в командной строке или в скрипте с использованием записи через точку, например:

c.DatetimeType = 'datetime';
Затем можно использовать следующие поддерживаемые функции:

  • getbulkdata

  • getdata

  • история

  • tahistory

  • timeseries

    Примечание

    Если на DataReturnFormat значение свойства 'table' и DatetimeType значение свойства 'datetime', затем возвращенные данные являются таблицей, которая содержит значения даты и времени как datetime массив. Если на DataReturnFormat значение свойства является пустым символьным вектором, затем задается значение DatetimeType свойство к 'datetime' возвращает значения дат и времени для агрегированных тактов и исторических запросов в виде номеров дат MATLAB.

Формат возврата данных, заданный в качестве одного из следующих значений, которые определяют тип данных возвращенных данных.

ЗначениеТип данных возвращенных данных
'cell'cell array
'table'table
'timetable'timetable
'structure'structure

Примечание

Тип данных по умолчанию возвращаемых данных зависит от выполняемой функции. Чтобы задать тип данных по умолчанию, установите DataReturnFormat свойство к ''. Типы данных по умолчанию см. в списке поддерживаемых функций.

Можно задать эти значения с помощью вектора символов или строки (для примера, "table").

Когда вы создаете bloombergServer объект, bloombergServer функция оставляет это свойство unset. Чтобы получить данные, вы должны задать это значение свойства вручную в командной строке или в скрипте с использованием записи через точку, например:

c.DataReturnFormat = 'structure';
Затем можно использовать эти поддерживаемые функции.

Поддерживаемая функцияДопустимые типы данных для возвращенных данных
категория
  • cell array (по умолчанию)

  • structure

  • table

eqs
  • cell array (по умолчанию)

  • structure

  • table

fieldinfo
  • cell array (по умолчанию)

  • structure

  • table

fieldsearch
  • cell array (по умолчанию)

  • structure

  • table

поиск
  • structure (по умолчанию)

  • table

портфель
  • structure (по умолчанию)

  • table

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

  • table

  • timetable

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

  • table

  • timetable

история
  • числовой массив (по умолчанию)

  • table

  • timetable

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

  • table

  • timetable

timeseries
  • cell array (по умолчанию для необработанных данных такта)

  • числовой массив (по умолчанию для интервала такта данных)

  • table

  • timetable

Примечание

Независимо от DatetimeType значение свойства, если DataReturnFormat значение свойства 'timetable', затем getdata и getbulkdata функции возвращают таблицу, которая содержит значения даты и времени следующим datetime массивы.

Функции объекта

расширить все

closeЗакройте подключение к Bloomberg Server V3
isconnectionОпределите подключение к серверу Bloomberg V3
eqsДанные фильтрации акций для подключения к Bloomberg Server V3
getСвойства подключения к Bloomberg Server V3
getbulkdataМассовые данные с информацией о заголовках для подключения к Bloomberg Server V3
getdataТекущие данные для подключения к Bloomberg Server V3
historyИсторические данные для подключения к Bloomberg Server V3
portfolioТекущие данные портфеля для подключения к Bloomberg Server V3
realtimeДанные в реальном времени для подключения к Bloomberg Server V3
tahistoryИсторический технический анализ для подключения к Bloomberg Server V3
timeseriesВнутридневные данные такты для подключения к Bloomberg Server V3
categoryПоиск по категории полей для подключения к Bloomberg Server V3
fieldinfoСведения о полях для подключения к Bloomberg Server V3
fieldsearchПоиск по полям для подключения к Bloomberg Server V3
lookupНайти информацию о ценных бумагах для подключения к Bloomberg Server V3

Примеры

свернуть все

Подключитесь к Серверу Bloomberg с помощью IP-адреса компьютера, на котором работает Сервер Bloomberg. Этот пример использует интерфейс Bloomberg Server C++ и принимает следующее:

  • Bloomberg UUID 12345678.

  • IP-адрес компьютера, на котором работает сервер Bloomberg '111.11.11.111'.

uuid = 12345678;
ipaddress = '111.11.11.111';

c = bloombergServer(uuid,ipaddress)
c = 

  bloombergServer with properties:

                Uuid: 12345678
                User: []
              Userip: '111.11.11.112'
             Session: [1×1 BLPSession]
           IPAddress: '111.11.11.111'
                Port: 8194
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

bloombergServer функция соединяется с машиной, на которой работает Bloomberg Server, используя номер порта по умолчанию 8194. bloombergServer функция создает bloombergServer c объекта со следующими свойствами:

  • Пользователь Bloomberg тождеств UUID

  • Тождества пользователя Bloomberg

  • IP-адрес машины, работающей под MATLAB

  • Объект Bloomberg V3 API Session

  • IP-адрес компьютера, на котором работает Bloomberg Server

  • Номер порта машины, на которой работает сервер Bloomberg

  • Число в миллисекундах, указывающее, как долго MATLAB пытается подключиться к машине, работающей на сервере Bloomberg Server, перед истечением времени ожидания

  • Тип данных даты и времени

  • Формат возврата данных

Запросить последнюю и открытую цену для 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 возвращает структуру d с последней и открытой ценой. Также, getdata возвращает значение безопасности в sec.

Закройте подключение к Bloomberg Server.

close(c)

Подключитесь к Серверу Bloomberg с помощью IP-адреса компьютера, на котором работает Сервер Bloomberg. Этот пример использует интерфейс Bloomberg Server C++ и принимает следующее:

  • Bloomberg UUID 12345678.

  • IP-адрес компьютера, на котором работает сервер Bloomberg '111.11.11.111'.

  • Номер порта машины, на которой работает сервер Bloomberg 8194.

uuid = 12345678;
ipaddress = '111.11.11.111';
port = 8194;

c = bloombergServer(uuid,ipaddress,port)
c = 

  bloombergServer with properties:

                Uuid: 12345678
                User: []
              Userip: '111.11.11.112'
             Session: [1×1 BLPSession]
           IPAddress: '111.11.11.111'
                Port: 8194
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

bloombergServer функция соединяется с машиной, на которой работает Bloomberg Server, используя номер порта 8194 и создает bloombergServer c объекта со следующими свойствами:

  • Пользователь Bloomberg тождеств UUID

  • Тождества пользователя Bloomberg

  • IP-адрес машины, работающей под MATLAB

  • Объект Bloomberg V3 API Session

  • IP-адрес компьютера, на котором работает Bloomberg Server

  • Номер порта машины, на которой работает сервер Bloomberg

  • Число в миллисекундах, указывающее, как долго MATLAB пытается подключиться к машине, работающей на сервере Bloomberg Server, перед истечением времени ожидания

  • Тип данных даты и времени

  • Формат возврата данных

Запросить последнюю и открытую цену для 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 возвращает структуру d с последней и открытой ценой. Также, getdata возвращает значение безопасности в sec.

Закройте подключение к Bloomberg Server.

close(c)

Подключитесь к Серверу Bloomberg с помощью IP-адреса компьютера, на котором работает Сервер Bloomberg. Этот пример использует интерфейс Bloomberg Server C++ и принимает следующее:

  • Bloomberg UUID 12345678.

  • IP-адрес компьютера, на котором работает сервер Bloomberg '111.11.11.111'.

  • Номер порта компьютера, на котором работает сервер Bloomberg, является номером порта по умолчанию.

  • Значение тайм-аута составляет 10 миллисекунд.

uuid = 12345678;
ipaddress = '111.11.11.111';
port = [];
timeout = 10;

c = bloombergServer(uuid,ipaddress,port,timeout)
c = 

  bloombergServer with properties:

                Uuid: 12345678
                User: []
              Userip: '111.11.11.112'
             Session: [1×1 BLPSession]
           IPAddress: '111.11.11.111'
                Port: 8194
             TimeOut: 10
        DatetimeType: ''
    DataReturnFormat: ''

bloombergServer функция соединяется с машиной, на которой работает Bloomberg Server, используя номер порта по умолчанию 8194 и значение тайм-аута 10 миллисекунд. bloombergServer функция создает bloombergServer c объекта со следующими свойствами:

  • Пользователь Bloomberg тождеств UUID

  • Тождества пользователя Bloomberg

  • IP-адрес машины, работающей под MATLAB

  • Объект Bloomberg V3 API Session

  • IP-адрес компьютера, на котором работает Bloomberg Server

  • Номер порта машины, на которой работает сервер Bloomberg

  • Число в миллисекундах, указывающее, как долго MATLAB пытается подключиться к машине, работающей на сервере Bloomberg Server, перед истечением времени ожидания

  • Тип данных даты и времени

  • Формат возврата данных

Запросить последнюю и открытую цену для 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 возвращает структуру d с последней и открытой ценой. Также, getdata возвращает значение безопасности в sec.

Закройте подключение к Bloomberg Server.

close(c)
Введенный в R2021a