Котировки акций

Для каких сайтов

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

Что добавляет в результаты поиска

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

Пример отображения (дизайн может меняться):

Как настроить

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

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

Передача данных в Яндекс

Подготовьте файл и передайте ссылку на него в Яндекс через форму внизу страницы.

Чтобы ваш файл был обработан корректно, он должен соответствовать требованиям:

  • Файл должен соответствовать формату JSON.
  • Файл должен быть доступен по протоколу HTTPS на домене брокера. Пример ссылки на файл: https://yoursite.ru/feed.json.
  • Если для доступа к файлу используется авторизация, укажите логин и пароль при передаче ссылки на файл.

Формат данных

Файл должен содержать название сервиса, ссылку на главную страницу и описание контента. Количество единиц контента в одном файле не ограничено.

{
  "serviceName": "Брокер N",
  "url": "https://yoursite.ru",
  "logo_url": "https://yoursite.ru/logo",
  "items": [{
    ...
    объекты, описывающие ценные бумаги
    ...
  }]
}
Описание параметров

Ключ

Значение

Тип данных

Обязательный при создании

serviceName

Название сервиса на русском или английском языке. Это имя будет отображаться в дополненном представлении в Поиске.

Строка

Да

url

Ссылка на главную страницу сайта.

Строка

Да

logo_url

Логотип компании.

Строка

Да

items

Массив данных о ценных бумагах.

Массив JSON-объектов

Да

Данные (items)

{
    "ticker": "YNDX",
    "isin": "NL0009805522",
    "display_name": "Яндекс",
    "logo_url": "//...url",
    "url": "//...url",
    "currency_code": "RUB",
    "exchange": "MOEX",
    "type": "STOCK",
    "price": "5901.92",
    "price_delta_relative": "-15",
    "price_delta_absolute": "-0.25301",
    "update_ts": "1637068580",
    "candles": {
      "allTime": [{"ts": "", "value": ""}, ....],
      "year": [{"ts": "", "value": ""}, ....],
      "month": [{"ts": "", "value": ""}, ....],
      "week": [{"ts": "", "value": ""}, ....],
      "day": [{"ts": "", "value": ""}, ....],
      },
    "about": [
      {
        "author": "MyAuthorName",
        "avatar_url": "//...url",
        "post_url": "//...url",
        "timestamp": 1636097657,
        "text": "информация об акциях $YNDX ..."
       },
       ...
    ]
}

Ключ

Значение

Тип данных

Обязательный при создании

ticker

Тикер ценной бумаги

Строка

Да

isin

Международный идентификатор ценной бумаги (International Securities Identification Number)

Строка

Да

display_name

Отображаемое имя эмитента

Строка

Да

logo_url

Ссылка на картинку

Строка

Да

url

Ссылка на бумагу на сервисе

Строка

Да

currency_code

В какой валюте торгуется бумага (USD, RUB, ...)

Строка

Да

exchange

Биржа (MOEX, SPBEX, ...)

Строка

Да

type

Тип ценной бумаги (сейчас поддерживаются только акции — STOCK)

Строка

Да

price_delta_relative

Изменение цены относительное (относительно прошлого дня)

Строка

Да

price_delta_absolute

Изменение цены абсолютное (относительно прошлого дня)

Строка

Да

update_ts

Время, в которое зафиксирована цена

Строка

Да

candles

Данные о свечах

JSON-объект

Да

candles.allTime

Дневные свечи за все время

Массив JSON-объектов — candle

Да

candles.year

Дневные свечи за последний год

Массив JSON-объектов — candle

Да

candles.month

Дневные свечи за последний месяц

Массив JSON-объектов — candle

Да

candles.week

Часовые свечи за последнюю неделю

Массив JSON-объектов — candle

Да

candles.day

5-минутные свечи за последний день

Массив JSON-объектов — candle

Да

about

Новости про данную ценную бумагу

Массив JSON-объектов — related_info

Нет

Свеча (candle)

{
  "ts": "1636097657", 
  "value": "123.45"
}

Ключ

Значение

Тип данных

Обязательный при создании

ts

Timestamp свечи

Строка

Да

value

Цена

Строка

Да

Связанная информация (related_info)

{
  "author": "MyAuthorName",
  "avatar_url": "//...url",
  "post_url": "//...url",
  "timestamp": 1636097657,
  "text": "информация об акциях $YNDX ..."
}

Ключ

Значение

Тип данных

Обязательный при создании

author

Имя автора

Строка

Да

avatar_url

Ссылка на картинку

Строка

Нет

post_url

Ссылка на пост

Строка

Да

timestamp

Timestamp поста (в секундах)

Целое число

Да

text

Содержимое поста (не более 200 символов)

Строка

Да

Условия

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

Требования к сервису партнера

  • Сервис действует на территории Российской Федерации.
  • Сервис действует в соответствии с законодательством Российской Федерации, в том числе законодательством о рынке ценных бумаг. На сервисе не предлагается совершение сделок, не соответствующих действующему законодательству.
  • На сервисе можно приобретать ценные бумаги только через профессионального участника рынка ценных бумаг, который имеет лицензию на брокерское и депозитарное обслуживание, действующую на территории Российской Федерации.
  • Обмен информацией между клиентом и профессиональным участником рынка ценных бумаг, выполняющим распоряжение клиента на совершение сделки, осуществляется непосредственно на сервисе, без переадресации на другие сервисы (в т. ч. по технологии iframe).
  • Партнер должен являться правообладателем информации, передаваемой в рамках интеграции Яндексу, либо обладать необходимыми полномочиями для использования указанной информации Яндексом.

Чтобы стать партнером, отправьте заявку и подготовленный файл через форму ниже.

Оставить заявку

Дата обновления страницы: 08.02.2022.

Предыдущие версии документа

История изменений
  • Обновлен пример отображения ответа.
  • Добавлено упоминание о примере отображения ответа в разделе «Что добавляет в результаты поиска».
Подписаться на обновления

Значение

Название сервиса на русском или английском языке. Это имя будет отображаться в объектном ответе в Поиске.

Тип данных

Строка

Обязательный при создании

Да

Значение

Ссылка на бумагу на сервисе

Тип данных

Строка

Обязательный при создании

Да

Значение

Логотип компании.

Тип данных

Строка

Обязательный при создании

Да

Значение

Массив данных о ценных бумагах.

Тип данных

Массив JSON-объектов

Обязательный при создании

Да

Значение

Тикер ценной бумаги

Тип данных

Строка

Обязательный при создании

Да

Значение

Международный идентификатор ценной бумаги (International Securities Identification Number)

Тип данных

Строка

Обязательный при создании

Да

Значение

Отображаемое имя эмитента

Тип данных

Строка

Обязательный при создании

Да

Элемент

URL-адрес предложения. Должен быть уникальным среди всех предложений в пределах всех фидов одного и того же региона. Метки (например, UTM, Openstat, from) не делают URL уникальным.

Значение

В какой валюте торгуется бумага (USD, RUB, ...)

Тип данных

Строка

Обязательный при создании

Да

Значение

Биржа (MOEX, SPBEX, ...)

Тип данных

Строка

Обязательный при создании

Да

Значение

Тип ценной бумаги (сейчас поддерживаются только акции — STOCK)

Тип данных

Строка

Обязательный при создании

Да

Значение

Цена покупки, аренды или стоимость подписки за один месяц. Для сериалов — общая сумма покупки доступных сезонов (из поля availableSeasons) по данной модели монетизации.

Примечание

Цена должна строго соответствовать модели монетизации. Указывайте цену без учета акций и специальных предложений для отдельных групп пользователей. Не рассчитывайте цену как часть от стоимости покупки подписки за более длительный период.

Значение

Изменение цены относительное (относительно прошлого дня)

Тип данных

Строка

Обязательный при создании

Да

Значение

Изменение цены абсолютное (относительно прошлого дня)

Тип данных

Строка

Обязательный при создании

Да

Значение

Время, в которое зафиксирована цена

Тип данных

Строка

Обязательный при создании

Да

Значение

Данные о свечах

Тип данных

JSON-объект

Обязательный при создании

Да

Значение

Дневные свечи за все время

Тип данных

Массив JSON-объектов — candle

Обязательный при создании

Да

Значение

Дневные свечи за последний год

Тип данных

Массив JSON-объектов — candle

Обязательный при создании

Да

Значение

Дневные свечи за последний месяц

Тип данных

Массив JSON-объектов — candle

Обязательный при создании

Да

Значение

Часовые свечи за последнюю неделю

Тип данных

Массив JSON-объектов — candle

Обязательный при создании

Да

Значение

5-минутные свечи за последний день

Тип данных

Массив JSON-объектов — candle

Обязательный при создании

Да

Значение

Новости про данную ценную бумагу

Тип данных

Массив JSON-объектов — related_info

Обязательный при создании

Нет

Значение

Timestamp свечи

Тип данных

Строка

Обязательный при создании

Да

Значение

Цена

Тип данных

Строка

Обязательный при создании

Да

Значение

Имя автора

Тип данных

Строка

Обязательный при создании

Да

Значение

Ссылка на картинку

Тип данных

Строка

Обязательный при создании

Нет

Значение

Ссылка на пост

Тип данных

Строка

Обязательный при создании

Да

Значение

Timestamp поста (в секундах)

Тип данных

Целое число

Обязательный при создании

Да

Значение

Содержимое поста (не более 200 символов)

Тип данных

Строка

Обязательный при создании

Да

Предыдущая
Следующая